Mentionable MCP Tools Reference | All 48 tools, schemas and examples
Overview of the Mentionable MCP server: 48 tools (32 read, 16 write) on a single endpoint. Each tool has its own page with input schema, response shape and a JSON example.
Updated 2026-09-29
The Mentionable MCP server exposes 48 tools on a single endpoint (POST https://mentionable.ai/api/mcp). 32 are read tools, 16 are write tools.
Each tool has its own dedicated page with full input schema, response shape and a real JSON example.
All tools
| Tool | Purpose | Type |
|---|---|---|
list_projects |
List projects accessible to the API key | Read |
list_prompts |
Tracked prompts with mention rate per LLM | Read |
list_scans |
Tracking runs (scans) with status, LLMs covered and mention rate | Read |
list_prompt_results |
A prompt's history: one lightweight row per LLM and scan | Read |
list_fan_outs |
Raw fan-out queries the LLMs run, deduped and ranked | Read |
list_fan_out_extractions |
Paid fan-out extractions of a project, with status, credits and progress | Read |
list_llm_sources |
Domains cited or searched by LLMs | Read |
list_local_places |
Businesses shown in the ChatGPT / Google AI Overview map pack, with local visibility summary | Read |
list_competitors |
Tracked competitors with mention totals and Share of Voice | Read |
list_competitor_sources |
Domains where a given competitor is cited | Read |
list_backlink_opportunities |
High-impact domains with marketplace offers and prices | Read |
list_tracked_links |
Links you bought or placed, with price, citations and cost per cited link | Read |
list_ai_crawler_pages |
Pages visited by AI crawlers, with answer reads, search indexing, training crawls and citations | Read |
list_ai_crawler_visits |
Raw AI crawler visits, one row per day, path, crawler and HTTP status | Read |
list_page_audits |
Page optimizations of a project (and legacy page audits), with target prompt and status | Read |
list_geo_audits |
GEO Audits (one-shot white-label) for the workspace, with status, progress and report URL; filter by status, date range, bulk campaign or scope | Read |
list_bulk_audits |
Bulk GEO Audit campaigns (one shared scan, N targets) with status, target count and progress | Read |
list_bulk_audit_competitors |
A campaign's competitor candidates (ranked) plus the frozen selection | Read |
list_geo_audit_competitors |
A GEO Audit's competitor candidates (ranked) plus the current selection | Read |
list_geo_audit_recommendations |
A report's generated + custom recommendations (single audit or campaign) | Read |
list_geo_audit_content_ideas |
A report's generated + custom content ideas (single audit or campaign) | Read |
list_audit_ctas |
The workspace's audit CTAs (for teasing sections) | Read |
list_reddit_threads |
Reddit threads cited by LLMs, with GEO signals and scraped content | Read |
list_action_logs |
The project's action log, filterable by date range for monthly reports | Read |
get_page_audit |
Fetch one page optimization: ranked changes, text to check, optimized page (poll until COMPLETED) | Read |
get_geo_audit |
Fetch a single GEO Audit (status, progress, then structured metrics, prompts played, top sources and full content when COMPLETED) | Read |
get_bulk_audit |
Fetch a bulk campaign: status, per-status target headcount and, when COMPLETED, its segment-level insights | Read |
get_prompt_result |
Full detail of one or more results: raw response (opt-in), sources, fan-out, competitors | Read |
get_reddit_thread |
Fetch a single Reddit thread by ID (poll enrichment status) | Read |
get_fan_out_extraction |
One fan-out extraction: summary, then per prompt the searches and ranked results | Read |
get_ai_crawler_overview |
AI crawler visits to the site: totals, previous period, by kind and crawler, daily series, errors, published pages and actions | Read |
get_ai_crawler_page |
One page's AI crawler activity, citations by LLM and publication to first citation timeline | Read |
bulk_update_competitor_status |
Confirm or reject suggested competitors in bulk | Write |
bulk_update_reddit_thread_status |
Mark Reddit threads as commented, skipped or re-opened in bulk | Write |
run_page_audit |
Optimize an existing page for a tracked prompt (100 credits, fan-outs included) | Write |
create_fan_out_extraction |
Launch a ChatGPT fan-out extraction on chosen prompts (5 credits per prompt that searched) | Write |
select_geo_audit_competitors |
Freeze a GEO Audit's competitor selection and advance REVIEWING → GENERATING | Write |
select_bulk_audit_competitors |
Freeze a campaign's competitor selection and advance CURATING → GENERATING | Write |
add_geo_audit_recommendation |
Add a custom recommendation to a report | Write |
remove_geo_audit_recommendation |
Delete a custom recommendation, or remove a generated one by hiding it | Write |
add_geo_audit_content_idea |
Add a custom content idea to a report | Write |
remove_geo_audit_content_idea |
Delete a custom content idea, or remove a generated one by hiding it | Write |
set_geo_audit_section_visibility |
Set a GEO Audit section to visible, teased (behind a CTA), or hidden | Write |
set_geo_audit_recommendation_visibility |
Show or hide a generated recommendation in a report | Write |
set_geo_audit_content_idea_visibility |
Show or hide a generated content idea in a report | Write |
enrich_reddit_thread |
Trigger Bright Data scrape of a Reddit thread (50 credits per enrichment) | Write |
create_action_log |
Log an action performed on the project (appears in journal and reports) | Write |
create_prompts |
Add prompts to track (warns when a prompt names no place on a local project) | Write |
Common conventions
- Pagination. Every list tool accepts
cursorandlimit(1 to 100, default 20). Responses include apageInfoobject withhasMore,nextCursorandtotalCount. - LLM enum.
CHATGPT,CLAUDE,PERPLEXITY,GEMINI,COPILOT,GOOGLE_AI_MODE,GOOGLE_AIO. - IDs. All
id,projectId,promptId,competitorIdare CUIDs. - Dates. All timestamps are ISO 8601 UTC strings.
- Errors.
Project not found,Project not in API key scope, validation errors from Zod. Business errors come back as{ success: false, error }with a snake_case code (e.g.competitor_not_found).
Auth requirements
Read tools require any non-customer role. Write tools require member or above. Every project-scoped tool checks the API key's effective scope before dispatch. See Authentication for details.