MCP
Tools
The tools the MCP server exposes and what they do.
The four tools
Once connected, your assistant can call these tools. They map onto the same operations as the REST API, so they consume quota the same way — an audit costs one check, everything else is free.
run_audit1 check- Input
- keyword, optional market and compare_url / compare_text
- Returns
- A run_id and status:'running' — the audit runs in the background
get_runFree- Input
- run_id
- Returns
- A run's status and, when done, its gap summary, gaps, and full report
get_gapsFree- Input
- run_id, optional quadrant / source / kind filters
- Returns
- The gap list: summary plus each gap's source, kind, quadrant, and score
list_runsFree- Input
- optional limit and offset
- Returns
- Your recent runs, newest first
A typical exchange
Ask your assistant something like “Run a GraphRanks audit for ‘knowledge graph seo’ and show me the top opportunity gaps.” It calls run_audit, waits for the run to finish, then get_gaps on the resulting run — no manual steps in between.