MCP (AI Integration)

The Model Context Protocol (MCP) lets AI assistants like Cursor and Claude interact with external tools and data. MockAPI's MCP integration exposes your projects, models, and endpoints so you can:

• List your projects: See all MockAPI projects with IDs
• Create projects: "Create a project called E-commerce API"
• Add models: "Add a User model with id, name, email"
• Create endpoints: "Create REST endpoints for the User model"
• Import schemas: Import OpenAPI or Postman collections

Agents connect by signing in with your MockAPI account (OAuth). You give your agent the server URL, the agent opens MockAPI in your browser, and you allow access. There is no key to create, copy or store.

https://mcp.mockapi.com/api/mcp

1. 1

   Add the server URL to your agent

   Each agent keeps it in a different place. The sections below show where.
2. 2

   Sign in to MockAPI

   Your agent opens MockAPI in the browser. Sign in with Google, GitHub or email if you aren't signed in already.
3. 3

   Allow access

   MockAPI shows which app is asking, what it will be able to do and where you go back to. Check the details and choose Allow Access.
4. 4

   Start asking

   Back in your agent, try "List my MockAPI projects" or "Create a MockAPI project called Todo API".

Claude connects through a custom connector, in Claude on the web and in Claude Desktop.

1. 1

   Add a custom connector

   In Claude, open Customize → Connectors, choose + Add, then Add custom connector.
2. 2

   Enter the server URL

   Name it MockAPI, paste https://mcp.mockapi.com/api/mcp and choose Continue. Keep the sign-in settings Claude detects and add the connector.
3. 3

   Allow access on MockAPI

   Claude opens MockAPI, right away or when you choose Connect next to the connector. Sign in if asked and choose Allow Access.
4. 4

   Turn it on in a chat

   In a chat, open + → Connectors and switch MockAPI on. Then try "List my MockAPI projects".

If signing in doesn't work, the Connect your AI agent page can build a personal connector URL that carries an API key instead.

ChatGPT connects to MockAPI as a custom MCP server and signs in with OAuth.

1. 1

   Add a custom MCP server

   In ChatGPT, open Plugins, select +, then Add custom MCP server. In older versions, turn on developer mode in Settings and create a connector there instead.
2. 2

   Enter the server URL

   Name it MockAPI, enter https://mcp.mockapi.com/api/mcp as the URL and choose OAuth for authentication.
3. 3

   Allow access on MockAPI

   ChatGPT opens MockAPI. Sign in if asked and choose Allow Access. In a new chat, type @ and pick MockAPI to use it.

Cursor signs in with MockAPI, so your config holds no key.

1. 1

   Add MockAPI

   On the Connect your AI agent page, choose Cursor, then Add to Cursor, and confirm in Cursor. Or add the server to ~/.cursor/mcp.json yourself:

   ~/.cursor/mcp.jsonCopy

   {
     "mcpServers": {
       "mockapi": {
         "url": "https://mcp.mockapi.com/api/mcp"
       }
     }
   }

2. 2

   Sign in

   When Cursor asks you to sign in, or shows Connect next to MockAPI in its MCP settings, choose it and allow access on MockAPI.
3. 3

   Use it

   In Composer or Chat, try "List my MockAPI projects" or "Create a MockAPI project called Todo API".

If signing in doesn't work in your Cursor version, connect with an API key instead.

Run this once in your terminal. It adds MockAPI for every project:

claude mcp add --transport http -s user mockapi https://mcp.mockapi.com/api/mcp

Then start Claude Code, run /mcp, choose mockapi and select Authenticate. Your browser opens MockAPI, where you choose Allow Access.

The command on the Connect your AI agent page includes a connection key instead, so Claude Code connects without signing in.

For VS Code agent mode, add MockAPI to .vscode/mcp.json in your project:

{
  "servers": {
    "mockapi": {
      "type": "http",
      "url": "https://mcp.mockapi.com/api/mcp"
    }
  }
}

Start the server from that file or from the MCP servers list. When VS Code asks whether MockAPI may sign in, allow it, then choose Allow Access on MockAPI.

Add to VS Code on the Connect your AI agent page installs MockAPI with a connection key instead, so VS Code connects without signing in.

Windsurf, Zed and other clients that support remote MCP servers with OAuth need only the server URL. Add it the way your client expects, for example:

{
  "mcpServers": {
    "mockapi": {
      "url": "https://mcp.mockapi.com/api/mcp"
    }
  }
}

If your client can't sign in, connect with an API key.

Use an MCP API key when a client can't sign in, for scripts and CI, or when signing in fails. A key works until you revoke it. The Connect your AI agent page also creates one for you when you pick a setup that needs it.

{
  "mcpServers": {
    "mockapi": {
      "url": "https://mcp.mockapi.com/api/mcp",
      "headers": {
        "Authorization": "Bearer mockapi_mcp_YOUR_API_KEY_HERE"
      }
    }
  }
}

claude mcp add --transport http -s user mockapi https://mcp.mockapi.com/api/mcp --header "Authorization: Bearer mockapi_mcp_YOUR_API_KEY_HERE"

https://mcp.mockapi.com/api/mcp?key=mockapi_mcp_YOUR_API_KEY_HERE

Example prompts and actions:

Apps you connected by signing in are listed under Connected Apps on the Connect your AI agent page, with their access and when each was last used. For API keys, Settings → API Keys shows when each key was last used.

To end an app's access, choose Disconnect next to it under Connected Apps on the Connect your AI agent page. To revoke an API key, open Settings → API Keys. Either way, access stops immediately.

Keep access to your account under control:

• Sign in rather than use an API key where your agent supports it. There is no secret to store, and you can disconnect each app on its own.
• Only allow access to an app you started connecting yourself. MockAPI warns you when it doesn't recognize where an app sends you back.
• Disconnect apps and revoke keys you no longer use.
• Never commit API keys or personal connector URLs to git or share them publicly.
• Use a separate key per tool, so revoking one doesn't break the others.