# budgetSEO MCP server

> Claude, ChatGPT, and Cursor can read your budgetSEO rankings, quick wins, and competitors through MCP. Sign in once. Read tools do not spend lookup credits.

budgetSEO is an MCP server: plug it into Claude, ChatGPT, Cursor, or Claude Code and the assistant can use your live SEO data while you decide what to work on. This page is for people and for crawlers. The protocol endpoint is separate.

Machine-readable copy: https://www.budgetseo.ai/mcp.md
HTML page: https://www.budgetseo.ai/mcp
Permissions for AI crawlers: https://www.budgetseo.ai/ai.txt
Full site map for answer engines: https://www.budgetseo.ai/llms.txt
Sitemap: https://www.budgetseo.ai/sitemap.xml

## Discovery

Agents discover this server from the AI catalog at https://www.budgetseo.ai/.well-known/ai-catalog.json, then read the server card at https://www.budgetseo.ai/api/mcp/server-card. The card names the streamable HTTP endpoint https://www.budgetseo.ai/api/mcp and says a bearer token is required. This documentation page is https://www.budgetseo.ai/mcp. The same facts as Markdown are https://www.budgetseo.ai/mcp.md. SEO skills that call this server are listed at https://www.budgetseo.ai/skills.md and https://www.budgetseo.ai/.well-known/agent-skills/index.json.

Updated 2026-10-29.

## Endpoint

Add this URL in the MCP client. Transport is streamable HTTP. Stateless JSON-RPC. OAuth 2.1 sign-in with dynamic client registration, or a personal access token.

```
https://www.budgetseo.ai/api/mcp
```

20 tools. Read tools do not spend lookup credits. Free plan: 15 keywords, no credit card. 60 calls a minute per account.

## Connect

| Client | How to add it |
| --- | --- |
| Claude (web, desktop, mobile) | Settings, Connectors, Add custom connector. Name it BudgetSEO and paste the endpoint. Or open https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=BudgetSEO&connectorUrl=https%3A%2F%2Fwww.budgetseo.ai%2Fapi%2Fmcp. Leave the OAuth client ID and secret empty. Claude Free is limited to one custom connector. Claude chat does not run connectors on a schedule. |
| Claude Code | claude mcp add --transport http budgetseo https://www.budgetseo.ai/api/mcp. Scheduled routines use the connector saved in claude.ai, not only this local command. |
| ChatGPT | Settings, Apps and Connectors, Advanced settings, turn on Developer mode, then create a connector. Name it BudgetSEO, paste the endpoint, and choose OAuth. ChatGPT opens budgetSEO so you can allow it. Scheduled tasks can call the connector. A free ChatGPT account can schedule at most once a day. |
| Cursor | Settings, MCP, Add new MCP server, or open cursor://anysphere.cursor-deeplink/mcp/install?name=budgetseo&config=eyJ1cmwiOiJodHRwczovL3d3dy5idWRnZXRzZW8uYWkvYXBpL21jcCJ9. Config: {"mcpServers":{"budgetseo":{"url":"https://www.budgetseo.ai/api/mcp"}}}. Cursor does not run connectors on a schedule. |
| Scripts, n8n, and other clients | Transport is streamable HTTP (JSON-RPC). OAuth 2.1 with dynamic client registration works when the client can sign in. Otherwise create a personal access token on Connect AI and send Authorization: Bearer with that token. |

## Tools

