> ## Documentation Index
> Fetch the complete documentation index at: https://docs.prelude.so/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect your AI agent to your Prelude data

The Prelude MCP server lets AI agents such as Claude, ChatGPT, Cursor, or VS Code read your Prelude data and answer questions about it in plain language. MCP, the Model Context Protocol, is an open standard that lets AI agents use external tools.

The MCP server is read-only: an agent can look things up, but it cannot change anything in your account. It currently covers Verify phone verifications. Support for other Prelude products is coming.

<Note>
  To enable the MCP server on your app, [contact us](mailto:support@prelude.so). Access is enabled per app.
</Note>

## What you can ask

Once your agent is connected, ask it things like:

* "How did my verification conversion rate evolve over the last 30 days?"
* "Which countries had the lowest conversion rate last week, and what did they cost me?"
* "Find the verification for +33 6 12 34 56 78 from yesterday and tell me why it failed."
* "How many verifications were blocked as fraud this week compared to last week?"
* "What would switching Brazil to the cost strategy change for me?"
* "Which templates do I have on my app and what does the default one look like?"

## Connect your agent

You need a [Dashboard](https://app.prelude.so) account with access to the app, and an AI agent that supports remote MCP servers. The MCP server URL is `https://mcp.prelude.dev/v1/mcp`.

<Steps>
  <Step title="Add the server to your agent">
    <Tabs>
      <Tab title="Claude">
        In Claude (web or desktop), open **Settings**, then **Connectors**. Click **Add custom connector**, name it `Prelude`, and paste `https://mcp.prelude.dev/v1/mcp` as the server URL. Click **Add**, then **Connect** and sign in.

        <Frame caption="The consent screen shown after signing in">
          <img src="https://mintcdn.com/ding/pw_4rWxYMACZR_hm/images/mcp-consent-screenshot.png?fit=max&auto=format&n=pw_4rWxYMACZR_hm&q=85&s=083d1c1a6ba240a749b2a110adc940a1" alt="Consent screen asking to allow Claude to connect to your Prelude workspace" width="3024" height="1652" data-path="images/mcp-consent-screenshot.png" />
        </Frame>
      </Tab>

      <Tab title="Claude Code CLI">
        In a terminal, run:

        ```bash theme={null}
        claude mcp add --transport http prelude https://mcp.prelude.dev/v1/mcp
        ```

        Then type `/mcp` and pick Prelude to sign in.

        <Frame caption="The consent screen shown after signing in">
          <img src="https://mintcdn.com/ding/pw_4rWxYMACZR_hm/images/mcp-consent-screenshot.png?fit=max&auto=format&n=pw_4rWxYMACZR_hm&q=85&s=083d1c1a6ba240a749b2a110adc940a1" alt="Consent screen asking to allow Claude Code to connect to your Prelude workspace" width="3024" height="1652" data-path="images/mcp-consent-screenshot.png" />
        </Frame>
      </Tab>

      <Tab title="Cursor">
        Add this to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):

        ```json theme={null}
        {
          "mcpServers": {
            "prelude": {
              "url": "https://mcp.prelude.dev/v1/mcp"
            }
          }
        }
        ```

        Then open **Settings**, **MCP**, and click **Connect** next to Prelude.
      </Tab>

      <Tab title="ChatGPT">
        Open **Settings**, then **Connectors**. Click **Create**, name it `Prelude`, paste `https://mcp.prelude.dev/v1/mcp` as the server URL, and choose OAuth as the authentication method. Click **Create**, then connect and sign in. Custom connectors require developer mode to be enabled in ChatGPT settings.
      </Tab>

      <Tab title="VS Code">
        Add this to `.vscode/mcp.json`:

        ```json theme={null}
        {
          "servers": {
            "prelude": {
              "type": "http",
              "url": "https://mcp.prelude.dev/v1/mcp"
            }
          }
        }
        ```

        Then click **Start** above the server entry and sign in when prompted.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Sign in and allow access">
    Your browser opens to the Dashboard sign-in page. Once you sign in, a consent screen asks you to allow the agent to connect to your Prelude workspace. Click **Allow access**.
  </Step>

  <Step title="Start asking questions">
    The agent first lists the apps you have access to, then uses the app you name. Ask it a question about your Prelude data to try it out.
  </Step>
</Steps>

## Rate limits

The MCP server limits how many requests your account can make, across all tools:

| Window     | Limit |
| ---------- | ----- |
| Per second | 10    |
| Per minute | 300   |
| Per hour   | 3,000 |

Going over a limit returns an error asking you to wait before retrying. Most agents retry on their own.

## Disconnect

Remove Prelude from your agent's MCP settings.

## Troubleshooting

<AccordionGroup>
  <Accordion title="MCP is not enabled for this app" icon="question-circle">
    `MCP is not enabled for this app`: the MCP server is not enabled on that app yet. [Contact us](mailto:support@prelude.so) to enable it.
  </Accordion>

  <Accordion title="Access denied to an app" icon="question-circle">
    `access denied to app <id>`: your Dashboard account does not have access to that app. Ask an Owner of the app to invite you from the Dashboard.
  </Accordion>

  <Accordion title="Rate limit exceeded" icon="question-circle">
    `rate limit exceeded`: wait a moment and ask again.
  </Accordion>

  <Accordion title="Sign-in window does not appear or keeps reopening" icon="question-circle">
    Make sure you can sign in at [app.prelude.so](https://app.prelude.so), then remove and re-add the server in your agent.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Verify" href="/verify/v2/documentation/introduction" icon="fingerprint">
    Learn about Prelude's phone and email verification API.
  </Card>

  <Card title="MCP Login" href="/auth/documentation/integration-guide/mcp" icon="plug">
    Build your own MCP server that signs users in with Prelude Auth.
  </Card>
</CardGroup>