Mentionable MCP Tools Reference — All 30 tools, schemas and examples

The Mentionable MCP server exposes 30 tools on a single endpoint (POST https://mentionable.ai/api/mcp). 20 are read tools, 10 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_llm_sources	Domains cited or searched by LLMs	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_page_audits	Page Audits for a project, with status and score	Read
list_geo_audits	GEO Audits (one-shot white-label) for the workspace, with status and progress	Read
list_geo_audit_competitors	A GEO Audit's competitor candidates (ranked) plus the current selection	Read
list_geo_audit_recommendations	A GEO Audit's generated + custom recommendations	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 a single Page Audit (poll until COMPLETED)	Read
get_geo_audit	Fetch a single GEO Audit (status, progress, full content when COMPLETED)	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
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	Queue a Page Audit on a URL (100 credits per audit)	Write
select_geo_audit_competitors	Freeze a GEO Audit's competitor selection and advance REVIEWING → GENERATING	Write
add_geo_audit_recommendation	Add a custom recommendation to a GEO Audit report	Write
remove_geo_audit_recommendation	Remove a custom recommendation from a GEO Audit	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 GEO Audit	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

Common conventions

• Pagination. Every list tool accepts cursor and limit (1 to 100, default 20). Responses include a pageInfo object with hasMore, nextCursor and totalCount.
• LLM enum. CHATGPT, CLAUDE, PERPLEXITY, GEMINI, GROK, COPILOT, GOOGLE_AI_MODE, GOOGLE_AIO.
• IDs. All id, projectId, promptId, competitorId are CUIDs.
• Dates. All timestamps are ISO 8601 UTC strings.
• Errors. Project not found, Project not in API key scope, Competitor not found, validation errors from Zod.

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.