MCP server

The Model Context Protocol (MCP) is an open standard that lets AI clients call external tools. CiteHawk ships an MCP server so you can connect your own AI and ask it about your visibility in plain English — it reads your live data, you never export a thing.

Endpoint

The server speaks streamable HTTP at:

https://www.citehawk.com/api/mcp

Authenticate with the same workspace API key used everywhere else, passed as a Bearer token. Generate one in Settings > API Keys. Every tool is read-only and scoped to the workspace the key belongs to.

Claude Code (CLI)

Add the server with one command:

claude mcp add --transport http citehawk https://www.citehawk.com/api/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Then ask Claude anything about your visibility. For the agentic find-fix-measure loop, see the Claude Code skill.

claude.ai and Claude Desktop

Add a custom connector in your Claude settings pointing at https://www.citehawk.com/api/mcp, and set the Authorization: Bearer YOUR_KEY header. Claude will list the CiteHawk tools once connected.

Cursor and other MCP clients

Any client that supports a streamable HTTP MCP server works. Point it at the same endpoint with the same Authorization header. In Cursor, add it under Settings > MCP as an HTTP server.

Available tools

Six read-only tools cover the whole picture:

Tool	Returns	Example prompt
get_visibility_summary	Latest Visibility and Brand Health scores, sub-scores, KPIs, and which AI engines currently cite you	“How is my AI visibility trending?”
get_rankings	Competitor share-of-voice leaderboard for your category	“Who is beating me in AI answers right now?”
get_prompt_performance	Your best and worst prompts by mention rate	“Which prompts am I losing on?”
list_recommendations	Your current recommendations with priority, impact, and effort	“What should I fix first to get cited more?”
get_source_gaps	Cited sources where competitors are listed and you are not	“Which directories cite my competitors but not me?”
get_evidence	Real AI answers (provider, prompt, excerpt, cited URL, date) citing a domain	“Show me the actual AI answers citing my site.”

A missing or invalid key returns 401 Unauthorized. Prefer raw HTTP? Use the REST API instead.