MCP server

Ask your AI assistant about your installs and ROAS.

Roasit's MCP server lets Claude, ChatGPT, Cursor and other AI assistants read your Roasit figures: installs, revenue, ROAS, campaign performance and whether your integrations are healthy. Ask in plain words; the assistant fetches the same numbers the Reports screen shows. It is read-only unless you give it a Read and write key: then an AI agent can also set your app up - create it, save partner keys and run pulls - asking you before each change.

https://mcp.roasit.com/v1

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets an AI assistant call tools on a service you connect it to. Roasit's server offers 16 tools that read your workspace's apps and 7 that set an app up. Money is in each app's reporting currency.

Sign in with Roasit

Claude.ai, Claude Desktop, ChatGPT and VS Code open Roasit's sign-in and ask which apps to share. Nothing to copy, and you can revoke the connection at any time.

An API key

Claude Code, Cursor, Windsurf and your own scripts can send a Roasit API key instead: Authorization: Bearer roapi_.... Each key has its own expiry, its own apps and its own access: Read only, or Read and write for an agent that sets apps up.

Connect your client

Pick your assistant and follow its steps. Every client reaches the same server, https://mcp.roasit.com/v1.

Claude.ai and Claude Desktop

How do I connect Claude?
  1. In Claude (claude.ai or Claude Desktop), open Settings → Connectors.
  2. Press Add custom connector.
  3. Name it Roasit, enter https://mcp.roasit.com/v1 as the URL, and press Add.
  4. Press Connect beside Roasit.
  5. Sign in to Roasit in the window that opens.
  6. Choose the apps Claude may see: All apps I can see, or Only these apps and tick them.
  7. Press Allow. Back in Claude, Roasit shows as connected: ask your first question in a new chat.

Claude Code

How do I connect Claude Code with my Roasit sign-in?
  1. In a terminal, add the server:
    claude mcp add --transport http roasit https://mcp.roasit.com/v1
  2. Start Claude Code and type /mcp.
  3. Choose roasit, then Authenticate: your browser opens Roasit.
  4. Sign in, choose the apps and press Allow. Claude Code lists roasit as connected.
How do I connect Claude Code with an API key?
  1. Create an API key and copy it (Where do I get an API key? below).
  2. In a terminal, add the server with your key in place of roapi_...:
    claude mcp add --transport http roasit https://mcp.roasit.com/v1 --header "Authorization: Bearer roapi_..."
  3. Start Claude Code and type /mcp: roasit is listed as connected.

Cursor

How do I connect Cursor?
  1. Create an API key and copy it (Where do I get an API key? below).
  2. Open ~/.cursor/mcp.json for every project, or .cursor/mcp.json in a project's folder for that project alone (create the file if it is not there).
  3. Add Roasit, with your key in place of roapi_...:
    {
      "mcpServers": {
        "roasit": {
          "url": "https://mcp.roasit.com/v1",
          "headers": {
            "Authorization": "Bearer roapi_..."
          }
        }
      }
    }
  4. Save the file. Roasit shows in Cursor's MCP settings with its tools.

Windsurf

