MCP Server

Available tools

Full reference of the tools the Ranketta MCP server exposes, grouped by area.

Every tool below runs scoped to your authenticated Ranketta account and its existing role and module permissions, the same as the Ranketta app itself. Most tools take a website_id to select which website they apply to.

Websites

Tool	What it does
`list_websites`	List all websites available to the authenticated user.

Analytics & visibility

Tool	What it does
`get_overview_stats`	Top stat cards from the Home dashboard.
`get_overview_chart`	Time-series chart from the Home dashboard.
`get_overview_chart_by_ai_model`	Per-AI-engine trend chart.
`get_overview_competitor_scatter`	Visibility vs. sentiment scatter across competitors.
`get_visibility_by_ai_model`	Per-AI-model visibility breakdown (ChatGPT, Perplexity, Gemini, and others).
`list_ai_models`	List all AI models tracked for the workspace.

Citations & fan-out

Tool	What it does
`get_citation_urls`	Paginated citation URLs, with search, mention, and type filters.
`get_citation_domains`	Paginated citation domains, with search, mention, and type filters.
`get_citation_prompts`	Prompts where a citation URL or domain appears, with citation share per prompt.
`get_citation_domain_types_breakdown`	Citation share by domain type (corporate, UGC, editorial, and others).
`get_citation_page_types_breakdown`	Citation share by page type (blog post, product page, and others).
`get_fanout_queries`	Fan-out queries for the selected website, with pagination.

Site audit

Tool	What it does
`get_site_audit`	Aggregate site-audit metrics for the selected website.
`get_site_audit_pages`	Paginated site-audit pages, with score filters and sorting.
`start_site_audit`	Start a new site audit for the selected website.
`add_page_to_site_audit`	Analyze one URL and add it to a manual site audit.

Prompts & topics

Tool	What it does
`get_prompts`	List prompts, with optional topic and text filtering.
`get_prompt_details`	Prompt details and summary stats, by prompt ID or text.
`create_prompt`	Create a new prompt for a website and optional topic.
`list_countries`	List available countries (codes and IDs) for a website, used when creating a prompt.
`list_topics`	List topics available for prompts in a website.
`create_topic`	Create a new prompt topic.
`get_prompt_citations`	Citation URLs for a prompt, identified by text.
`get_prompt_fanout_queries`	Fan-out query terms for a prompt, identified by text.
`get_prompt_responses`	Prompt responses, with pagination, date range, and provider filters.
`get_prompt_chart_data`	Chart data for the prompt detail view.
`get_prompt_competitor_landscape`	Competitor table for a prompt, with visibility, position, sentiment, and share of voice.

Competitors

Tool	What it does
`list_competitors`	List competitors tracked for a website.
`create_competitor`	Add a new competitor to track.
`enable_competitor`	Start tracking an existing competitor.
`disable_competitor`	Stop tracking a competitor, without deleting it.
`bulk_enable_competitors`	Start tracking several existing competitors at once.
`bulk_disable_competitors`	Stop tracking several competitors at once, without deleting them.
`enable_all_competitors`	Start tracking every competitor for a website in one call.
`disable_all_competitors`	Stop tracking every competitor for a website in one call, without deleting them.

Opportunities

Tool	What it does
`list_opportunities`	List opportunities for a website, with status, type, and search filters.
`create_opportunity`	Create a new opportunity.
`complete_opportunity`	Mark an opportunity as completed.
`reject_opportunity`	Reject an opportunity, with an optional reason.

Content

Tool	What it does
`list_content_types`	List active content types available for creating content.
`create_content`	Create content and start generating it, blank, from a URL, or from an existing article.
`optimize_content`	Optimize existing content, in default or SEO/GEO mode.

Sentiment

Tool	What it does
`list_analyses`	List all active sentiment analyses (brands tracked for sentiment).
`get_analysis_detail`	Detail of a single sentiment analysis, including loading status and stats.
`get_analysis_sentiment`	Per-aspect sentiment summary for an analysis.
`list_analysis_aspects`	List active aspects (sentiment questions) configured for an analysis.
`list_sentiment_aspect_choices`	List predefined aspect templates that can be added to any analysis.
`list_sentiment_providers`	List AI providers currently configured for sentiment analysis.
`get_analysis_available_date_range`	Earliest and latest completion dates for an analysis's runs.

Shopping

Tool	What it does
`get_shopping_overview_stats`	Brand overview stats for the Shopping module.
`get_shopping_overview_chart`	Time-series for the Shopping overview chart.
`get_shopping_overview_competitor_scatter`	Brand scatter for the Shopping overview.
`get_shopping_best_sellers`	Paginated best sellers: products AI recommends, with visibility metrics.
`get_shopping_products`	Paginated shopping product catalogue, with health scores and visibility.
`get_shopping_product_detail`	Full shopping product detail: attributes, images, visibility.
`enrich_shopping_product`	Queue an enrichment agent run for a single shopping product.

Many of these endpoints are also available on the public REST API, for integrations that use API keys instead of MCP.

Introduction

Connect Claude, Cursor, and other MCP-compatible clients directly to your Ranketta data through the Model Context Protocol.