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.
-
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.
-
Add the config block
Create or edit
~/.cursor/mcp.jsonto have it in every project, or.cursor/mcp.jsonin one project. Put your key in place ofYOUR_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
theserpagententry beside them. If the project is shared, use the file in your home folder, so your key stays out of the repository. -
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
| What you see | What to do |
|---|---|
| The server shows an error or no tools | Open 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 reached | Your 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.