DocsReference
SEO MCP tools reference
All 69 tools of the OpenSEO SEO MCP server: keyword research, rank tracking, site audits, AI visibility and Search Console, and which ones spend.
The MCP server at {API_URL}/mcp offers 69 tools. Each one calls the same REST route the dashboard uses, with the caller's API key, so validation, prices, caching and limits are identical. Most tools take an optional project_id; leave it out when the account has one project. With no project at all, paid lookups run on their own in the market their input names (the United States by default).
Account and projects
| Tool | What it does | Cost |
|---|---|---|
| whoami | The signed-in user and whether a YepAPI key is connected. | free |
| get_balance | Remaining YepAPI balance, whether auto top-up is on, and this month’s paid calls and spend. | free |
| get_usage | This month's spend, by feature. | free |
| list_projects | Projects with website, market and language. | free |
| create_project | Create a project. The country is worked out from location_code. | free |
| get_project | A project and its shared context notes. | free |
| update_project_context | Replace the context notes. Read them first and send the whole object back. | free |
| search_locations | Location codes for countries, regions and cities. | free |
| list_ai_models | Chat models for AI visibility, and the default set. | free |
Paid lookups
The 30 lookups share their names with the REST /lookups/:name routes. Their inputs are listed in each tool's schema. Prices are YepAPI's; "per 100" prices are billed on rows returned, so the figure for the default size is the most it can cost.
| Tool | What it does | Cost |
|---|---|---|
| keyword_ideas | Ideas or related keywords for a seed, with volume, CPC, difficulty, intent and trend. | $0.03 + $0.03/100 (150: $0.08) |
| keyword_metrics | Figures for your own list of up to 700 keywords, or 100 for a city. | $0.03 + $0.03/100; city $0.15 |
| serp | Live Google results and SERP features for a query, from a country, city or point. | $0.01 per 10 results |
| serp_features | For up to 100 keywords: the SERP features on the first page, the sites each AI Overview cites, and which features your domain owns. | $0.01 per keyword |
| autocomplete | Google autocomplete suggestions. | $0.01 |
| keyword_difficulty | Keyword difficulty for up to 1,000 keywords at once. | $0.03 + $0.03/100 |
| keyword_trends | Google Trends interest for up to 5 keywords. | $0.02 |
| seo_audit | A full SEO audit of a domain in one call: traffic, rankings, top keywords and pages, backlink profile, competitors, keywords close to the top 3, keyword and backlink gaps, and findings in order of importance. Search data only, no crawl. | $0.49 – $0.65 |
| domain_overview | Traffic and totals, ranking distribution and authority for a domain. | $0.14 ($0.08 totals only) |
| domain_traffic | Estimated organic and paid traffic and keyword counts of up to 1,000 domains, in one country. | $0.03 + $0.03/100 |
| domain_keywords | Keywords a domain ranks for; filter by position or URL path. | $0.03 + $0.03/100 |
| domain_pages | A domain's pages by estimated traffic. | $0.03 + $0.03/100 |
| url_metrics | URL Rating, backlinks, referring domains, traffic and keywords of up to 10 pages, with each site’s Domain Rating. | $0.02 per URL |
| competitors_domain | Domains ranking for the same keywords. | $0.03 + $0.03/100 |
| competitors_serp | Domains ranking most for up to 200 keywords. | $0.03 + $0.03/100 |
| keyword_gap | Keywords a competitor has and you don't, or that you share. | $0.03 + $0.03/100 |
| backlinks_summary | Backlink totals, follow split, broken links, spam score. | $0.05 |
| backlinks_history | Monthly totals with new and lost links. | $0.05 |
| backlinks_list | Individual backlinks, one per domain by default. | $0.05 + $0.01/100 |
| backlinks_referring_domains | Domains linking to a target. | $0.05 + $0.01/100 |
| backlinks_anchors | Anchor texts used in links. | $0.05 + $0.01/100 |
| backlinks_pages | Pages that attract the most links. | $0.05 + $0.01/100 |
| link_intersect | Domains linking to every one of 2 to 20 targets. | $0.05 + $0.01/100 |
| onpage_check | Quick check of one URL: status, title, headings, word count. | $0.03 |
| lighthouse | Lighthouse scores, Core Web Vitals and failed audits with a severity, most serious first. | $0.05 |
| maps_search | Google Maps places for a query, optionally around a point. | $0.07 |
| maps_place | A full Google Business profile. | $0.05 |
| maps_grid | Google Maps rankings across a 3×3 to 7×7 grid around a place: the top 20 businesses at every point. | $0.07 per point |
| maps_reviews | Up to 150 reviews with owner replies. | $0.015/100, min $0.01 |
| ai_compare | One prompt to up to 8 models side by side, with sources. | tokens, min $0.01 each |
| ai_citations | One question to up to 6 assistants with web search, with the sources each cited in order, links cleaned. | tokens, min $0.01 each |
Saved keywords
| Tool | What it does | Cost |
|---|---|---|
| list_saved_keywords | Saved keywords with figures and tags; search and filter by tag. | free |
| save_keywords | Save keywords, with figures you already have and tags. | free |
Rank tracking
| Tool | What it does | Cost |
|---|---|---|
| list_rank_trackers | Trackers with keyword counts, schedule, last run and the price range of a check. | free |
| create_rank_tracker | Create a tracker for a location or exact point. | free |
| add_rank_keywords | Add keywords to a tracker. A keyword removed earlier comes back with its history. | free |
| run_rank_check | Check every keyword now, to the tracker’s depth, in the background. Requires max_cost_usd. | $0.02 – $0.10 per keyword and device |
| get_rank_results | Positions, changes, ranking URLs, SERP features and recent history. | free |
| get_rank_competitors | Domains most often in the top 10, from the latest check. | free |
AI visibility
| Tool | What it does | Cost |
|---|---|---|
| get_ai_visibility_setup | Brand, competitors, models, prompts, schedule and the price of a run. | free |
| update_ai_visibility_setup | Change the brand, competitors, models, web search or schedule. | free |
| add_ai_prompts | Add prompts to track. | free |
| run_ai_visibility | Ask every active prompt to every model, in the background. Requires max_cost_usd; stops early instead of crossing it by more than one answer. | tokens, min $0.01 each |
| get_ai_visibility_results | Rates by model, share of voice, cited domains, the prompt grid, the trend, and the change since the previous run when the two are comparable. | free |
| get_ai_answers | Full answers and sources for one prompt. | free |
Site audit
| Tool | What it does | Cost |
|---|---|---|
| start_site_audit | Crawl a site. Rendering (render_mode) and the fallback for blocked pages (use_fallback) need max_cost_usd, which caps the audit. | free; $0.02/page rendered, $0.03/page unblocked |
| list_site_audits | Past and running audits with health scores. | free |
| get_site_audit | One audit: summary and issue counts with explanations, fixes and changes since the previous audit. | free |
| get_audit_issues | Affected URLs, optionally one issue type, severity or change (new, added, removed, missing). | free |
| get_audit_links | Links with each target’s status: links to 4xx pages, redirects, nofollow links, what links to a URL. | free |
| get_audit_fix_brief | A Markdown brief for fixing the issues in code, worst first, with URL patterns and samples. | free |
Local rank tracker
| Tool | What it does | Cost |
|---|---|---|
| run_geo_grid | Map Maps rankings across a grid around a place. Requires max_cost_usd. | $0.07 per point |
| get_geo_grid | A grid's status, average position and the results at every point. | free |
Search Console and Analytics
These read the project's own Google data. The user connects Google in the dashboard under Search performance; an agent cannot. They are free and spend nothing from YepAPI. See Use your Search Console and Analytics data.
| Tool | What it does | Cost |
|---|---|---|
| get_google_connections | Whether Search Console and Analytics are connected, and which property. | free |
| get_search_performance | Clicks, impressions, CTR and position against the previous period, daily series, countries and striking-distance queries. | free |
| get_search_console_rows | Rows by up to three dimensions, filtered by position and impressions over the top 1,000. | free |
| inspect_urls | Google's index status for 1 to 10 URLs. Google limits inspections per day. | free |
| get_analytics_overview | GA4 sessions, engagement, key events and revenue against the previous period. | free |
| get_analytics_landing_pages | GA4 landing pages with engagement and key events. | free |
| get_search_opportunities | Pages at positions 4 to 20 scored for where a push is most worth it. | free |
Errors come back as tool results marked as errors, with the same message the REST API gives, so the agent can read them and adjust. See Errors and troubleshooting.