Get started - MCP

Copy as Markdown

Use agent-data’s remote MCP server to give AI agents access to real-time, structured data. Agents use it to discover endpoints, inspect docs, and call routes from Claude, Cursor, ChatGPT, or any other MCP client.

Installation

The server URL is the same for every client:

https://agent-data.motie.dev/mcp

To authenticate, sign in to your agent-data account through the browser window that opens.

The sections below cover the most common clients. Any other MCP client can connect by pointing it at the server URL above.

Claude Code

1. Add agent-data as a remote MCP server:

   claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

   Add --scope user to make it available in every project, not just the current one.

2. Inside Claude Code, run /mcp, choose agent-data, select Authenticate, and complete the sign-in that opens in your browser.

The agent-data tools are available in your next session.

Troubleshooting: If agent-data shows as failed or disconnected, run /mcp again and re-authenticate.

Claude

Works on claude.ai and in the Claude desktop app. Custom connectors require a paid Claude plan (Pro, Max, Team, or Enterprise).

1. In Claude, open Settings → Connectors and click Add custom connector.

2. Paste the server URL, name it “agent-data,” and click Add:

   https://agent-data.motie.dev/mcp

3. Click Connect, sign in with your agent-data account, and approve access.

4. Start a new chat and turn on the agent-data connector.

To stop Claude from asking before each tool call, set the connector’s Needs approval setting to Always allow.

ChatGPT

Custom apps require a paid ChatGPT plan (Plus, Pro, or Business) and developer mode: Settings → Apps → Advanced → Developer mode.

1. In ChatGPT, open Settings → Apps and choose Create.

2. Fill in the details and click Create:

   • Name: agent-data
   • Description: Live data for agents — flights, restaurants, jobs, AI news, and social feeds.
   • MCP Server URL: https://agent-data.motie.dev/mcp
   • Authentication: OAuth

3. Complete the sign-in: log in with your agent-data account and approve access.

4. Start a new chat, open the + menu, and turn on the agent-data app.

Cursor

Remote MCP servers with OAuth need Cursor 1.0 or later.

1. Open Cursor Settings → MCP and click New MCP Server. This opens ~/.cursor/mcp.json.

2. Add agent-data and save:

   {
     "mcpServers": {
       "agent-data": {
         "url": "https://agent-data.motie.dev/mcp"
       }
     }
   }

3. Back in the MCP settings, agent-data appears with a login prompt. Click it, sign in with your agent-data account, and approve access.

Troubleshooting: If the tools don’t show up, toggle the server off and on in the MCP settings, or restart Cursor.

VS Code

Requires VS Code 1.102 or later with GitHub Copilot.

1. Run this in a terminal:

   code --add-mcp '{"name":"agent-data","type":"http","url":"https://agent-data.motie.dev/mcp"}'

   Or add it from the editor: open the Command Palette, run MCP: Add Server, choose HTTP, and paste https://agent-data.motie.dev/mcp.

2. When VS Code asks to authenticate, allow it and complete the sign-in with your agent-data account in the browser.

3. Open Copilot Chat in agent mode — the agent-data tools are available under the tools picker.

To share the server with your team, commit it to your repo in .vscode/mcp.json:

{
  "servers": {
    "agent-data": {
      "type": "http",
      "url": "https://agent-data.motie.dev/mcp"
    }
  }
}

Windsurf

1. Open Windsurf Settings → Cascade → MCP servers and choose Add custom server. This opens ~/.codeium/windsurf/mcp_config.json.

2. Add agent-data and save:

   {
     "mcpServers": {
       "agent-data": {
         "serverUrl": "https://agent-data.motie.dev/mcp"
       }
     }
   }

3. Refresh the server list, then complete the sign-in with your agent-data account when prompted.

Codex CLI

1. Add agent-data as a remote MCP server:

   codex mcp add agent-data --url https://agent-data.motie.dev/mcp

2. Sign in with your agent-data account:

   codex mcp login agent-data

The tools are available the next time you start codex.

Prefer editing config directly? Add this to ~/.codex/config.toml:

[mcp_servers.agent-data]
url = "https://agent-data.motie.dev/mcp"

Troubleshooting: If the server shows as disconnected, run codex mcp list to check its status, then codex mcp login agent-data to re-authenticate.

Gemini CLI

1. Add agent-data as a remote MCP server:

   gemini mcp add --transport http agent-data https://agent-data.motie.dev/mcp

2. Inside Gemini CLI, run /mcp auth agent-data and complete the sign-in that opens in your browser.

3. Run /mcp to confirm the agent-data tools are listed.

Available tools

The MCP server exposes the same primitives as the CLI:

Tool	Description
search	Search the endpoint catalog by keyword (e.g. “restaurant reservations”).
list	Browse every available endpoint.
docs	Inspect an endpoint’s routes, parameters, and response schemas.
call	Invoke a route and return live data.
whoami	Show the connected account and remaining credits.