Docs

What is MCP?

MCP (Model Context Protocol) lets you connect Knowatoa directly to AI assistants like Claude, ChatGPT, Codex, OpenCode, and Antigravity. Once connected, you can ask your AI assistant questions about your AI search visibility data using natural language.

No API keys needed – you sign in with your regular Knowatoa account through your browser.

What you can do

Account & Site Management

  • List Accounts – see all accounts you belong to
  • List Sites – list the sites you’re monitoring (returns the site ID needed for everything else)
  • Create Site – create a new site, including its brand-name variations
  • Update Site – change a site’s name, URL, or brand words
  • Add Competitor – add a competitor to track, with its brand-name variations
  • Update Competitor – change a competitor’s name, URL, or brand words

Analytics & Insights

All analytical methods support historical date ranges and period-over-period comparisons. Ask questions like “How did my mention rate change from last month?” or “Which citations increased this quarter?” Every metric returns current value, previous value, absolute change, and percentage change. Learn more about period comparisons →

  • Get Questions – see which AI services mention your brand and their sentiment
  • Get Rankings – see where you rank in each AI service’s responses, with citations
  • Get Sentiment – sentiment analysis per AI service with period-over-period changes
  • Get Competitor Sentiment – compare sentiment across your brand and competitors over time
  • Get Citations – see which websites AI services cite, with change tracking across periods
  • Get Visibility – appearance rates across AI services with historical comparisons
  • Get Competitors – competitor visibility analysis with brand words and period metrics
  • Get Series Performance – compare AI service performance (ChatGPT, Perplexity, etc.) across periods
  • Get Question Performance – track which questions gained or lost mentions over time
  • Get Negative Mentions – identify and track negative sentiment over time

Question Management

  • Add Question – add a new question to track across AI services (with optional country/language)
  • Add Questions – add up to 100 questions at once, with a status for each
  • Update Question – toggle tracking on/off, add/remove tags
  • Delete Question – permanently remove a question and all its AI response data

Article Management

  • List Articles – list articles for a site, filter by draft or published
  • Get Article – get full article content including body and SEO fields
  • Update Article – edit title, body, excerpt, or SEO metadata (draft articles only)
  • Publish Article – publish a draft article
  • Unpublish Article – revert a published article to draft so it can be edited

The typical workflow is: List Accounts, then List Sites, then use the site ID to query any of the analytics or manage questions.

Getting started

Choose your AI assistant to get setup instructions:

Setup takes less than a minute for most clients.