Connect your AI assistant

The SERP Agent works with AI assistants that support MCP. Create an API key in the app, add the server to your assistant, and ask about your rankings in plain words.

Server address: https://api.theserpagent.ai/api/mcp

Claude Code

One command adds the server.

In the app, open AI assistants and create a key. Copy it: it is shown once.
Run the command below in your terminal, with your key.
Ask Claude something about your rankings.

Terminal

claude mcp add --transport http the-serp-agent https://api.theserpagent.ai/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Add the server to your Cursor MCP settings.

Create a key in the app under AI assistants.
Open Cursor Settings, then MCP, then add a new server, or edit ~/.cursor/mcp.json.
Paste the configuration below with your key and save.

~/.cursor/mcp.json

{
    "mcpServers": {
        "the-serp-agent": {
            "url": "https://api.theserpagent.ai/api/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_API_KEY"
            }
        }
    }
}

Claude Desktop

Claude Desktop connects to keyed servers through the small mcp-remote helper (Node.js required).

Create a key in the app under AI assistants.
Open Claude Desktop, Settings, Developer, Edit config.
Add the server below, replacing YOUR_API_KEY, then restart Claude Desktop.

claude_desktop_config.json

{
    "mcpServers": {
        "the-serp-agent": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://api.theserpagent.ai/api/mcp",
                "--header",
                "Authorization:${SERP_AGENT_KEY}"
            ],
            "env": {
                "SERP_AGENT_KEY": "Bearer YOUR_API_KEY"
            }
        }
    }
}

Claude (claude.ai and the desktop app)

No key to copy: you sign in and approve.

Open Settings, then Connectors, then Add custom connector.
Paste the server address above and add it.
Claude opens The SERP Agent in your browser: sign in as the workspace owner and press Approve.

ChatGPT

ChatGPT connects with a sign-in, like Claude above.

Open Settings, then Connectors (turn on developer mode if asked), then add a custom connector.
Paste the server address above and choose sign-in (OAuth) when asked.
Sign in to The SERP Agent as the workspace owner and press Approve.

Things to ask

Which of my keywords moved up this week?
Add these 20 keywords to my store project and put them in a list called Spring.
Refresh my money keywords and tell me how many checks I have left.
Why did "best crm software" move, and who took its place?
Make me a PDF report for my store project that I can send to my client.

What your assistant can do

See your rankings

list_projects, get_rankings, get_keyword_history, get_changes, get_usage, search_locations

Explain and report

explain_change, generate_report

Set up tracking

create_project, add_keywords, refresh_keywords, create_alert

Organise keywords

list_tags, create_tag, rename_tag, tag_keywords, untag_keywords

Remove (asks for exact ids)

remove_keywords, delete_tag

It uses the same limits as your plan: keywords, projects and refresh checks. Keys can be revoked any time in the app.

Start your free trial to create your first key.