MCP tool reference
All 47 GeckoGrid MCP tools in one place, grouped by what they do, from projects and scans to competitor intel, reports, schedules, and skills.
Updated
47 tools in 9 categories.
Projects & keywords
| Tool | What it does |
|---|---|
get_projects | List projects, with an optional kind filter (client or prospect) and a brief mode for compact rows without per-point rank arrays. |
get_project | Get a single project by its ID. |
create_project | Create a project. Grid size defaults from settings (or 7); grid spacing defaults to 1000 meters and shape to square when omitted. Set kind to prospect for a business scanned only to pitch it. |
update_project | Update a project by full replace: fetch it with get_project, change fields such as keywords, then resubmit the whole object. |
delete_project | Delete a project plus its scans, results, and prospect reports. Refused while one of its scans is running or queued. |
geocode_address | Turn a free-text address or an https Google Maps link into latitude and longitude (a link also resolves the place name) before creating a project. |
Scanning
| Tool | What it does |
|---|---|
get_project_scans | List all scans for a project, newest first. |
get_scan | Get one scan by ID. Pass wait_seconds (max 120) to wait for a pending or running scan instead of polling. |
get_daily_scan_info | Advisory daily local-scan count with a green, yellow, or red health field. Scans are never refused for the count, but check this before starting many. |
start_scan | Start a scan for a project keyword in the background, with an estimate. Wait with get_scan(id, wait_seconds). API scans respect the monthly DataForSEO spend cap. |
cancel_scan | Cancel a running or queued scan. |
delete_scan | Delete a scan and its results. Refused while the scan is running or queued. |
Results & exports
| Tool | What it does |
|---|---|
get_scan_results | Get a scan's per-grid-point results. Each point's top results are capped to 20 businesses to bound the response (pass top_results 0 for all). |
get_project_dashboard | Get a project's scan history plus header stats: total scans, keywords tracked, and total cost. An unknown project ID is an explicit error. |
export_csv | Export a scan's results to a CSV file. The path must be absolute and sit under Downloads, Desktop, Documents, or the home directory. |
export_scan_image | Export a scan's heatmap as a PNG, rendered offscreen. Can render a competitor's grid by place_id, with close or wide zoom, and reports tile status. |
Competitor intelligence
| Tool | What it does |
|---|---|
get_scan_competitors | Get one scan's competitor leaderboard: presence, average, best, and worst rank, ratings and reviews, plus a top-3 benchmark against the target business. |
get_competitor_trends | Track a project's top competitors across up to 20 recent scans: average rank and presence per scan, oldest to newest, optionally scoped to one keyword. |
Client reporting
| Tool | What it does |
|---|---|
get_keyword_history | Client-report data: each keyword's scan history for the project's own business with both average ranks and the change between scans. |
get_project_period_summary | Client-report data for a period (default the last 30 days): per keyword the baseline, latest, their change, and competitor movement, in one call. |
client_audit_create | Collect a client audit for the project's own business: Google profile, website, speed, and score, data only with no sales copy. Poll report_get until complete. |
Prospect reports
| Tool | What it does |
|---|---|
report_create | Create a prospect report for any business observed in a completed scan, competitors included. Idempotent per scan and business; collection takes a minute or two. |
report_list | List prospect reports, newest first, with an optional project filter. Use it to find an existing report before creating a duplicate. |
report_get | Get a prospect report's full working state: sections, score, AI copy, missing fields, blockers, and comparables. Accepts wait_seconds for collection. |
report_get_assets | List a complete report's image assets, rank grids and website screenshots, with absolute file paths the agent can open directly. |
report_set_assets | Fill a report's missing image slots from files the agent produced. Only empty slots can be filled and the method is stored as provenance. |
report_set_section | Write one of a prospect report's nine AI fields: headline, summary, highlights, design critique, fix plan, close pitch, or one of the three outreach variants. |
report_set_data | Fill report fields the collectors could not measure, with a required method note stored as provenance. Only gaps can be filled, never overwrites. Rescores at once. |
report_clear_ai | Clear all AI-written copy of a complete prospect report so it falls back to its data-derived editorial copy. |
report_set_extras | Set a report's footer contact block and its illustrative revenue figures. Only use money figures the user gave or confirmed. |
report_get_config | Read the report footer contact defaults that reports fall back to when a report has no contact block of its own. |
report_set_config | Set the report footer contact defaults (partial update) that apply to every report the agent builds. |
report_run_market | Look up the report keyword's monthly Google search volume via DataForSEO and store it on the report. Bills the DataForSEO account, so run it once per report. |
report_compare | Compare two complete reports of the same business: before and after values for score, top-3 presence, rank, coverage, rating, and reviews. |
report_render | Export a complete prospect report as a self-contained HTML file or a PDF, in full or leave-behind mode. The light theme is available for full mode only; the leave-behind always renders dark. |
report_delete | Delete a prospect report and its stored asset files. Refused while collection is still queued or running. |
Schedules
| Tool | What it does |
|---|---|
get_schedules | List all scan schedules. |
get_project_schedules | List all schedules for one project. |
create_schedule | Create a scan schedule: weekly, biweekly, or monthly, with optional per-schedule scan type and API mode overrides. |
update_schedule | Update a schedule by full replace. The next run time is recomputed on the server. |
delete_schedule | Delete a schedule by ID. |
Settings & logs
| Tool | What it does |
|---|---|
get_settings | Get the current application settings. |
update_settings | Update settings by full replace. DataForSEO credentials and the MCP token are never exposed or writable through this tool, and the monthly spend cap keeps its stored value. |
get_logs | Query the system log with optional filters. |
clear_logs | Clear all system log entries. Daily scan usage and DataForSEO spend are tracked in separate ledgers and are never reset. |
Skills
| Tool | What it does |
|---|---|
get_mcp_skill_markdown | Load the operational skill (how to drive GeckoGrid) by section, with a table of contents. Agents call this right after connecting. |
get_mcp_analyst_skill | Load one of the ten analyst skills by name, as markdown. |
Was this helpful?