Skip to main content
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, both phone and email verifications. Support for other Prelude products is coming.

​
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?”
  • “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?”
  • “Which templates do I have on my app and what does the default one look like?”
  • “Show me the email verifications for jane@example.com and what happened to the last one.”
  • “Are all the DNS records for my sending domain validated, and is DMARC set up?”

​
Enable the MCP server

The MCP server is off by default and is enabled per app. In the Dashboard, open your app, go to Configure, then MCP, turn on Enable MCP, and click Save. The page then shows the server URL and the setup steps for each agent, the same ones you find below.
Dashboard MCP page with the Enable MCP switch turned on, the server URL, and the list of agents to connect

The MCP page of an app in the Dashboard

​
Connect your agent

You need a Dashboard 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.
1

Add the server to your agent

In Claude, web or desktop:
  1. Open Customize, then Connectors.
  2. Click +, then Add custom connector.
  3. Name it Prelude and paste https://mcp.prelude.dev/v1/mcp as the server URL.
  4. Click Add, then Connect, and sign in.
Consent screen asking to allow Claude to connect to your Prelude workspace

The consent screen shown after signing in

2

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.
3

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.

​
Rate limits

The MCP server limits how many requests your account can make, across all tools: 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

MCP is not enabled for this app: the MCP server is not enabled on that app yet. Enable it in the Dashboard under Configure, then MCP, as described in Enable the MCP server. If you don’t see that page, ask a teammate who manages the app to enable it.
access denied to app <id>: your Dashboard account does not have access to that app. Ask a teammate who manages the app to invite you from its Members page.
rate limit exceeded: wait a moment and ask again.
Make sure you can sign in at app.prelude.so, then remove and re-add the server in your agent.

​
Next steps

Verify

Learn about Prelude’s phone and email verification API.

MCP Login

Build your own MCP server that signs users in with Prelude Auth.