🚀 Now listed for Claude, ChatGPT, Cursor and Claude Code — step-by-step setup for each. Connect Claude in a minute →
Model Context Protocol (MCP)

Connect Claude, ChatGPT and Cursor to Your Affise Data

Ask your Affise account a question and get the answer straight away — no CSV export, no dashboard tabs to hunt through. 25 read-only tools cover stats, offers, conversions and partners.

https://mcp.affise.com/mcp
🔑 OAuth 2.0 sign-in 🌐 Nothing to install 🛡 Read-only by design
your AI assistant
> Which offers grew fastest in DE last week?

  Reading Affise · affise_stats_compare
  18–24 Aug vs 11–17 Aug · slice: offer, country=DE

  OFFER                       REVENUE       Δ
  1180  Finance DE           $48,210    +38%
  2077  Gaming DE            $31,904    +21%
  1642  Utilities DE         $12,455     −6%

  Revenue in DE is up 24% week over week, almost all
  of it offer 1180 — three new partners started
  running it on Wednesday.

Built for the 1,000+ partner-marketing teams already running Affise

Wargaming.netRocketLabArabyAdstappxdentsuAffleadjoe
One minute · nothing to install

Connect Claude

Four fields and a sign-in. No config file, no client ID, no secret — the connection registers itself.

https://mcp.affise.com/mcp

Any Claude account on a plan with connectors — claude.ai, Claude Desktop or the mobile apps.

  1. 1

    Open connector settings

    In claude.ai, click your name in the bottom-left corner, then SettingsConnectors. Claude Desktop uses the same path.

  2. 2

    Add a custom connector

    Scroll to the end of the connector list and click Add custom connector.

  3. 3

    Paste the endpoint

    Put the URL above into Remote MCP server URL and name it Affise. Leave the advanced OAuth fields empty.

  4. 4

    Sign in to Affise

    Click Connect, sign in, approve. The window closes itself and the connector reads as connected.

Check it worked. Ask “Using Affise, run a status check.” A working connection answers with your Affise base URL and an OK status.

Full guide, with troubleshooting →
Setup guides

Pick your AI assistant

Every guide is the same shape: the exact menu path, the URL to paste, and what a working connection looks like. None takes more than two minutes.

What you can ask

Questions, not query builders

These are real asks, typed the way you would say them out loud. The server works out which slice, filter and date range each one needs.

🌅 Daily triage

  • Which offers grew fastest in DE last week compared to the week before?
  • Show me yesterday’s conversions for partner 4412 broken down by sub3.
  • Why did trafficback spike on offer 1180 on 2026-08-24?

👥 Partner management

  • Analyze partner 193 for August — where are they losing money?
  • List active affiliates from Brazil who ran traffic in the last 30 days.
  • Which partners have a decline rate above 20% this month?

🎯 Offer discovery

  • Find finance offers accepting UK mobile traffic with a payout over $40.
  • Generate a tracking link for offer 2077 and affiliate 512 with sub1=newsletter.

📈 Reporting

  • Compare this month to last month by country and tell me what changed.
  • Give me the top 10 advertisers by confirmed revenue this quarter.
Tool reference

25 tools, every one of them read-only

This is the complete surface your assistant gets. Nothing here can create, edit or delete anything in Affise — the tools are declared read-only to your client, so it can call them without asking permission every time.

📊 Stats & analytics — Aggregate performance, sliced any way your account is configured. 7
affise_stats Ask for stats in plain English — periods, breakdowns and top-N are resolved for you. Read-only Any
affise_stats_raw Precise aggregate pulls with explicit slices, fields and filters. Read-only Any
affise_stats_compare Period over period, with the range auto-aligned so month-to-date compares like for like. Read-only Any
affise_trafficback Rejected and redirected traffic broken down by reason, geo and partner. Read-only Any
affise_affiliate_analysis One-call account review for a single affiliate: KPIs, per-offer breakdown, insights. Read-only Admin
affise_retention_rate Cohort retention across follow-up events for one offer. Read-only Admin
affise_time_to_action Click-to-conversion latency distribution for one offer. Read-only Admin
🔄 Conversions — Down to the individual event, with the raw fields your tracking wrote. 2
affise_conversions_raw Per-event conversion rows with IP, geo, device, sub1–sub8 and custom fields. Read-only Any
affise_get_conversion The complete record for one conversion by ID. Read-only Admin
🎯 Offers — Find, inspect and link to offers without leaving the conversation. 5
affise_search_offers Natural-language offer search — “gaming offers for US mobile traffic”. Read-only Any
affise_smart_search Offer search that resolves categories for you and suggests near matches. Read-only Any
affise_get_offer Full detail for one offer: payouts, caps, targeting, status. Read-only Any
affise_offer_categories Every offer category configured on your account. Read-only Any
affise_offer_tracking_link Build a tracking link for an offer × affiliate, with sub1–sub8 appended. Read-only Admin
👥 Partners & advertisers — The roster on both sides of the network. 4
affise_list_partners Paginated affiliate roster with country, status and search filters. Read-only Admin
affise_get_partner The full affiliate record for one partner ID. Read-only Admin
affise_list_advertisers Paginated advertiser list, optionally with offer counts. Read-only Admin
affise_get_advertiser The full advertiser record for one advertiser ID. Read-only Admin
🤝 Partner self-service — Scoped to one affiliate’s own view — safe to hand to your partners. 6
affise_partner_profile The signed-in affiliate’s own profile, manager and permissions. Read-only Partner
affise_partner_balance The signed-in affiliate’s multi-currency balance by type. Read-only Partner
affise_partner_offers Offers the affiliate can request access to. Read-only Partner
affise_partner_live_offers Offers the affiliate is currently running. Read-only Partner
affise_partner_find_subs Discover which sub-ID values the affiliate has actually used. Read-only Partner
affise_partner_news Platform announcements visible to the affiliate. Read-only Partner
⚙️ Connection — Credentials, entered in the client and kept in your own encrypted session. 1
affise_authenticate Opens an inline form to enter or rotate your Affise credentials. Read-only Any

