Tool reference

The MCP server exposes 36 tools. They are the same operations the dashboard runs, so anything you can do by clicking, an agent can do by calling. This section documents each tool's arguments, defaults, cost, and behaviour.

Group	What it is for	Tools
Workspace	Orient: who am I, what projects exist, create one.	whoami, list_projects, create_project
Keyword research	Turn seeds into scored keywords with volume, difficulty, CPC, and intent; save the ones worth keeping.	research_keywords, get_keyword_metrics, save_keywords, list_saved_keywords
Domain and backlink research	Competitive analysis for any domain: traffic estimates, ranked keywords, top pages, SERP competitors, and link profiles.	get_domain_overview, get_ranked_keywords, get_domain_top_pages, find_serp_competitors, get_backlinks_overview, get_backlinks_profile
Local search	Google Business Profile listings, city-level SERPs, and the questions people ask on a listing.	search_local_businesses, get_local_serp_results, get_google_business_questions
Rank tracking	Scheduled or on-demand SERP position checks, national or city-level, desktop and mobile. Estimate the cost before running.	create_rank_tracker, get_rank_tracker, estimate_rank_tracker_cost, add_rank_tracking_keywords, remove_rank_tracking_keywords, run_rank_tracker
Site audits	A robots-aware crawler over your own origin: 27 technical and on-page issue types, plus Lighthouse on a sample. Asynchronous — poll get_audit_status.	run_site_audit, get_audit_status, get_audit_issues, get_audit_pages
Your own measured data	Search Console, Google Analytics, and PostHog for a connected project. Free: these read data you already own rather than buying estimates.	get_search_console_performance, get_striking_distance, inspect_urls, get_analytics_report, get_search_opportunities, get_posthog_overview, get_posthog_report, get_posthog_search_opportunities
AI visibility	Whether assistants mention and cite you: share of voice in ChatGPT and Google's AI Overviews, and one-off prompt runs.	get_brand_visibility, run_ai_prompt

Conventions shared by every tool

projectId. Every tool except whoami, list_projects, and create_project takes a projectId. Get it from list_projects. It scopes the call, supplies the default domain and market, and attributes credit spend. A project id that does not belong to the workspace fails with Project <id> not found in this workspace. whether it exists or not.

Market defaults. Tools that take locationCode (a location code; 2840 is the United States) and languageCode (an ISO code such as en) fall back to the project's market when you omit them. Pass them to research a different country without changing the project.

Domain defaults. Domain and backlink tools take an optional domain. When omitted they analyse the project's own domain; pass a competitor's to compare. Domains are bare (example.com), with no protocol or path.

Limits. Tools that return rows take an optional limit with a stated maximum and default. Rows beyond the limit are not returned, and the tool says how many it dropped.

Cost. Each tool's description says whether it costs credits. Free tools are marked read-only in their annotations. See How credits work.

Results. Every result carries the full rows as a text table and as structured content, plus _meta with the organization and project ids, a dashboard deep link where relevant, and for paid calls the credits charged and remaining. Missing values render as —, booleans as yes/no, decimals to two places.

Errors. Failures come back as tool results marked as errors with a code, a message, and a hint. See Errors.

Free versus paid

Asynchronous tools

Two tools start work and return before it finishes:

• run_site_audit returns an auditId. Poll get_audit_status until it reports completed, then read get_audit_issues and get_audit_pages.
• run_rank_tracker returns a runId. Poll get_rank_tracker for positions.

Both run the same background workflows the dashboard uses, so a run started by an agent shows up in the app with live progress.