# Citare MCP Server

> AI search intelligence + full Ahrefs-class SEO suite, exposed as 59 MCP tools.

[Citare](https://www.citare.ai) is the only AI search intelligence platform that ships a full SEO suite (Site Explorer, Keywords Explorer, Rank Tracker, Site Audit, Content Explorer, Bot Analytics, Web Analytics, GSC Insights) at every paid tier. The MCP server exposes all 59 product operations to Claude Desktop, Claude Code, Cursor, ChatGPT, and any other MCP-compatible client.

**This repository is documentation only.** The MCP server is hosted at [https://www.citare.ai/mcp](https://www.citare.ai/mcp). The implementation is closed-source and runs on Cloudflare Workers via OpenNext.

---

## What you can do with it

- **Brand Radar dispatches** — track your brand across all 5 AI search engines (ChatGPT, Google AI Overview, Gemini, Claude, Perplexity) with persona-anchored 50-cell weekly cells
- **SERP overview** — live top-10 with per-URL authority for any keyword × country
- **Backlinks** — referring domains, anchor distribution, broken backlinks, domain rating, URL rating
- **Keyword research** — volume, KD, CPC, related terms, search-suggestion mining, country-by-country breakdowns
- **Rank tracking** — historical positions for your tracked keywords + competitor pages
- **Site audit** — page-by-page crawl issues, structured data validation, AI-bot allowlist checks
- **GSC Insights** — pull Google Search Console data for any verified property
- **Web Analytics** — first-party cookieless traffic, top pages, referrers, device breakdowns

The full operation catalog is generated from [the OpenAPI spec](https://www.citare.ai/openapi.json) — same surface as the REST API.

---

## Install

### Smithery (recommended)

The fastest path. Smithery handles auth prompting and per-client config:

```bash
npx -y @smithery/cli install @ravirdp/citare --client claude
# replace --client with cursor / chatgpt / windsurf / cline as needed
```

Smithery listing: [smithery.ai/server/@ravirdp/citare](https://smithery.ai/server/@ravirdp/citare)

### Manual — Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "citare": {
      "transport": {
        "type": "streamable-http",
        "url": "https://www.citare.ai/mcp"
      },
      "headers": {
        "Authorization": "Bearer YOUR_CITARE_API_KEY"
      }
    }
  }
}
```

Get a Citare API key at `https://www.citare.ai/app/<your-project>/settings/api-keys` (Pro tier or higher includes MCP access).

### Manual — Claude Code

```bash
claude mcp add citare --transport http https://www.citare.ai/mcp \
  --header "Authorization: Bearer YOUR_CITARE_API_KEY"
```

### Manual — Cursor

```jsonc
// .cursor/mcp.json
{
  "mcpServers": {
    "citare": {
      "url": "https://www.citare.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_CITARE_API_KEY" }
    }
  }
}
```

Per-client install pages with copy buttons: [https://www.citare.ai/mcp/install/claude](https://www.citare.ai/mcp/install/claude) (also `/cursor`, `/chatgpt`, `/windsurf`, `/cline`).

---

## Auth

Bearer token, generated in your Citare dashboard. The token is scoped per project and rate-limited per tier. The MCP server accepts both `Authorization: Bearer cit_api_…` (REST-native) and `Authorization: cit_api_…` (naked, used by some MCP gateways like Smithery).

MCP access is included from the Pro tier ($119/mo or ₹9,999/mo). Free + Pulse tiers can use the REST API directly without the MCP transport layer.

---

## Pricing

| Tier | USD | INR | MCP access |
|---|---|---|---|
| Free | $0 | ₹0 | REST only |
| Pulse | $35/mo | ₹2,999/mo | REST only |
| **Pro** | **$119/mo** | **₹9,999/mo** | **MCP + REST** |
| Agency | $299/mo | ₹24,999/mo | MCP + REST + white-label |
| Enterprise | from $1,200/mo | from ₹99,999/mo | MCP + REST + SSO + custom retention |

Full pricing: [https://www.citare.ai/pricing](https://www.citare.ai/pricing).

---

## Transport

Streamable HTTP. Endpoint: `https://www.citare.ai/mcp`.

The server speaks JSON-RPC 2.0 over POST. Methods implemented:

- `initialize`
- `tools/list` — returns all 59 tools
- `tools/call` — dispatches to the underlying REST operation with the same auth context

Methods not implemented (return `-32601 Method not found`):

- `resources/list` — Citare has no resource-style entities to expose; tool calls cover the full surface
- `prompts/list` — no server-side prompt templates; clients pick their own

---

## Support

- Product: [https://www.citare.ai](https://www.citare.ai)
- Docs landing: [https://www.citare.ai/mcp-server](https://www.citare.ai/mcp-server)
- API docs: [https://www.citare.ai/api](https://www.citare.ai/api)
- Contact: [https://www.citare.ai/contact](https://www.citare.ai/contact)
- Founder: [@ravirdp](https://www.linkedin.com/in/ravirdp) · [rikuq.com](https://rikuq.com)

---

## License

This documentation is MIT-licensed. The Citare hosted service is governed by [the Citare Terms of Service](https://www.citare.ai/terms).