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.

Memory

Saved facts about this website. Call list_memories after picking a website_id. Do not save metrics Ranketta tools already return.

Tool	What it does
`list_memories`	List saved memories.
`save_memory`	Save one durable fact.
`update_memory`	Update an existing memory by id.
`delete_memory`	Delete a memory by id.

Websites

Tool	What it does
`list_websites`	List all websites available to the authenticated user.
`get_website_profile`	Name, domain, country, and aliases for a website.

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_stats`	Citation overview KPIs: unique pages, covered pages, mention rate, and citation domains.
`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.
`analyze_page`	Inspect how AI sees a URL: AI-visible markdown, scores, and issues.
`add_page_to_site_audit`	Add one URL to a site audit (returns audit/page IDs only).
`check_schema_org`	Check whether a page has Schema.org markup (optional `url`, else homepage).
`check_wikipedia`	Check whether the website domain has a Wikipedia page.

Prompts & topics

Tool	What it does
`get_prompts`	List prompts, with optional topic and text filtering, and `limit`/`offset` pagination (max 100 per page).
`get_prompts_overview`	Lightweight prompt list sorted by search volume (top 20).
`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.
`list_tags`	List tags available for prompts in a website.
`create_tag`	Create a new prompt tag.
`add_tags_to_prompts`	Add existing tags to one or more prompts, without removing tags already on them.
`research_topics`	Research related topics by keyword or competitor domain (Prompt Research "Find topics").
`generate_prompts_for_topic`	Generate draft (inactive) prompts for a topic; then activate with `track_research_prompts`.
`generate_prompts_for_topics`	Generate draft prompts for up to 3 topics in one call.
`track_research_prompts`	Activate selected draft prompts from research / `generate_prompts_for_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_responses`	AI responses across all prompts (Responses table), with filters and sorting.
`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.

Actions

Tool	What it does
`list_actions`	List actions for a website, with status, type, and search filters.
`create_action`	Create a new action.
`complete_action`	Mark an action as completed.
`archive_action`	Archive (dismiss) an action, with an optional reason.
`star_action`	Star or unstar an action (`starred` optional; omit to toggle).

Content

Tool	What it does
`list_content_types`	List active content types available for creating content.
`list_content`	List Content Studio articles, with search, status, and content-type filters.
`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.
`get_snippet_sentiment_over_time`	Customer sentiment score over time, with period KPIs (Sentiment dashboard).
`get_snippet_highlights`	Top positive and negative customer mention snippets.
`get_snippet_perception`	Head-to-head perception KPIs and snippets for the brand vs an optional competitor.
`list_snippet_source_domains`	Citation domains that have customer mention snippets (Sources filter).

Traffic (Google Analytics & Search Console)

Requires a connected GA or GSC account for the website.

Tool	What it does
`list_ga_properties`	List connected Google Analytics (GA4) properties.
`get_ga_organic_sessions`	Organic search sessions over time.
`get_ga_ai_referred_sessions`	Sessions referred by AI assistants.
`get_ga_traffic_stats`	AI-referral totals per provider plus change vs the previous period.
`get_ga_top_pages`	Top landing pages from AI-referred traffic.
`list_gsc_sites`	List connected Google Search Console sites.
`get_gsc_keywords`	Top Search Console keywords by impressions (last 90 days).
`get_gsc_search_analytics`	Search Console rows with clicks, impressions, CTR, and average position.

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.

Merchandiser

Requires the merchandiser module. Config and sync only — no deletes; enrichment proposals are reviewed in-app.

Tool	What it does
`list_feed_formats`	Supported import/export feed formats.
`list_feed_sources`	Product feed sources with sync status.
`get_feed_source`	Details of one feed source.
`create_feed_source_from_url`	Create a feed source from a URL and start the first import.
`update_feed_source`	Update feed source name, sync interval, or active flag.
`sync_feed_source_now`	Trigger an immediate re-import.
`get_feed_source_import_mapping`	Inbound field mapping and health.
`update_feed_source_field_mappings`	Set inbound field mappings and re-sync.
`list_feed_exports`	Export channels for the website.
`get_feed_export`	Details of one feed export / channel.
`create_feed_export`	Create a new export channel.
`update_feed_export`	Update an export channel.
`get_feed_export_schema`	Export schema / slot definitions.
`update_feed_export_slot_overrides`	Override export slot mappings.
`get_product_enrichment_options`	Enrichment options for a product.
`list_enrichment_proposals`	Pending enrichment proposals.
`list_personas`	Shopping personas (stored audience / ICP).

ChatGPT Ads

Ads that appeared in this website's tracked ChatGPT completions (the same data as the /ads page). total_count / rendered_count are times shown in those responses, not ad-network impressions.

Tool	What it does
`get_ads_overview_stats`	Presence rate, other-advertiser count, and times-shown totals.
`list_ads`	Paginated creatives (one row per advertiser + title). Default sort is times shown.
`list_ad_advertisers`	Advertisers buying the most ChatGPT ad presence.
`get_ad_detail`	One advertiser or creative: stats, look (`body`, image, landing URL), and prompts it showed on.

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.