# Reckon MCP server

Connect Reckon to Claude, ChatGPT, Cursor or whatever you already work in. It reads your Meta and Google performance, what each ad actually says, and Reckon's call on every one of them, judged against the other ads selling the same product. It never changes an ad account.

- Server URL: `https://usereckon.ai/connect/mcp`
- Transport: remote MCP over streamable HTTP
- Auth: OAuth with standard discovery metadata. There is no API key; the person signs in to Reckon and picks the workspace to share.
- This page: https://usereckon.ai/mcp.md (human version: https://usereckon.ai/mcp)

## Setup prompt

Paste this into an AI assistant. One that can run commands or edit config connects itself; one that cannot (Claude or ChatGPT in the app) explains the clicks.

```
Connect yourself to Reckon, my ad analytics tool, as an MCP server.

Server URL: https://usereckon.ai/connect/mcp
It is a remote MCP server over streamable HTTP. Sign in is OAuth, so there is no API key or token to ask me for.
Full setup guide for every client: https://usereckon.ai/mcp.md

If you can run commands or edit config files, set it up yourself:
- Claude Code: run `claude mcp add --transport http reckon https://usereckon.ai/connect/mcp`, then tell me to run /mcp and pick Reckon to sign in.
- Cursor: add this to ~/.cursor/mcp.json, then tell me to sign in from Cursor's MCP settings:
{
  "mcpServers": {
    "reckon": { "url": "https://usereckon.ai/connect/mcp" }
  }
}
- VS Code: add this to .vscode/mcp.json, then start the server and I will sign in:
{
  "servers": {
    "reckon": { "type": "http", "url": "https://usereckon.ai/connect/mcp" }
  }
}
- Gemini CLI: run `gemini mcp add --transport http reckon https://usereckon.ai/connect/mcp`, then tell me to run /mcp auth reckon.
- Any other client: add the URL above as a remote MCP server over streamable HTTP. It publishes standard OAuth metadata, so the client finds the sign in by itself.

If you cannot add a connector from here (Claude or ChatGPT in the app or on the web), give me the exact clicks for the app I am using:
- Claude: Open Customize, then Connectors, press the plus and choose Add custom connector. Paste the Reckon URL and add it. Press Connect, sign in with your Reckon account and pick the workspace to share.
- ChatGPT: Open Settings, then Apps, then Advanced settings, and turn on Developer mode. Some accounts still show it under Security and login. Under Apps, choose Create and paste the Reckon URL. Choose OAuth, then Scan Tools, and sign in with your Reckon account when it asks. Pick the workspace to share. Once the tools load, choose Create. Then open a new chat, select Reckon, and ask it something.

When I sign in, Reckon asks which workspace to share. Once you are connected, answer this:
Which ad accounts can you read through Reckon, how current is each one, and how much of our creative has Reckon analysed so far?
```

## Steps

1. **Add the Reckon URL.** Paste it into your assistant's connector settings, or run one command.
2. **Sign in, or sign up.** Your assistant opens Reckon. Sign in, or create an account there and then; either way you come back to where you left off. No key to copy, no secret to store.
3. **Pick the workspace.** Choose which workspace to share. That choice is what the connection can read.
4. **Ask your first question.** Connecting is not the same as having data. Check which accounts it can see, how current they are, and how much creative Reckon has read.

## Setup by client

### Claude

1. Open Customize, then Connectors, press the plus and choose Add custom connector.
2. Paste the Reckon URL and add it.
3. Press Connect, sign in with your Reckon account and pick the workspace to share.

Note: Works on every Claude plan, including Free with one connector. On Team and Enterprise an owner adds it first under Organization settings, then Connectors, and each member connects from Customize.

Vendor guide: [Claude's guide to custom connectors](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)

### Claude Code

1. Run the command below in your terminal.
2. Run /mcp, choose Reckon and complete the sign in that opens in your browser.

```
claude mcp add --transport http reckon https://usereckon.ai/connect/mcp
```

Then run /mcp inside Claude Code to finish signing in.

### ChatGPT

1. Open Settings, then Apps, then Advanced settings, and turn on Developer mode. Some accounts still show it under Security and login.
2. Under Apps, choose Create and paste the Reckon URL.
3. Choose OAuth, then Scan Tools, and sign in with your Reckon account when it asks. Pick the workspace to share.
4. Once the tools load, choose Create. Then open a new chat, select Reckon, and ask it something.

```
https://usereckon.ai/connect/mcp
```

Developer mode is available on Plus, Pro, Business, Enterprise and Edu, on the web.

Note: A paid ChatGPT plan on the web. On Business, Enterprise and Edu a workspace admin turns Developer mode on first, and only an admin or owner can publish the app to everyone else.

Vendor guide: [OpenAI's guide to developer mode and MCP apps](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)

### Cursor

1. Add Reckon to your mcp.json.
2. Open Cursor's MCP settings and sign in when it asks.

```json
{
  "mcpServers": {
    "reckon": { "url": "https://usereckon.ai/connect/mcp" }
  }
}
```

Save as .cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project.

### VS Code

1. Add Reckon to your mcp.json, or run MCP: Add Server and paste the URL.
2. Start the server and sign in when VS Code asks.

```json
{
  "servers": {
    "reckon": { "type": "http", "url": "https://usereckon.ai/connect/mcp" }
  }
}
```

Save as .vscode/mcp.json, or run MCP: Add Server from the command palette.

### Gemini CLI

1. Run the command below.
2. Run /mcp auth reckon and finish signing in.

```
gemini mcp add --transport http reckon https://usereckon.ai/connect/mcp
```

Then run /mcp auth reckon to sign in.

### Any other client

1. Add the Reckon URL as a remote MCP server over streamable HTTP.
2. Your client discovers the sign in by itself: Reckon publishes the standard OAuth metadata, so there is no key to paste and no secret to store.
3. Sign in and pick the workspace to share.

## First question to ask

Which ad accounts can you read through Reckon, how current is each one, and how much of our creative has Reckon analysed so far?

A good answer names the accounts, the newest day Reckon holds for each, and how much of the creative it has read.

## If it does not work

- **There is no workspace to pick.** Your Reckon account is not in a workspace yet. Reckon asks you to name one on the way through; if you skipped it, or your team already has one, ask an admin to invite you.
- **It connects but lists no accounts.** Nobody has connected an ad account to this workspace. An admin does that once, in Reckon.
- **The numbers look thin or old.** The first sync may still be running. Ask your assistant for the sync status, or check again after tonight's refresh.
- **Sign in is refused.** On a managed Claude or ChatGPT workspace an admin may have to allow the connector first. See the note under your assistant's tab.