{"data":{"name":"ai.refora/refora","title":"Refora","description":"Read-only AI search visibility: brand mentions, competitors and citations in AI answers.","version":"1.0.0","websiteUrl":"https://refora.ai/docs/mcp","repositoryUrl":null,"remotes":[{"type":"streamable-http","url":"https://mcp.refora.ai/mcp"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-11-15T20:46:13.841Z","updatedAt":"2026-11-15T20:46:13.841Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"ai.refora/refora","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-15T20:46:13.841Z","title":"Refora","description":"Read-only AI search visibility: brand mentions, competitors and citations in AI answers.","websiteUrl":"https://refora.ai/docs/mcp","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"audit_page","title":"Audit a page for AI search","description":"Check how ready one web page is to be read and cited by AI assistants: whether robots.txt lets the AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended and others) in, llms.txt, the sitemap, structured data, headings, trust signals, meta tags and a Wikidata entry. Returns a 0-100 score, an A-F grade, the score per category, the main issues and the raw signals.\n\nUse this tool when the user asks whether a website is ready for AI search, why AI might not cite a page, or what to fix on it -- phrases like 'audit our homepage for AI', 'can ChatGPT crawl our site', 'GEO check of example.com'.\n\nIt checks the page itself. It does not measure what AI assistants answer about the brand; that needs a Refora workspace.\n\nExample question: 'Is kassaro.se ready for AI search?'","inputSchema":{"type":"object","properties":{"url":{"description":"The page to check: a full URL or a bare domain such as example.com.","maxLength":500,"minLength":4,"title":"Url","type":"string"}},"required":["url"],"title":"audit_pageArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"definitionHash":"b175c8292a1999ca60394f55822017b056812cf093ed6f07bae7bb8777d3346b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_account","title":"Account and plan","description":"What the connected Refora organization's plan includes (workspaces, tracked questions, AI models, how often they run) and what each workspace is measured with: its own tracking, a market snapshot, or nothing yet. Includes a link to set up tracking and one to the plans.\n\nUse this tool when the user asks what their plan covers, why a number comes from market data, or how to track their own questions -- phrases like 'what's included', 'can you track this weekly', 'how do I add my own questions'.\n\nExample question: 'What does my Refora plan include?'","inputSchema":{"type":"object","properties":{},"title":"get_accountArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"ac4703d12f6d9416bfbb60790786db7b0a5b4ee2e4b4ae8f040992aa2ae175e5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_ai_answers","title":"AI answers","description":"The answers themselves: what ChatGPT, Perplexity, Gemini, Claude, Mistral and Google AI Overviews said to this workspace's prompts, each with the brands it mentions and the URLs it cites.\n\nUse this tool when the user wants to read or quote what an AI said -- phrases like 'what does ChatGPT say about us', 'show me the answers to the prompt about X', 'how do AI models describe our competitor', 'show answers where we are not mentioned' -- or to explain a number another Refora tool returned. For numbers (visibility, share of voice, trends, sentiment, sources), use those tools: they count every answer, this one returns a page.\n\nFilter by prompt (its text or a distinctive part of it), model, brand (brand_mentioned=true for answers that mention it, false for answers that don't; without brand_name it is the workspace's own brand) and window. Answers come newest first, 10 per page; when next_offset is set, call again with offset=next_offset. An answer longer than 2,000 characters is cut (truncated: true); to read it whole, call again with its prompt_text, model, its date as start_date and end_date, and full_text=true.\n\nExample: 'What did Perplexity say when asked for the best CRM?'","inputSchema":{"type":"object","properties":{"workspace_id":{"description":"The workspace's numeric id, as returned by list_workspaces.","minimum":1,"title":"Workspace Id","type":"integer"},"prompt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional: only answers to this prompt. Its text as another Refora tool returned it, or a distinctive part of it, matched case-insensitively. If several prompts match, the response lists them so the user can pick. Omit for every prompt.","title":"Prompt Text"},"model":{"anyOf":[{"enum":["openai","perplexity","gemini","anthropic","mistral","google-aio"],"type":"string"},{"type":"null"}],"default":null,"description":"Optional: only this AI model's answers. openai = ChatGPT, anthropic = Claude, mistral = Le Chat, google-aio = Google AI Overviews. Omit for every model.","title":"Model"},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional: a brand to filter on. Alone, it keeps the answers that mention it; with brand_mentioned=false, the ones that don't. Omit it and set brand_mentioned to filter on the workspace's own brand.","title":"Brand Name"},"brand_mentioned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Optional: true for only answers that mention the brand, false for only answers that don't. The brand is brand_name, or the workspace's own brand. Omit for answers either way.","title":"Brand Mentioned"},"days":{"default":30,"description":"How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty.","maximum":90,"minimum":1,"title":"Days","type":"integer"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future.","title":"End Date"},"offset":{"default":0,"description":"How many matching answers to skip. Pass the previous page's next_offset. Default 0.","minimum":0,"title":"Offset","type":"integer"},"limit":{"default":10,"description":"Answers per page. Default 10, max 25. A page can hold fewer when its answers are long.","maximum":25,"minimum":1,"title":"Limit","type":"integer"},"full_text":{"default":false,"description":"true to return answers whole (up to 20,000 characters each) instead of cut at 2,000. Narrow the filters first: meant for reading one or a few answers. Default false.","title":"Full Text","type":"boolean"}},"required":["workspace_id"],"title":"get_ai_answersArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"19c2f21e545e2e7ebe647560a618b02a0f806219d2e176a85fedd9d1d14f5222","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_citation_sources","title":"Citation sources","description":"The domains and URLs that AI models cite in their answers for this workspace's prompts, each marked as the brand's own site, a competitor's, or other. Each URL also says what kind of page it is and how often each model cited it.\n\nUse this tool when the user asks which websites or sources AI references -- phrases like 'what sources does AI cite', 'which websites does ChatGPT reference', 'top cited domains', 'which comparison pages does AI cite', or 'where does AI get its information about us'. Prefer it to paging through get_ai_answers for any question about cited pages.\n\nWith brand_name, only answers that mention that brand count. Without it, every answer in the workspace counts.\n\nmodel, page_type, owner and last_runs narrow what counts, in one call: e.g. model=[\"openai\", \"google-aio\"], page_type=[\"comparison\", \"listicle\"], owner=\"competitor\" and last_runs=3 for the competitor comparison and best-of pages ChatGPT and Google AI Overviews cited in the last 3 runs. Every URL carries its page_type and citations_by_model, and per_model gives each model's runs and citations, so a count reads as 'N citations in M runs'. A URL is a page: tracking tags (utm_*) and #fragments are dropped, so a page two models cite is one row.\n\nFor one topic, use get_top_cited_urls_for_topic. Across every workspace in the organization, use get_top_cited_domains.\n\nExample: 'What sources does AI cite most when talking about Kassaro?'","inputSchema":{"type":"object","properties":{"workspace_id":{"description":"The workspace's numeric id, as returned by list_workspaces.","minimum":1,"title":"Workspace Id","type":"integer"},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional brand name: count only answers that mention this brand. Omit for all answers.","title":"Brand Name"},"domain_limit":{"default":10,"description":"How many domains to list. Default 10, max 50.","maximum":50,"minimum":1,"title":"Domain Limit","type":"integer"},"url_limit":{"default":15,"description":"How many URLs to list. Default 15, max 50.","maximum":50,"minimum":1,"title":"Url Limit","type":"integer"},"model":{"anyOf":[{"enum":["openai","perplexity","gemini","anthropic","mistral","google-aio"],"type":"string"},{"items":{"enum":["openai","perplexity","gemini","anthropic","mistral","google-aio"],"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional: count only citations in these AI models' answers. One model, or a list such as [\"openai\", \"google-aio\"] to compare ChatGPT with Google AI Overviews. openai = ChatGPT, anthropic = Claude, mistral = Le Chat, google-aio = Google AI Overviews. Omit for every model. Each URL's count per model is returned either way.","title":"Model"},"page_type":{"anyOf":[{"enum":["homepage","product_page","category_page","article","how_to_guide","listicle","comparison","other"],"type":"string"},{"items":{"enum":["homepage","product_page","category_page","article","how_to_guide","listicle","comparison","other"],"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional: count only cited pages of this type, or a list of types. comparison = comparison and 'X vs Y' pages, listicle = best-of and top-X lists, plus article, how_to_guide, product_page, category_page, homepage, other. There is no review type: ask for comparison and listicle for review-style pages. A page not classified yet (page_type null) never matches. Omit for every page.","title":"Page Type"},"owner":{"anyOf":[{"enum":["own","competitor","other"],"type":"string"},{"items":{"enum":["own","competitor","other"],"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional: count only pages on these sites. own = the workspace's own site, competitor = a tracked competitor's site, other = everyone else (media, forums, comparison sites). One value or a list. Omit for every site.","title":"Owner"},"last_runs":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Optional: count only the newest N runs of each prompt on each model inside the window, e.g. 3 for 'the last 3 runs'. A prompt with fewer runs in the window counts the ones it has; widen days to reach older runs. per_model says how many runs were counted. Omit to count every run in the window.","title":"Last Runs"},"days":{"default":30,"description":"How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty.","maximum":90,"minimum":1,"title":"Days","type":"integer"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future.","title":"End Date"}},"required":["workspace_id"],"title":"get_citation_sourcesArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e4afd9dde9e25bc9ce6216968fa0a9164dcaafad1622b88be918b992937b8fd1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_competitor_comparison","title":"Competitor comparison","description":"Rank the workspace's own brand against the competitors the user tracks, by visibility: the share of AI answers that mention each brand.\n\nUse this tool when the user asks about competitive position -- phrases like 'how do we compare', 'who's winning', 'where do we rank', or 'vs competitors'.\nDo NOT use for the own score alone (use get_visibility_score), trends (use get_visibility_trend), or every brand the AI mentions, tracked or not (use get_share_of_voice).\n\nReturns: tracked brands ranked by visibility, the own brand among them. Brands with nothing to measure get no rank. To see WHY a competitor leads, follow up with get_competitor_visibility_gap.\n\nExample: 'How does Kassaro compare to its competitors?'","inputSchema":{"type":"object","properties":{"workspace_id":{"description":"The workspace's numeric id, as returned by list_workspaces.","minimum":1,"title":"Workspace Id","type":"integer"},"competitor_limit":{"default":5,"description":"How many competitors to list. Default 5, max 20.","maximum":20,"minimum":1,"title":"Competitor Limit","type":"integer"},"days":{"default":30,"description":"How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty.","maximum":90,"minimum":1,"title":"Days","type":"integer"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future.","title":"End Date"}},"required":["workspace_id"],"title":"get_competitor_comparisonArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"974f609ceb590ce0bd9f344dd2b187421f2dbd501aa642051725abc569d3c459","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_competitor_visibility_gap","title":"Competitor visibility gap","description":"The prompts where one tracked competitor is mentioned in AI answers more often than the workspace's own brand.\n\nUse this tool as a follow-up to get_competitor_comparison when the user wants to understand WHY a competitor is winning -- phrases like 'why is X beating us', 'where are we losing to X', 'what sources does AI cite for X', or 'how do we beat X'.\n\nReturns: prompts where the competitor leads by at least min_gap_percent percentage points, each with the gap, the AI models that favor the competitor, and the URLs AI cites in those answers (the brand's own pages left out). Use this data for content briefs.\n\nExample: 'Why is Sitoo beating Kassaro, and what sources does AI cite for them?'","inputSchema":{"type":"object","properties":{"workspace_id":{"description":"The workspace's numeric id, as returned by list_workspaces.","minimum":1,"title":"Workspace Id","type":"integer"},"competitor_name":{"description":"A tracked competitor's name, as get_competitor_comparison lists it. Case does not matter.","minLength":1,"title":"Competitor Name","type":"string"},"prompt_limit":{"default":10,"description":"How many prompts to return. Default 10, max 50.","maximum":50,"minimum":1,"title":"Prompt Limit","type":"integer"},"min_gap_percent":{"default":5,"description":"Smallest lead to report, in percentage points (0-100). Default 5, meaning the competitor appears in at least 5 points more of the answers.","maximum":100,"minimum":0,"title":"Min Gap Percent","type":"number"},"days":{"default":30,"description":"How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty.","maximum":90,"minimum":1,"title":"Days","type":"integer"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future.","title":"End Date"}},"required":["workspace_id","competitor_name"],"title":"get_competitor_visibility_gapArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"cf8e748b931b7449a7a58eb0acf6dbb26edd89cdf03259a5ecc9a8ecc1225318","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_market_ai_presence","title":"Market AI presence","description":"A market snapshot of the workspace's website from an external index of AI answers: ChatGPT's and Gemini's answers to the brand's buyer questions as users see them in its country (share of answers naming the brand and each competitor, who else they name, which sources they cite), and how often Google's AI Overviews cite the site next to its competitors, month by month, with the questions where a competitor is cited and the site is not.\n\nUse this tool when the user asks how visible they are in AI before their own questions are tracked, or wants the wider market picture next to their own tracking -- phrases like 'does ChatGPT recommend us', 'who does AI recommend instead of us', 'how do we compare in Google's AI answers'.\n\nThe snapshot is built once, when the account is created; status 'building' means it is not ready yet. Its numbers are not the workspace's own tracking: read each section's about.\n\nExample question: 'Does ChatGPT recommend Kassaro?'","inputSchema":{"type":"object","properties":{"workspace_id":{"description":"The workspace's numeric id, as returned by list_workspaces.","minimum":1,"title":"Workspace Id","type":"integer"}},"required":["workspace_id"],"title":"get_market_ai_presenceArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"ecaad37dcb4463f1186afd4e1ed2b4110f13bc10d45e03df4c205c9d6ea6ffae","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_prompt_performance","title":"Prompt performance","description":"Detailed performance for one prompt (one question Refora asks the AI models on a schedule): visibility over time, per-model visibility and answers, and the URLs cited in its answers.\n\nUse this tool when the user asks about a specific prompt -- phrases like 'how are we doing on the prompt about X', 'details on this prompt', or as drill-down after seeing prompts from get_competitor_visibility_gap.\n\nName the prompt by its text: the full text as another Refora tool returned it, or a distinctive part of it. Prompts with the same text are one question and are measured together. If several prompts match, the response lists them so the user can pick.\n\nExample: 'How are we doing on the prompt about enterprise CRM?'","inputSchema":{"type":"object","properties":{"workspace_id":{"description":"The workspace's numeric id, as returned by list_workspaces.","minimum":1,"title":"Workspace Id","type":"integer"},"prompt_text":{"description":"The prompt's text, exactly as another Refora tool returned it, or a distinctive part of it. Matched case-insensitively.","minLength":1,"title":"Prompt Text","type":"string"},"days":{"default":30,"description":"How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty.","maximum":90,"minimum":1,"title":"Days","type":"integer"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future.","title":"End Date"}},"required":["workspace_id","prompt_text"],"title":"get_prompt_performanceArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"61e7eb36d123fd18a7972a378a2754c50d98e2f3e1f3b7fba90cb87fef9bae40","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_sentiment_breakdown","title":"Sentiment breakdown","description":"How AI models talk about a brand: sentiment scores overall and per model, with example excerpts showing tone and framing.\n\nUse when the user asks how AI talks about their brand -- phrases like 'how does AI describe us', 'what's the sentiment', 'is ChatGPT positive or negative about us', or 'how do AI engines talk about [brand]'.\n\nReturns: overall sentiment score (0-100, 50 is neutral), per-model breakdown, and up to 3 examples per label (positive/neutral/negative), each a short excerpt around the mention.\n\nExample: 'How does ChatGPT describe Kassaro -- positively or negatively?'","inputSchema":{"type":"object","properties":{"workspace_id":{"description":"The workspace's numeric id, as returned by list_workspaces.","minimum":1,"title":"Workspace Id","type":"integer"},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional brand to analyse, e.g. a tracked competitor. Omit for the workspace's own brand.","title":"Brand Name"},"days":{"default":30,"description":"How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty.","maximum":90,"minimum":1,"title":"Days","type":"integer"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future.","title":"End Date"}},"required":["workspace_id"],"title":"get_sentiment_breakdownArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"c235a4458c05bae2367107f5ca7f1fc67451a1098c90979c287dd7acee67e89c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_share_of_voice","title":"Share of voice","description":"The workspace's own brand's share of ALL brand mentions in AI answers, and which brands hold the rest -- every brand the models named, each marked as a tracked competitor or not.\n\nUse this tool when the user asks who the AI talks about -- phrases like 'share of voice', 'who gets mentioned most', 'which brands does AI recommend in our space', or 'who else shows up'.\nDo NOT use to rank against the competitors the user tracks (use get_competitor_comparison, which measures the share of answers that mention each tracked brand).\n\nReturns: own share in percent, own rank, and the top brands with their shares.\n\nExample: 'Which brands does AI mention most when people ask about our category?'","inputSchema":{"type":"object","properties":{"workspace_id":{"description":"The workspace's numeric id, as returned by list_workspaces.","minimum":1,"title":"Workspace Id","type":"integer"},"days":{"default":30,"description":"How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty.","maximum":90,"minimum":1,"title":"Days","type":"integer"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future.","title":"End Date"},"competitor_limit":{"default":5,"description":"How many other brands to list. Default 5, max 20.","maximum":20,"minimum":1,"title":"Competitor Limit","type":"integer"}},"required":["workspace_id"],"title":"get_share_of_voiceArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"ee9146e82171f9ecde02b246895edcf3375331a49f2ad3b1f4feedc26de14717","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_top_cited_domains","title":"Top cited domains, all workspaces","description":"The domains AI models cite most across ALL workspaces in the organization. Aggregate view for multi-workspace orgs.\n\nUse when the user wants org-level source analysis -- phrases like 'across all workspaces', 'org-wide sources', 'top domains overall', or 'which sites dominate'. For one workspace, use get_citation_sources.\n\nExample: 'Which domains are cited most across all our brands?'","inputSchema":{"type":"object","properties":{"domain_limit":{"default":15,"description":"How many domains to list. Default 15, max 50.","maximum":50,"minimum":1,"title":"Domain Limit","type":"integer"},"days":{"default":30,"description":"How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty.","maximum":90,"minimum":1,"title":"Days","type":"integer"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future.","title":"End Date"}},"title":"get_top_cited_domainsArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"ddf031c5a62e04e01da102cbfdbdd4d498c069111e33f810637782add1750f35","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_top_cited_urls_for_topic","title":"Top cited URLs for a topic","description":"The URLs that AI models cite most for the workspace's prompts in one topic. Use this for content briefs -- it shows which sources AI treats as authoritative for that topic.\n\nUse when the user asks about sources for a topic -- phrases like 'what does AI cite for X topic', 'sources on X', 'content research for X', or 'authority sources for X'.\n\nTopics are the workspace's own; most are one of PROBLEM_AWARENESS, SOLUTION_COMPARISON, COMPETITOR_COMPARISON, EVALUATION, CATEGORY_DEEP_DIVE, HOW_TO. If the topic is not found, the response lists the topics that exist.\n\nmodel, page_type, owner and last_runs narrow what counts, in one call: e.g. model=[\"openai\", \"google-aio\"], page_type=[\"comparison\", \"listicle\"], owner=\"competitor\" and last_runs=3 for the competitor comparison and best-of pages ChatGPT and Google AI Overviews cited in the last 3 runs. Every URL carries its page_type and citations_by_model, and per_model gives each model's runs and citations, so a count reads as 'N citations in M runs'. A URL is a page: tracking tags (utm_*) and #fragments are dropped, so a page two models cite is one row.\n\nExample: 'What sources does AI cite for our EVALUATION prompts?'","inputSchema":{"type":"object","properties":{"workspace_id":{"description":"The workspace's numeric id, as returned by list_workspaces.","minimum":1,"title":"Workspace Id","type":"integer"},"topic":{"description":"The topic, e.g. EVALUATION. Case does not matter. An unknown topic returns the list of topics that exist.","minLength":1,"title":"Topic","type":"string"},"url_limit":{"default":15,"description":"How many URLs to list. Default 15, max 50.","maximum":50,"minimum":1,"title":"Url Limit","type":"integer"},"model":{"anyOf":[{"enum":["openai","perplexity","gemini","anthropic","mistral","google-aio"],"type":"string"},{"items":{"enum":["openai","perplexity","gemini","anthropic","mistral","google-aio"],"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional: count only citations in these AI models' answers. One model, or a list such as [\"openai\", \"google-aio\"] to compare ChatGPT with Google AI Overviews. openai = ChatGPT, anthropic = Claude, mistral = Le Chat, google-aio = Google AI Overviews. Omit for every model. Each URL's count per model is returned either way.","title":"Model"},"page_type":{"anyOf":[{"enum":["homepage","product_page","category_page","article","how_to_guide","listicle","comparison","other"],"type":"string"},{"items":{"enum":["homepage","product_page","category_page","article","how_to_guide","listicle","comparison","other"],"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional: count only cited pages of this type, or a list of types. comparison = comparison and 'X vs Y' pages, listicle = best-of and top-X lists, plus article, how_to_guide, product_page, category_page, homepage, other. There is no review type: ask for comparison and listicle for review-style pages. A page not classified yet (page_type null) never matches. Omit for every page.","title":"Page Type"},"owner":{"anyOf":[{"enum":["own","competitor","other"],"type":"string"},{"items":{"enum":["own","competitor","other"],"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Optional: count only pages on these sites. own = the workspace's own site, competitor = a tracked competitor's site, other = everyone else (media, forums, comparison sites). One value or a list. Omit for every site.","title":"Owner"},"last_runs":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Optional: count only the newest N runs of each prompt on each model inside the window, e.g. 3 for 'the last 3 runs'. A prompt with fewer runs in the window counts the ones it has; widen days to reach older runs. per_model says how many runs were counted. Omit to count every run in the window.","title":"Last Runs"},"days":{"default":30,"description":"How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty.","maximum":90,"minimum":1,"title":"Days","type":"integer"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future.","title":"End Date"}},"required":["workspace_id","topic"],"title":"get_top_cited_urls_for_topicArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"5eba9e7b7fe81fb4ea9b75b67d4b29501a35b4d1bd33e85169be1d05b462cf93","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_visibility_score","title":"Visibility score","description":"How visible the workspace's own brand is in AI answers: the share of AI answers that mention it, overall and per AI model (ChatGPT, Perplexity, Gemini, Claude, Mistral, Google AI Overviews), and the change from the window before.\n\nUse this tool when the user asks about current performance -- phrases like 'how are we doing', 'what's our score', 'how visible are we in AI', or 'current visibility'.\nDo NOT use for trends over time (use get_visibility_trend) or competitors (use get_competitor_comparison).\n\nReturns: visibility in percent (null means no answers to measure, not zero), the change in percentage points, one row per model with its visibility and number of answers, and a summary.\n\nExample: 'How is Kassaro doing in AI search right now?'","inputSchema":{"type":"object","properties":{"workspace_id":{"description":"The workspace's numeric id, as returned by list_workspaces.","minimum":1,"title":"Workspace Id","type":"integer"},"days":{"default":30,"description":"How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty.","maximum":90,"minimum":1,"title":"Days","type":"integer"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future.","title":"End Date"}},"required":["workspace_id"],"title":"get_visibility_scoreArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"c40c6f00ecc07ed257696843e7db2f1c080f50002d36c0dee3c68a7d54ff9961","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"get_visibility_trend","title":"Visibility trend","description":"Visibility over time for the workspace's own brand.\n\nUse this tool when the user asks about changes over time -- phrases like 'how has it changed', 'trending', 'are we improving', 'show the trend', or 'over the last month'.\nDo NOT use for the current snapshot (use get_visibility_score) or competitors (use get_competitor_comparison).\n\nReturns one data point per period and a trend summary. A period with no AI answers has a null visibility, not 0. Max 90 days.\n\nExample: 'How has our AI visibility changed over the last 30 days?'","inputSchema":{"type":"object","properties":{"workspace_id":{"description":"The workspace's numeric id, as returned by list_workspaces.","minimum":1,"title":"Workspace Id","type":"integer"},"days":{"default":30,"description":"How many days back to look, counted back from end_date (default today). Default 30, max 90. Ignored when start_date is given. Prompts are re-run on a schedule, so a window shorter than a week can be empty.","maximum":90,"minimum":1,"title":"Days","type":"integer"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional explicit start of the window, as an ISO date (YYYY-MM-DD). A full ISO datetime is accepted and its date is used. Overrides days.","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional end of the window, as an ISO date (YYYY-MM-DD). Default today. Cannot be in the future.","title":"End Date"},"resolution":{"default":"week","description":"Length of each period. Default 'week': prompts run on a schedule, so 'day' leaves empty periods.","enum":["day","week","month"],"title":"Resolution","type":"string"}},"required":["workspace_id"],"title":"get_visibility_trendArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"80d510e22e65c702e5f14d90ca1dcf5c01cdec202d37eac3247c5917f043848c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"},{"serverName":"ai.refora/refora","endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","name":"list_workspaces","title":"List workspaces","description":"List the workspaces in the connected Refora organization. Call this first: every other workspace tool needs a workspace_id from here.\n\nUse this tool when the user asks about their workspaces, projects, or brands they're monitoring -- phrases like 'what am I tracking', 'list my projects', 'show me my brands', or 'which workspaces do I have'.\n\nReturns: workspace ID, name, primary brand domain, active prompt count, creation date, website, data_source (own_tracking, market_data or none) and a one-line summary for each workspace.\n\nExample question: 'What workspaces do I have set up in Refora?'","inputSchema":{"type":"object","properties":{},"title":"list_workspacesArguments"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"95308eaa5ede0ea3609e1105a1b25bfae2c4dec3c462269230fc0cf23c250b0e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T03:46:02.030Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"cce1c8982d4021b4bcf17cb689e86172331848e26f3fb849044fa4137c172bfc","protocol":"streamable-http","status":"indexed","toolCount":15,"observedAt":"2026-11-16T03:46:02.030Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"ai.refora/refora":{"url":"https://mcp.refora.ai/mcp"}}},"Cursor":{"mcpServers":{"ai.refora/refora":{"url":"https://mcp.refora.ai/mcp"}}},"VS Code":{"servers":{"ai.refora/refora":{"type":"http","url":"https://mcp.refora.ai/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.refora.ai/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:ai.refora%2Frefora","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/ai.refora%2Frefora","name":"ai.refora/refora","description":"Read-only AI search visibility: brand mentions, competitors and citations in AI answers.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.refora.ai/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://refora.ai/docs/mcp","repositoryUrl":null,"version":"1.0.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"ai.refora/refora","status":"online","lastCheckedAt":"2026-11-20T09:16:55.623Z","lastSuccessfulCheck":"2026-11-20T09:16:55.623Z","latencyMs":169,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T09:16:55.623Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T09:16:55.623Z"},"security":null,"timestamps":{"createdAt":"2026-11-15T20:46:13.841Z","updatedAt":"2026-11-15T20:46:13.841Z","observedAt":"2026-11-20T09:16:55.623Z"},"compatibility":{"serverVersion":"1.0.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}