CitedSpy MCP Server

## Prerequisites - CitedSpy Growth or Pro plan with API access - A CitedSpy API key (`cspy_...`) - An MCP-compatible client (Claude, Cursor, Codex, Gemini CLI, etc.) ## 1. Create an API key 1. Log in to https://app.citedspy.com 2. Go to **Settings → API Keys** 3. Click **New API Key**, name it (e.g. "Claude MCP"), and copy the key 4. Keep the full `cspy_...` value; it is only shown once ## 2. Connect your AI tool All clients use the same MCP server URL: `https://mcp.citedspy.com/mcp`. ### Claude Code (CLI) ```bash claude mcp add --transport http citedspy https://mcp.citedspy.com/mcp ``` Then start Claude Code, run `/mcp`, choose **citedspy**, and authorize. ### Claude Desktop 1. Open **Settings → Connectors → Add custom connector** 2. Name it **CitedSpy** 3. Paste `https://mcp.citedspy.com/mcp` as the URL 4. Click **Add**, then **Connect** to authorize ### Cursor Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project): ```json { "mcpServers": { "citedspy": { "url": "https://mcp.citedspy.com/mcp" } } } ``` The first time you use the server, Cursor opens your browser to complete authorization. ### Codex Enable the remote MCP client and configure the server: ```toml [features] experimental_use_rmcp_client = true [mcp_servers.citedspy] url = "https://mcp.citedspy.com/mcp" ``` Then run: ```bash codex mcp login citedspy ``` ### Gemini CLI ```bash gemini mcp add --transport http citedspy https://mcp.citedspy.com/mcp ``` If your version doesn’t support `mcp add`, add this to `~/.gemini/settings.json`: ```json { "mcpServers": { "citedspy": { "httpUrl": "https://mcp.citedspy.com/mcp" } } } ``` ### Other MCP clients For any client that supports remote (streamable HTTP) MCP servers, add a new server with: ```text https://mcp.citedspy.com/mcp ``` and complete the one-time browser authorization. ## 3. Authorize CitedSpy When you connect for the first time, your client opens a CitedSpy authorization page. Paste your API key, confirm, and return to the client. CitedSpy validates the key and never exposes it to the AI tool. ## Example prompts - List all the brands in my CitedSpy workspace. - Show the visibility dashboard for my main brand over the last 30 days. - Create a comparison prompt for my brand against its top two competitors, then trigger a run.