SightRadar

SightRadar MCP Server

Face recognition for AI assistants. Index event photos, find every photo a person appears in from one selfie, run batches, manage webhooks and billing, all from Claude, ChatGPT, Cursor, VS Code or any MCP client.

There are two ways to connect. Both expose the same tools.

Remote server (recommended)

Add https://mcp.sightradar.com/mcp as a custom connector. On first use your browser opens sightradar.com, you sign in and choose what the assistant may do. Each connection gets its own revocable key, listed under API keys as MCP: .

• Claude (claude.ai, Desktop): Settings → Connectors → Add custom connector → paste the URL.
• ChatGPT: Settings → Apps & Connectors → Create → paste the URL, authentication OAuth.
• Claude Code: claude mcp add --transport http sightradar https://mcp.sightradar.com/mcp
• Cursor (~/.cursor/mcp.json) / VS Code (.vscode/mcp.json, key servers):

  { "mcpServers": { "sightradar": { "url": "https://mcp.sightradar.com/mcp" } } }

Prefer an API key? Send it as a header instead of signing in:

{

"mcpServers": { "sightradar": { "url": "https://mcp.sightradar.com/mcp", "headers": { "Authorization": "Bearer frs_your_key" } } } }

Local server

Create an API key at sightradar.com/dashboard/keys, then:

{

"mcpServers": { "sightradar": { "command": "npx", "args": ["-y", "sightradar-mcp"], "env": { "SIGHTRADAR_API_KEY": "frs_your_key" } } } }

That block works in Claude Desktop (claude_desktop_config.json), Cursor, Windsurf, Cline and most clients. Claude Code:

claude mcp add sightradar --env SIGHTRADAR_API_KEY=frs_your_key -- npx -y sightradar-mcp

Tools

Credits: 100,000 credits = US$1. Every billable tool states its price in its description, and accepts an idempotency_key so a retry is never charged twice.

read — free

search — spends credits, stores nothing

write — spends credits / stores data

delete — free

account — free, off by default on the local server

Prompts and resources

Clients that show MCP prompts (Claude's "+" menu, / commands) get three ready-made workflows:

Resources: sightradar://docs/pricing-and-limits (credits per operation, rate limits, image and deletion limits) and sightradar://collections/{collection_id} (one collection's counts, needs the read scope).

Images

Image tools take exactly one of:

• image_url: a public http(s) URL. SightRadar downloads it, so it must be reachable from the internet.
• gcs_key: an object key on the CDN configured for your account.
• image_base64: the bytes as base64 or a data: URL. The remote server accepts up to 10 MB; the local server up to 30 MB.
• file_path (local server only): a JPEG, PNG, WebP, GIF, BMP, TIFF or HEIC file inside SIGHTRADAR_FILE_ROOTS.

Files and base64 data are checked to be real images before anything is uploaded.

Example prompts

• "Create a collection called wedding-2026-10 and index every photo in ~/Pictures/wedding."
• "Here is a selfie of Priya: which photos in wedding-2026-10 is she in?"
• "Submit these 600 photo URLs as a batch into marathon-7 and tell me when it's done."
• "How many credits did I spend this week, and on what?"
• "Delete the test-event collection." (The assistant confirms first, and the delete can be undone for 7 days.)

Safety

• Tools carry MCP annotations (readOnlyHint, destructiveHint), so clients can ask before destructive calls.
• Deletes are soft by default. Permanent erasure needs immediate or compliance to be set explicitly.
• Scopes limit what a connection can do. A read-only connection cannot spend credits or change data.
• The local server reads files only inside SIGHTRADAR_FILE_ROOTS, after resolving symlinks, and only image files.
• API errors come back as tool results with the error code, a hint and the request id, never as stack traces.

Troubleshooting

Development

npm install

npm test # unit tests against a mocked API npm run build SIGHTRADAR_API_KEY=frs_... node scripts/smoke.mjs # free live calls over stdio

createSightRadarServer({ api, scopes }) and TOOLS are exported for embedding the same tools in another host.

Links

• SightRadar · API docs · Pricing
• Node.js SDK: sightradar on npm · Python SDK: sightradar on PyPI

MIT licensed.