Admin tools need an admin API key · Partner tools work with an affiliate’s own key · Any works with either.

Hosted or self-hosted

Same tools, your choice of where they run

Use the endpoint we host, or run the open-source server on your own machine. Both expose the identical toolset.

Recommended · Hosted

🌐 Hosted endpoint

A managed, always-on HTTPS endpoint. Nothing to install and nothing to keep up to date — point your client at the URL and sign in.

  • Endpoint: https://mcp.affise.com/mcp
  • OAuth 2.0 sign-in with an encrypted per-user session
  • Or a static bearer token for CI and scripts
  • No client ID or secret to set up — the connection registers itself
  • Rate limited to 120 requests / minute per IP
Start with Claude
Self-hosted

💻 Local stdio server

Run it yourself when you would rather have nothing in the path. Data flows only between your machine and the Affise API.

  • Install from npm: @affise/mcp-server
  • Authenticate with your Affise API key via env vars
  • Node.js 18 or newer
  • Fully auditable — open-source code
Local setup guide
How it works

Three steps, about two minutes

No API integration to build. Your assistant becomes the interface.

1

Add the endpoint

Paste https://mcp.affise.com/mcp into your client’s connector settings. The setup guides show the exact menu path for each one.

2

Sign in to Affise

A browser window opens for OAuth 2.0 sign-in. Your credentials are encrypted into a session only your requests can read.

3

Ask in plain English

Your assistant picks the right tool, pulls the data and answers. Ask follow-ups the way you would ask a colleague.

25

Read-only MCP tools

5

Clients with setup guides

OAuth 2.0

Browser sign-in, no config

120/min

Rate limit per IP

Security & privacy

Read-only, scoped to your own key

The server holds no copy of your data. It forwards each request to the Affise API under your own credentials and returns the answer.

🛡

Nothing can be changed

All 25 tools are read-only and declared as such to your client. There is no code path that writes to Affise.

🔑

OAuth 2.0 with encrypted sessions

Your Affise credentials are encrypted per user. Static bearer tokens are available for automation.

👤

Your key, your scope

The server sees exactly what your API key sees. An affiliate key reaches only that affiliate’s own data.

🏠

Or keep it entirely in-house

Run the open-source server locally and no third party sits between you and the Affise API.

SOC 2 Type II platform

Affise is SOC 2 certified. The MCP server inherits that posture — it reaches your data only through scoped API access.

Exactly what this server receives, what it stores, for how long, and who else sees it is set out in the MCP data notice — written for the server, not the website.

what your client is told about each tool
{
  "name": "affise_stats_raw",
  "title": "Affise Stats (Raw)",
  "annotations": {
    "readOnlyHint":     true,
    "destructiveHint":  false,
    "idempotentHint":   true,
    "openWorldHint":    true
  }
}

# Every tool carries these hints, so your
# client knows nothing here can mutate data.
FAQ

Questions we get asked

What is the Affise MCP server?+
It is a Model Context Protocol server that gives an AI assistant read access to your Affise account. Instead of exporting a CSV and pivoting it, you ask a question in plain English and the assistant pulls the numbers from Affise itself.
Which AI assistants can connect to it?+
Anything that speaks MCP. We publish step-by-step setup for Claude, Claude Code, ChatGPT, and Cursor, plus a generic guide for Windsurf, Cline, Continue, VS Code and custom agents.
Do I need to install anything?+
No. The hosted endpoint at https://mcp.affise.com/mcp needs nothing installed — you paste the URL into your client and sign in. If you would rather run a server on your own machine, the @affise/mcp-server package on npm installs a local version you run yourself. It serves the same 24 data tools; the only one it leaves out is the credential form, because a local server reads your key from its own environment.
Can it change anything in my Affise account?+
No. All 25 tools are read-only and are declared to your client as read-only, so nothing can create, edit or delete offers, partners, payouts or conversions. The one exception writes nothing to Affise either: the authentication tool stores your credentials in your own encrypted session.
How does authentication work?+
The hosted server uses OAuth 2.0. You sign in through a browser window, and your Affise credentials are encrypted into a per-user session that only your requests can decrypt. For CI and scripts, a static bearer token is also supported. Client registration is dynamic, so there is no client ID or secret to copy.
What can it actually see?+
Exactly what your Affise API key can see, and nothing more. An admin key reaches network-wide stats, the partner and advertiser roster, and per-conversion detail. An affiliate key reaches only that affiliate’s own profile, balance, offers and sub-IDs.
Is my data used to train AI models?+
Not by Affise. The server keeps no lasting copy of your data — each request is forwarded to the Affise API, answers are cached for only a few minutes, and credentials are stored encrypted. What your AI provider does with the conversation is governed by your agreement with them; business and enterprise plans from the major providers exclude API traffic from training by default.
Can I give this to my affiliates?+
Yes. Six tools are partner-scoped: profile, balance, available offers, live offers, sub-ID discovery and news. An affiliate signing in with their own key sees only their own account.
Are there usage limits?+
The hosted endpoint allows 120 requests per minute per IP address. Affise API limits still apply on top: aggregate stats accept a range up to six months, and conversion exports up to 365 days (63 in raw export mode).
What does it cost?+
Nothing extra. The MCP server is included with your Affise account, and a local open-source version on npm is free to self-host.

Stop exporting CSVs

Connect your assistant once and ask your Affise account questions the way you would ask an analyst.

https://mcp.affise.com/mcp