Mentionable MCP Tools Reference | All 69 tools, schemas and examples
Overview of the Mentionable MCP server: 69 tools (46 read, 23 write) on a single endpoint. Each tool has its own page with input schema, response shape and a JSON example.
Updated 2026-10-15
The Mentionable MCP server exposes 69 tools on a single endpoint (POST https://mentionable.ai/api/mcp). 46 are read tools, 23 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_recommendations |
Actions that would get the project cited, ranked by impact, plus the prompts and zones to conquer | Read |
list_competitors |
Tracked competitors with mention totals and Share of Voice, filterable by AI verdict (retailers and products on e-commerce projects) | Read |
list_competitor_sources |
Domains where a given competitor is cited | Read |
list_retailers |
Retailers AI engines send buyers to (e-commerce projects), with brand presence alongside each one | Read |
list_products |
Products of an e-commerce project, the brand's and its competitors', with answers citing each one, filterable by product category | Read |
list_product_prompt_matrix |
Prompts by products: which prompt brings up which product, prompts lost to a competitor's product first | 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_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_site_health |
Technical health of the site at its latest monthly crawl: scores per level, fixes with their page count, changes since the previous crawl | Read |
list_site_issues |
Issues of the latest site crawl, one row per page and check, with how to fix each (open fixes only) | Read |
list_priority_pages |
This month's plan: the pages and fixes to do first, in order, with the evidence for each | Read |
get_site_page |
One page at the latest crawl: HTTP status, title, meta, H1, depth, internal links, indexability, and its issues (how to fix the open ones) | Read |
list_content_plan |
The content plan as it reads today: this week's missions, the rest of the month and the next months, each with its reason | Read |
get_content_mission |
One mission of the content plan with its full reason (opportunity score components for a page) | Read |
get_content_map |
The content plan's pages by theme, pillar then satellites, and the internal links placed or missing | Read |
get_page_fix |
Fetch the latest fix of a page: issues by severity with how to fix each, JSON-LD to paste, links to add (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 |
get_recommendation |
Step-by-step plan of one prompt or local zone, with evidence and measured effect | Read |
get_retailer |
One retailer: brand presence, prompts, brands recommended alongside it, cited pages and sources | Read |
get_product |
One product: raw names, engines, prompts, and the retailers, prices and rating seen on product cards | Read |
get_product_share_of_voice |
By product category: answers citing the category, your brand's share of its product mentions per engine, top brands and products | Read |
bulk_update_competitor_status |
Confirm or reject suggested competitors in bulk, or mark them as retailers or products (e-commerce projects) | Write |
bulk_update_reddit_thread_status |
Mark Reddit threads as commented, skipped or re-opened in bulk | Write |
run_page_fix |
List everything to fix on one page so Google and AI engines read it (free on this month's plan, 15 credits to unlock another page) | Write |
unlock_site_fix |
Unlock a site-wide fix outside this month's plan, on all its pages for one charge of 15 credits (price returned first, nothing charged without confirmCredits) | 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 |
set_recommendation_status |
Mark a recommendation or plan step done, excluded, or back to do (logs done actions in the journal) | Write |
create_prompts |
Add prompts to track (warns when a prompt names no place on a local project) | Write |
update_project_settings |
Turn a project's e-commerce mode on or off (retailers and products sorted apart from competitors) | 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.