| Tool | Access | What it returns or changes |
| --- | --- | --- |
| get_seo_briefing | Read | Start here for what to do today, what changed, or what to focus on. Returns the top actions with estimated monthly clicks, recent rank moves, plan limits, and the next automatic check. |
| find_quick_wins | Read | Low-hanging fruit and striking-distance keywords. Each result includes the estimated monthly clicks from moving up. |
| find_opportunities | Read | Best opportunities across quick wins, research ideas, competitor gaps, rank drops, and AI Overview citation gaps. Filter with kinds: quick_win, research_idea, competitor_gap, rank_drop, ai_visibility. |
| list_projects | Read | Projects, keyword counts, whether Search Console is linked, whether a project is paused by the plan, and how many keyword slots remain (no limit on Pay as you go). |
| get_rank_changes | Read | Winners and losers over a recent window. days defaults to 7. The furthest lookback is 90 days. |
| get_keyword_action_plan | Read | One tracked keyword: ranking URL, history, SERP features, competitors, and a checklist. When a page ranks, it also lists what holds that page back for the keyword, with a ready-to-paste fix prompt for each finding. It does not edit the website. Confirm before changing the page. |
| get_competitor_overview | Read | Saved competitors and how many tracked keywords each one outranks you on. Never starts a paid lookup. keywordsAhead is null until that competitor has been checked. |
| get_ai_visibility | Read | Keywords where an AI Overview shows but does not cite the site, from data already on tracked keywords. Mention counts and share of voice come from AI visibility snapshots: scheduled on Growth and Business, or an on-demand check paid from the balance on Pay as you go. |
| get_search_performance | Read | Real Google Search Console clicks, impressions, CTR, and average position for one project over the last 28 days. Does not spend lookup credits. If the project is not linked, the result says so and clicks must not be invented. |
| check_page | Read | Reads one page of a project's site the way Google and AI crawlers do, without JavaScript. Lists what holds it back (unreachable or noindex pages, content that needs JavaScript, missing title, description or headline, sitemap, AI crawler rules) and gives a ready-to-paste fix prompt for each finding. Free. url defaults to the homepage and must be on the project's domain. |
| list_fix_tasks | Read | Open SEO fixes from earlier page checks, each with the page and the exact change to make (fixPrompt). Verified fixes include the position and click change 14 and 28 days later. Free. |
| complete_fix_task | Confirm first | Call once the change for a fix task is live. Re-reads the page and marks the task verified when the finding is gone. dismiss: true drops a task. Free. |
| track_keywords | Confirm first | Add keywords to a project. Pay as you go has no keyword limit: the first 15 are checked free and the others are billed per check. Paid plans use their keyword slots. Adding keywords never spends lookup credits. countryCode defaults to the project market. Confirm the list before calling it. |
| untrack_keyword | Confirm first | Remove one tracked keyword and its history. This cannot be undone. Confirm before calling it. |
| update_recommendation | Confirm first | Mark a briefing action done, dismissed, or snoozed so the next briefing skips it. snoozeUntil is YYYY-MM-DD. |
| research_keywords | Confirm first | New keyword ideas for one project. A paid AI research run billed from the balance. The project needs an audience set in the SEO Agent. Confirm before calling it. |
| lookup_keywords | Confirm first | Keyword ideas from one seed: volume, difficulty, and intent. Spends 6 lookup credits unless the result is already cached. Confirm the cost before calling it. This is not research_keywords. |
| check_keywords | Confirm first | Volume, difficulty, and intent for keywords the user names. Spends 2 lookup credits. Confirm before calling it. |
| lookup_domain | Confirm first | Organic keywords, estimated traffic, and top ranking URLs for a domain. Spends 4 lookup credits unless cached. Confirm before calling it. countryCode defaults to US. |
| lookup_backlinks | Confirm first | Referring domains, backlink totals, and domain rank for a domain. Spends 3 lookup credits unless cached. Confirm before calling it. |

Things to ask:

- "What should I do with my SEO today?"
- "What are my low-hanging fruits?"
- "What moved in the last 7 days?"
- "What do Google and AI crawlers see on my homepage?"
- "Which competitors outrank me on tracked keywords?"
- "Where does an AI Overview show without citing my site?"
- "Research new keywords for this project."

## Prompts

The server also exposes these prompts:

- daily_seo_checkin: What to do with SEO today, from the latest BudgetSEO data.
- weekly_seo_review: Winners, losers, and the best opportunities from the last 7 days.
- quick_win_sprint: Low-hanging fruit and a page checklist for the best few.
- autopilot_setup: How to schedule a daily SEO check that uses this connector.

## Sign in

Every tool needs your budgetSEO account. Public tools are not available without sign-in.

| Method | When to use it |
| --- | --- |
| Sign in on budgetSEO | Claude, ChatGPT, Claude Code, Cursor, and other OAuth clients show Connect the first time they need your account. You log in and click Allow. The key never goes through the chat. Revoke the app any time on Connect AI. |
| Personal access token | Scripts and apps without OAuth. Create it on Connect AI. Header: Authorization: Bearer TOKEN. Tokens start with bseo_pat_. The plaintext token is shown once. Only its SHA-256 hash is stored. Treat it like a password. |

A normal signed-in browser session is not accepted as an MCP token.

## Plans

The MCP server uses the same account as the budgetSEO app. There is no separate MCP license.

| Plan | Price | What it changes for MCP |
| --- | --- | --- |
| Pay as you go | $0 | 15 keywords included and checked when you click, extras paid per check, unlimited projects. Read tools are free. AI keyword research runs and AI visibility checks (about 53¢, on demand) are billed from the balance. |
| Growth | $2.99/week from the balance | 100 keywords included, unlimited projects, weekly checks. AI keyword research at member price. AI visibility on 1 project. |
| Business | $93.60/mo or $936/yr | 1000 keywords included, unlimited projects, weekly checks plus daily checks on up to 100 ranking keywords. AI keyword research at member price. AI visibility on 5 projects. |

