Model Context Protocol

Use budgetSEO insideClaude, ChatGPT and Cursor

budgetSEO is an MCP server. Plug it into your AI assistant and it can read your live Google rankings, quick wins, competitors, and AI Overview gaps, then track keywords after you confirm. This page is the public documentation. The protocol endpoint is separate.

Machine docs: https://www.budgetseo.ai/mcp.md · llms.txt · ai.txt

Tools
20 on one endpoint
Read tools
Do not spend lookup credits
Free plan
15 keywords, no card
Rate limit
60 calls a minute

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 .

Endpoint

Add this URL to any MCP client. Every tool needs your budgetSEO account. The transport is streamable HTTP, JSON-RPC, with OAuth 2.1 and dynamic client registration.

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

Connect

Leave the OAuth client ID and secret empty when the client asks. budgetSEO registers the app when you click Allow.

ClientHow 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 Codeclaude 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.
ChatGPTSettings, 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.
CursorSettings, 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 clientsTransport 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

Read tools never spend lookup credits. Write tools wait for your confirmation and do not edit the website.

ToolAccessWhat it returns or changes
get_seo_briefingReadStart 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_winsReadLow-hanging fruit and striking-distance keywords. Each result includes the estimated monthly clicks from moving up.
find_opportunitiesReadBest 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_projectsReadProjects, 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_changesReadWinners and losers over a recent window. days defaults to 7. The furthest lookback is 90 days.
get_keyword_action_planReadOne 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_overviewReadSaved 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_visibilityReadKeywords 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_performanceReadReal 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_pageReadReads 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_tasksReadOpen 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_taskConfirm firstCall 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_keywordsConfirm firstAdd 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_keywordConfirm firstRemove one tracked keyword and its history. This cannot be undone. Confirm before calling it.
update_recommendationConfirm firstMark a briefing action done, dismissed, or snoozed so the next briefing skips it. snoozeUntil is YYYY-MM-DD.
research_keywordsConfirm firstNew 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_keywordsConfirm firstKeyword 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_keywordsConfirm firstVolume, difficulty, and intent for keywords the user names. Spends 2 lookup credits. Confirm before calling it.
lookup_domainConfirm firstOrganic 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_backlinksConfirm firstReferring 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

  • 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 once

Claude, ChatGPT, Claude Code, and Cursor open budgetSEO the first time they need your account. You log in and click Allow. The token never goes through the chat. Revoke the app on Connect AI inside the product.

Scripts and clients without OAuth use a personal access token from Connect AI. Send Authorization: Bearer and the token. It is shown once. Only a SHA-256 hash is stored. A normal browser session is not an MCP token.

Plans

The connector uses the same budgetSEO account as the app. There is no separate MCP license. Full pricing.

PlanPriceWhat it changes for MCP
Pay as you go$0, pay per use15 keywords included and checked when you click, extras paid per check, unlimited projects. Lookups, AI keyword research and on-demand AI mention checks (about 53¢) billed from your balance.
Growth$2.99/week from your balance100 keywords included, unlimited projects, weekly checks. AI keyword research at member price. AI visibility on 1 project.
Business$93.60/mo or $936/yr1000 keywords included, unlimited projects, daily checks on up to 100 ranking keywords. AI keyword research at member price. AI visibility on 5 projects.

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.
  • research_keywords is a separate paid AI run billed from your balance, and needs an audience set in the SEO Agent.
  • Mention counts in get_ai_visibility need a paid plan with AI visibility turned on. Citation gaps use tracked keywords.
  • Confirm before track_keywords, untrack_keyword, research_keywords, or update_recommendation.

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.