MCP CompatibilityProtocol 2025-06-18OAuth 2.1

CiteMind MCP Compatibility

Connect AI agents to CiteMind's read-only product context, visibility data, and recommendations through OAuth 2.1.

MCP Server URL

https://citemind.com/mcp

Built for AI Agencies

Designed for multi-client delivery, CiteMind gives agency teams a secure, read-only data surface for repeatable reporting workflows and AI automations.

Getting Started

Go Live in 5 Minutes

Connect an MCP-compatible client, approve access once, and start querying your CiteMind data.

Step 1

Add the server URL

Configure https://citemind.com/mcp in your MCP client.

Step 2

Sign in with OAuth

Complete OAuth 2.1 Authorization Code + PKCE and grant mcp:read.

Step 3

Use the tools

Query products, visibility snapshots, context, and recommendations.

1) Connect your MCP client

Use this server URL in your MCP client:

https://citemind.com/mcp

2) Authenticate with OAuth 2.1

CiteMind uses OAuth 2.1 Authorization Code + PKCE. MCP clients should discover the OAuth configuration automatically from the protected-resource metadata and request the mcp:read scope.

Protected resource: https://citemind.com/.well-known/oauth-protected-resource
Authorization server: https://citemind.com/.well-known/oauth-authorization-server
Scope: mcp:read

The authorization server supports dynamic client registration, authorization-code exchange, and refresh tokens. Your client obtains a bearer access token before calling MCP.

3) Discover and call tools

Initialize a session, then send the returned Mcp-Session-Id with subsequent requests.

Initialize

curl -i -X POST https://<your-domain>/mcp \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"initialize",
    "params":{
      "protocolVersion":"2025-06-18",
      "capabilities":{},
      "clientInfo":{"name":"agency-client","version":"1.0.0"}
    }
  }'

List tools

curl -sS -X POST https://<your-domain>/mcp \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -H "Mcp-Session-Id: YOUR_SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

Call a tool

curl -sS -X POST https://<your-domain>/mcp \
  -H "Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN" \
  -H "Mcp-Session-Id: YOUR_SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0",
    "id":3,
    "method":"tools/call",
    "params":{
      "name":"get_visibility_snapshot",
      "arguments":{"product_id":"00000000-0000-0000-0000-000000000000"}
    }
  }'

Available read-only tools

list_products — products available to the agency.
get_product_context — product metadata and analysis context.
get_visibility_snapshot — visibility metrics by LLM and prompt.
list_recommendations — recommendations and their status.

The MCP server is read-only: it cannot create jobs, modify prompts, or change subscription usage.