Pricing: https://www.budgetseo.ai/pricing
Start free: https://www.budgetseo.ai/signup

## Limits

- 60 MCP calls a minute per account.
- Read tools never spend lookup credits.
- track_keywords: Pay as you go has no keyword limit: the first 15 are checked free and the others are billed per check. Paid plans use their keyword slots. Adding keywords never spends lookup credits.
- lookup_keywords spends 6 credits, check_keywords spends 2, lookup_domain spends 4, and lookup_backlinks spends 3, unless that result is already cached. Confirm before each call.
- research_keywords is a paid AI run billed from the balance, and needs an audience set in the SEO Agent.
- get_ai_visibility citation gaps come from tracked keywords. Mention counts need a paid plan with AI visibility on.
- The assistant should confirm before track_keywords, untrack_keyword, research_keywords, update_recommendation, lookup_keywords, check_keywords, lookup_domain, or lookup_backlinks.
- The server does not change the website. get_keyword_action_plan is a checklist.

## FAQ

### What is the budgetSEO MCP server?

budgetSEO MCP is a Model Context Protocol server. A signed-in assistant can read your Google rank tracking, quick wins, competitor gaps, and AI Overview citation gaps, then track or untrack keywords and research new ones after you confirm. Documentation is https://www.budgetseo.ai/mcp. The protocol endpoint is https://www.budgetseo.ai/api/mcp.

### What URL do I add in Claude, ChatGPT, or Cursor?

Add https://www.budgetseo.ai/api/mcp. The transport is streamable HTTP. This HTML page is https://www.budgetseo.ai/mcp. Do not point the client at this page.

### Does the MCP server work without a budgetSEO account?

No. Every tool needs your budgetSEO account. Claude, ChatGPT, Claude Code, and Cursor open a consent screen. You sign in and allow the app. Scripts use a personal access token from Connect AI. The token starts with bseo_pat_, is shown once, and only its hash is stored.

### Which tools only read data?

Read tools are get_seo_briefing, find_quick_wins, find_opportunities, list_projects, get_rank_changes, get_keyword_action_plan, get_competitor_overview, get_ai_visibility, and get_search_performance. They do not spend lookup credits. get_competitor_overview uses saved competitor data and does not start a paid lookup. get_search_performance reads saved Search Console numbers and does not spend lookup credits.

### Which tools change my account?

track_keywords adds keywords: Pay as you go has no keyword limit: the first 15 are checked free and the others are billed per check. Paid plans use their keyword slots. Adding keywords never spends lookup credits. untrack_keyword deletes one keyword and its history and cannot be undone. update_recommendation marks a briefing action done, dismissed, or snoozed. research_keywords finds new ideas and spends an AI research run. lookup_keywords, check_keywords, lookup_domain, and lookup_backlinks spend lookup credits and do not edit the website. A cached lookup stays free. The assistant should confirm before any of these. None of them edit your website.

### Does connecting an assistant cost extra?

The connector is included with your budgetSEO plan. Pay as you go is $0 to start, with no credit card: 15 keywords included and checked when you click, extras paid per check, unlimited projects. Growth is $2.99/week from your balance. Business is $93.60/mo or $936/yr. research_keywords is a paid AI run billed from the balance. Fresh keyword, domain, and backlink lookups spend the same credits as the app. AI visibility mention counts come from scheduled snapshots on Growth and Business, or an on-demand check (about 53¢) on Pay as you go. Read tools do not spend lookup credits. The limit is 60 MCP calls a minute per account.

### Can ChatGPT or Claude run this every day?

ChatGPT scheduled tasks can call the connector. A free ChatGPT account can schedule at most once a day. Claude chat does not run connectors on a schedule. Claude Code scheduled tasks use the connector saved in claude.ai. Cursor does not run connectors on a schedule. A useful daily prompt is to call get_seo_briefing and quote estimated monthly clicks.

### How does an agent discover the budgetSEO MCP server?

Agents discover this server from the AI catalog at https://www.budgetseo.ai/.well-known/ai-catalog.json, then read the server card at https://www.budgetseo.ai/api/mcp/server-card. The card names the streamable HTTP endpoint https://www.budgetseo.ai/api/mcp and says a bearer token is required. This documentation page is https://www.budgetseo.ai/mcp. The same facts as Markdown are https://www.budgetseo.ai/mcp.md. SEO skills that call this server are listed at https://www.budgetseo.ai/skills.md and https://www.budgetseo.ai/.well-known/agent-skills/index.json.

### How do I disconnect an app?

Open Connect AI in budgetSEO and revoke the app or delete the personal access token. A normal signed-in browser session is not an MCP token. After you revoke an app, it can no longer call these tools.
