Developers – MCP server & REST API

The MCP server

Citatio runs a remote MCP server at https://citatio.ai/mcp (streamable HTTP, stateless JSON-RPC). Any MCP client — Claude Desktop, claude.ai, Claude Code, or your own agents — gets direct, citation-first access to our review intelligence. Every quote carries its rating, date, source portal and a link to the original review.

Public tools (no key)

Tool	What it does
`lookup_brand`	Ratings, review counts, per-portal stats, theme sentiment and key findings for any published brand.
`get_cited_quotes`	Verbatim customer quotes (rating, date, source link), optionally filtered by theme.
`compare_brands`	The published "X vs Y" and "best category" comparisons — data-derived winners.

Brand tools (API key required)

Citatio customers receive a per-brand API key. The key is the scope — these tools only ever answer about the brand the key belongs to. Full review text is provided for internal brand use; share publicly via the short excerpts + source links.

Tool	What it does
`ask_brand_reviews`	Free-form questions answered from your brand’s full review knowledge base (RAG over 100% of review text). Grounded summary + matching quotes, each with a share-safe excerpt and the full review text.
`get_brand_reviews`	Browse your reviews in full text — filter by theme, rating, date; paginated (max 50/page).
`get_brand_stats`	All-time statistics: total reviews ever collected, average rating, per-source, per-year trend, per-theme sentiment.
`list_brand_insights`	Index of your weekly stakeholder reports (management, marketing, product, customer service, HR, executive) and evidence digests.
`get_brand_insight`	Any report or digest in full markdown.

Connect Claude

Claude Desktop / claude.ai

Settings → Connectors → Add custom connector
Name: Citatio
URL: https://citatio.ai/mcp/<YOUR-API-KEY> (or plain https://citatio.ai/mcp for public tools only)

Treat the keyed URL as a secret — it carries your credential. Keys are revocable at any time.

Claude Code

claude mcp add --transport http citatio https://citatio.ai/mcp \
  --header "Authorization: Bearer <YOUR-API-KEY>"

REST API v1

The same key works against a plain REST API for non-MCP integrations:

GET https://citatio.ai/api/v1/stats
GET https://citatio.ai/api/v1/reviews?theme=&minRating=&maxRating=&since=&until=&limit=&offset=
GET https://citatio.ai/api/v1/ask?question=...
GET https://citatio.ai/api/v1/insights
GET https://citatio.ai/api/v1/insights/{report|context}/{id}

Header: Authorization: Bearer <YOUR-API-KEY>

Responses are JSON. 401 without a valid key; errors carry an error + hint. The ask endpoint returns a grounded summary plus scored quotes.

Example prompts

"What do our customers complain about most since spring?"
"Summarize what reviewers say about our mobile app."
"Show me our latest executive report."
"Find quotes about delivery problems I can share with the logistics team."

Get a key

Brand API keys are part of the Citatio customer offering. Get your company listed or contact us — hello@citatio.ai.