MCP

Competitor data in your AI assistant, without opening the dashboard.

Adversee's MCP server exposes your workspace's competitor data to Model Context Protocol clients such as Claude and Cursor. You connect with a personal API key; the assistant reads, and if your role allows it makes limited edits such as assigning a campaign category or adding a social account to a competitor. The key belongs to you and your workspace and works for as long as you are on the team.

Read the docsCreate a keyhttps://adversee.com/api/mcp
SAMPLE SESSION · RESPONSE SHORTENED
you
What changed in competitors' homepage banners this week?
tool call
adversee_list_events {"tip":"banner_eklendi","baslangic":"…"}
response
{
  "hareketler": [
    { "id": "…", "tip": "banner_eklendi", "baslik": "…", "rakip": "Rakip A",
      "rakipSlug": "rakip-a", "seviye": "hamle", "zaman": "2026-10-07T10:00:12.318Z",
      "kampanyaId": null,
      "ayrinti": { "gorunum": "mobil", "slideId": "…", "gorselId": "…", "url": "https://…" } }
  ],
  …
assistant
There's one banner move this week: Rakip A added a new banner to its mobile homepage. Want me to open the image with adversee_get_image?
TOOLS ON THE SERVER · 45
  • adversee_list_competitors
  • adversee_list_campaigns
  • adversee_get_campaign
  • adversee_list_events
  • adversee_get_digest
  • adversee_list_homepage_banners
  • adversee_get_banner_history
  • adversee_list_meta_ads
  • adversee_get_image
  • adversee_get_scan_status
  • adversee_list_competitor_notifications
  • adversee_get_overtakes
  • adversee_list_taxonomy
  • adversee_set_campaign_category
  • adversee_set_campaign_group
  • adversee_set_competitor_class
  • adversee_add_social_account
  • adversee_update_social_account
  • adversee_add_meta_page
  • adversee_close_meta_page
  • adversee_undo_change
  • adversee_add_taxonomy_items
  • adversee_add_competitor
  • adversee_seo_keywords
  • adversee_seo_share_of_voice
  • adversee_seo_sira_dagilimi
  • adversee_seo_kelime_tablosu
  • adversee_seo_youtube
  • adversee_seo_store_apps
  • adversee_seo_changes
  • adversee_seo_backlinks
  • adversee_seo_ai_visibility
  • adversee_seo_ajan_hazirligi
  • adversee_seo_icerik_boslugu
  • adversee_seo_ai_kaynaklari
  • adversee_seo_llm_anilma
  • adversee_seo_kurulum_hizi
  • adversee_seo_yorum_konulari
  • adversee_seo_icgoruler
  • adversee_seo_uygulama_kelimeleri
  • adversee_seo_inapp_eventler
  • adversee_seo_kelime_arastirmasi
  • adversee_seo_teknik_sorunlar
  • adversee_seo_arama_ilgisi
  • adversee_seo_lighthouse
WHAT YOU CAN ASK

Ask; the assistant looks it up in Adversee.

  • What changed in competitors' homepage banners this week?
  • Group Competitor B's active Meta ads by game group.
  • Which campaigns ended or changed since yesterday morning?
  • How did Competitor A's mobile banner order change over the last 3 days?
  • Which competitor sites are unreachable right now, and why?
  • Where have competitors overtaken us?
HOW TO CONNECT

Three steps.

01

Create a key

In the dashboard, go to Settings (Ayarlar) > API (MCP) and name your key. It is shown only once; copy it and keep it safe.

02

Add it to your client

One command for Claude Code; ready-made config snippets for Cursor and Claude Desktop in the dashboard and in the docs.

03

Ask

The assistant picks tools based on their descriptions: competitors, campaigns, events, banner order history, Meta ads and images.

WHAT IT CAN READ

The dashboard's core data, as structured data.

Campaigns

Competitor campaigns with extracted fields (cap, wagering, rate), terms, last seen, removal detection and change history.

Events

New, changed and ended campaigns, banner and Meta events, competitors' new social media posts, outages. Full history with date ranges and pagination.

Homepage banners

Live and removed banners, desktop and mobile; banner order history scan run by scan run, up to 366 days.

Meta ads

Active and ended ads, Ad Library links and a per-brand coverage note.

Image classification

For every classified banner and ad: type, category, game group and the game name written on it; a confidence-scored campaign suggestion; the confirmation status of the campaign and game match (candidate, confirmed, rejected) and who confirmed it.

Images

Banner and ad images returned as images; in clients that support images, the assistant can see them.

Competitor notifications

Competitor push and SMS messages captured by the Notification Bridge, with each receipt time.

Scan status

Last scan run, last successful scan run and open faults per competitor and surface: how fresh the data is.

SECURITY

Your role, nothing more, every write logged.

Your role

The assistant acts with your current role: viewers can only read. Write tools never delete competitors, accounts or categories, and never change settings (replacing a social account or closing a Meta page you added stops that follow; the content stays); every write is logged with its before and after state, and most writes can be undone within 24 hours if the record has not changed since.

Bound to you

A key belongs to you and your workspace; it works for as long as you are on the team.

Revocable

Revoke keys from the dashboard in one click; the Owner and Admin roles can see and revoke the team's keys. Every call is written to an audit log, kept for 180 days.

Rate limited

60 requests per minute per key; writes are further limited to 10 per minute per key, 50 per hour per user and 100 per hour per workspace. The plain key is never stored; only its hash and its first 10 characters, for display, are kept.

MCP: connect competitor intelligence to your AI assistant · Adversee