Skip to content
← All assistants

Connect Cursor to your rank tracker with one config block

TheSerpAgent is the rank tracker your AI runs. One block in Cursor's config connects it. Cursor can then set up tracking, read what moved and make the client report. Positions are stored with date and ranking page.

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

You need a TheSerpAgent account on a plan or a running trial. Only the account owner can create a key.

  1. Create a key

    In the app, open AI assistants, name a key and create it. Copy it now: it is shown once. You can revoke it there at any time.

  2. Add the config block

    Create or edit ~/.cursor/mcp.json to have it in every project, or .cursor/mcp.json in one project. Put your key in place of YOUR_API_KEY.

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

    If the file already lists other servers, add the theserpagent entry beside them. If the project is shared, use the file in your home folder, so your key stays out of the repository.

  3. Ask Cursor

    Ask it to list your projects. By default Cursor asks for your approval before it uses an MCP tool, so you see each call and its arguments as it comes. Its Run Mode setting can change that.

If it does not connect

Messages you can meet and what to do
What you seeWhat to do
The server shows an error or no toolsOpen the Output panel, choose MCP Logs and read the message there. A 401 means the key is wrong or revoked: create a new key and put it in the file.
A tool answers: Start your free trial to begin tracking. Choose a plan and add a card: nothing is charged for 14 days and you can cancel any time.Tools that set up tracking, add a competitor or a channel, schedule a report, write a summary or spend checks need a plan or a running trial. Choose a plan in the app.
A tool answers that the plan's limit is reachedYour AI sees the same limits as you. Ask it to run get_usage, or change plan in the app.

Things to ask

  • Which of my keywords dropped this week?
  • What changed around "trail running shoes" since yesterday?
  • 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.
  • Make the client report for the last 30 days.

Cursor can also reach competitors, AI Overview, Slack and webhook alerts, report branding and schedules, and summaries. Billing, login and API keys stay in the dashboard. What your AI reaches

How these steps were checked

The file locations, the format and the MCP Logs panel follow Cursor's own documentation. The server answered the same requests from Claude Code. These steps have not been run in the Cursor app for this page.

Stop checking rankings one by one

Add your site and keywords, and we start checking them right away.

Start free trial

14 days free with a card on file. Nothing is charged until they end.