How do I connect Windsurf?
  1. Create an API key and copy it (Where do I get an API key? below).
  2. Open ~/.codeium/windsurf/mcp_config.json (Windsurf's MCP settings open it with View raw config).
  3. Add Roasit, with your key in place of roapi_.... Windsurf names the address serverUrl:
    {
      "mcpServers": {
        "roasit": {
          "serverUrl": "https://mcp.roasit.com/v1",
          "headers": {
            "Authorization": "Bearer roapi_..."
          }
        }
      }
    }
  4. Save the file and press Refresh in Cascade's MCP panel.

VS Code

How do I connect VS Code?
  1. In your project, create .vscode/mcp.json with:
    {
      "servers": {
        "roasit": {
          "type": "http",
          "url": "https://mcp.roasit.com/v1"
        }
      }
    }
  2. Press Start above roasit in the file.
  3. VS Code asks to sign in to Roasit: allow it, sign in, choose the apps and press Allow.
  4. Open the chat in Agent mode: the Roasit tools are in its tools list.

ChatGPT

How do I connect ChatGPT?
  1. In ChatGPT, open Settings → Apps & Connectors → Advanced settings, and turn on Developer mode.
  2. Back in Apps & Connectors, press Create.
  3. Name it Roasit, enter https://mcp.roasit.com/v1 as the MCP server URL, and choose OAuth as the authentication.
  4. Confirm that you trust the connector and press Create.
  5. Sign in to Roasit in the window that opens, choose the apps and press Allow.
  6. In a chat, turn Roasit on from the + menu's Developer mode.

API keys

Claude Code, Cursor and Windsurf, and your own scripts, use a key from your account.

Where do I get an API key?
  1. Sign in to Roasit and open Account → API keys & MCP.
  2. Under API keys, type a Key name after the client it is for (Cursor, say).
  3. Under Expires, choose 7 days, 30 days, 90 days, 1 year, Custom date or Never.
  4. Under Apps, choose All apps I can see (apps added later too), or Only these apps and tick them.
  5. Under Access, keep Read only, or choose Read and write for an agent that sets your apps up (you confirm it with your password).
  6. Press Create key and copy the key. It starts with roapi_ and is shown only this once.
Open your account →

Let an agent set up your app

With a Read and write key, an AI agent adds your app to Roasit and connects its partners for you: it creates the app, reads the setup guides, saves the keys it fetches through the dashboard's own save, and checks that each integration's mark turns green. It asks you before every change, and it can never delete an app, change members or billing, or show a saved secret.

How do I let an agent set up my app?
  1. Sign in to Roasit and open Account → API keys & MCP.
  2. Under API keys, type a Key name and choose when it expires.
  3. Under Apps, choose the app, or All apps I can see: only a key for all apps can add a new app to Roasit.
  4. Under Access, choose Read and write, press Create key, confirm with your Roasit password and copy the key.
  5. Add the MCP server to your agent with the key, as its How-to above says. In Claude Code:
    claude mcp add --transport http roasit https://mcp.roasit.com/v1 --header "Authorization: Bearer roapi_..."
  6. Tell the agent: Add my app <name> to Roasit and connect Meta, AppLovin and Adapty, with your app's name in place of <name>.
  7. The agent asks you before every change and names what it will change: answer it each time.
  8. When a partner's Connect button needs your own sign-in - Google Ads, Meta or TikTok - the agent gives you the dashboard's link: open it, press Connect and sign in there.
  9. Ask the agent for the app's status: it reads each tab's mark as the app page shows it, and the next step for any that is not green.

The tools

16 tools read; 7 more set an app up, with a Read and write key or connection. The assistant picks them; you ask the question.

Read

Every key and connection, Read only included.

ToolWhat it answers
whoamiWho is connected, the workspace, its plan and this month's attributed installs, and the key's access and apps.
list_appsYour apps: app token, name, platforms, store ids and reporting currency.
get_appEvery setting of one app; a saved secret only as set or not set.
get_app_statusEach tab's mark as the app page shows it - green, yellow or red - with its words, the next step and the guides to read.
get_reportThe Reports screen's numbers: installs, spend, revenue, ROAS and retention by day, country, network or campaign.
list_metricsThe metrics a report can show: ids, labels, kinds and what each one means.
list_networksThe ad networks a report can be filtered by.
get_dimension_valuesThe countries, campaigns, ad groups and ads an app has seen.
get_eventsThe events an app's SDK sends, their counts and their partner mappings.
get_reconciliationStore installs against the installs each network claims.
get_skaniOS SKAdNetwork figures.
get_pull_historyNightly runs, manual pulls and refills of each partner, with their errors.
list_installsAn app's recent installs, as its installs list shows them.
get_userOne user's attribution and events, with the IP address and advertising id masked.
get_setup_guideThe dashboard's How-to steps for a topic - an SDK, Meta, Google, TikTok, AppLovin, Adapty, the stores, Stripe, SKAN - with the app's own values filled in.
get_install_valuesThe app token, each platform's SDK init line and the webhook, postback and callback URLs to paste; with write access also the secrets Roasit makes for a partner.

Write

Only with a Read and write key or connection. The assistant asks you before each one.

ToolWhat it does
create_appAdds an app: name, platforms, store ids and links, reporting currency and store fee. Needs a key for all apps.
update_app_settingsChanges an app's settings that are not secrets.
set_credentialsSaves a partner's keys - Meta, AppLovin, Adapty, Google Play, App Store Connect, TikTok, the S3 export - through the dashboard's own save, so its checks and backfill run.
connect_stripeConnects Stripe with a restricted key, as the Stripe tab does.
discover_from_tokenFinds a partner's ids from a token, as the dashboard's autofill does.
run_pullPulls partner data again, for the sources and days chosen.
verify_connectionChecks Adapty, the AppLovin reward callback, the App Store id's ownership or Stripe.

Questions to ask

  • “Which campaign had the best 7-day ROAS last week?”
  • “How many installs did each network bring yesterday?”
  • “Is my SDK sending events?”
  • “Compare store installs with network claims for October.”

MCP questions

Can it change my apps?

Only with a Read and write key or connection, and only the apps you chose: then it may create apps, change their settings, save partner keys and run pulls, asking you before each change. A Read only one reads and changes nothing. None can delete an app, change members, roles or billing, or show a saved secret, and IP addresses and advertising ids are masked.

Which apps can it see?

Only the ones you allow. When you connect a client or create a key you choose All apps or a list, and it never sees more than your own account can.

How do I disconnect?

For a client that signed in with Roasit, open Account → API keys & MCP → Connected apps and press Revoke. For an API key, delete the key there. The client's next call is refused.

What are the limits?

120 tool calls a minute per key or connection, within the workspace's daily API budget: 2,000 calls a day on Free, 50,000 on paid plans. A report answers up to 500 rows per call; ask for a narrower one for more.

Does it cost extra?

No. The MCP server is in every plan, Free included.