How do I use SightRadar MCP Server?

This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions: * SightRadar

SightRadar MCP Server

Official

by sightradar-hq

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

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

	Remote (hosted)	Local (this package)
URL / command	`https://mcp.sightradar.com/mcp`	`npx -y sightradar-mcp`
Sign-in	SightRadar account (email + password, Google or email link), or an API key as a Bearer token	`SIGHTRADAR_API_KEY`
Install	Nothing	Node.js 20+
Images from your computer	No (URLs or base64)	Yes, `file_path`

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: <app name>.

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" }
    }
  }
}

Related MCP server: io.github.Dongwu259/photo-s

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

Variable	Default
`SIGHTRADAR_API_KEY`	(required)	API key
`SIGHTRADAR_SCOPES`	`read,search,write,delete`	Which tool groups to expose. `all` adds `account`; `read` gives a read-only server.
`SIGHTRADAR_FILE_ROOTS`	your home folder	Folders `file_path` may read (separated by `:` on macOS/Linux, `;` on Windows). `none` turns `file_path` off.
`SIGHTRADAR_BASE_URL`	`https://api.sightradar.com`	API base URL
`SIGHTRADAR_TIMEOUT_MS`	`120000`	Per-request timeout
`SIGHTRADAR_DEBUG`	unset	Log each tool call (no arguments or results) to stderr

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

Tool
`list_collections`	Collections with photo, face and selfie counts; search and paging
`get_collection`	One collection's status and counts (`verify` recounts from the vector store)
`get_deletion_status`	Progress of a collection deletion
`list_batches` / `get_batch` / `get_batch_photos`	Batch jobs, status (one or up to 5000 at once) and per-photo results
`list_webhooks` / `list_webhook_failures`	Webhook endpoints and dead-lettered deliveries
`get_balance` / `get_usage`	Credit balance; usage summary, daily series or storage

search — spends credits, stores nothing

Tool	Credits
`search_faces`	93	Find every photo in a collection containing the person in a selfie (or an embedding)
`search_by_point_id`	62	Repeat a registered selfie's search without re-sending it
`detect_faces`	93	Faces, bounding boxes and quality in an image
`compare_faces`	93 per image	Are two faces the same person?

write — spends credits / stores data

Tool	Credits
`index_photo`	93	Store a photo's faces in a collection
`register_selfie`	93	Store a person's selfie; returns its point id and embedding
`submit_batch`	62 per photo	Up to 1000 photo URLs, index or match, processed in the background
`requeue_failed_batch_photos`	62 per photo	Retry failed batch photos (preview, then execute)
`create_collection` / `recreate_collection`	free
`create_webhook` / `replay_webhook_failures`	free	Signed deliveries for batch and deletion events

delete — free

Tool
`delete_collection`	Soft delete with a 7-day restore window by default; `immediate` or `compliance` erase permanently
`restore_collection`	Undo a soft delete
`delete_photo` / `restore_photo`	Remove or restore one photo's faces
`delete_webhook`	Stop deliveries to an endpoint

account — free, off by default on the local server

Tool
`list_api_keys` / `create_api_key` / `revoke_api_key`	API keys
`get_profile` / `update_profile`	Name and organization
`get_billing_settings` / `update_auto_recharge` / `get_invoice`	Auto-recharge, orders and invoice PDFs
`get_notification_settings` / `update_notification_settings` / `manage_notification_recipient`	Email alerts and extra recipients
`list_team_members`	Organization members

Prompts and resources

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

Prompt	What it does
`find_person_in_event`	Checks the balance, searches a collection with a selfie and lists the matching photos
`index_event_photos`	Picks `index_photo` or `submit_batch` by photo count and states the cost before starting
`account_health`	Balance, recent usage, failed batch photos and failed webhook deliveries

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

You see	Meaning
`401` / `unauthorized`	The API key was revoked or mistyped. Create a new one at sightradar.com/dashboard/keys; remote connections: reconnect.
`402` / `insufficient_credits`	Top up at sightradar.com/dashboard/billing.
`409` / `duplicate_request_already_processed`	That `idempotency_key` was already used and charged; the earlier call succeeded.
`file_path ... is outside the folders this server may read`	Add the folder to `SIGHTRADAR_FILE_ROOTS` (`:`-separated on macOS/Linux, `;` on Windows).
`429`	Over 50 requests/s per key or 10 in flight per account. Wait and retry.

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Related MCP Connectors

mcpgatewaydesk-mcp
com.clauxel.mcpgatewaydesk
A paid remote MCP for AI SDK MCP gateway registry, built to return verdicts, receipts, usage logs, a
Observability Payments & Billing Developer Tools
2
https://mcpgatewaydesk.clauxel.com/mcp
Zyla API Hub A
com.zylalabs
Discover and call 10,000+ production APIs from one MCP server. Pay-per-call billing for AI agents.
Developer Tools
82
https://mcp.zylalabs.com/mcp
coralquery-mcp
com.clauxel.coralquery
A paid remote MCP for AI SDK data query MCP, built to return verdicts, receipts, usage logs, and aud
Observability AI & Machine Learning Payments & Billing
2
https://coralquery.clauxel.com/mcp
SandBase
io.github.sandbaseai
Connect MCP clients to 2,000+ AI models without managing provider API keys.
AI & Machine Learning Agent Orchestration
1185
https://sandbase.ai/v1/mcp

Related MCP Servers

QCall AI MCP Server
AI & Machine Learning Speech Processing Communication
kapilkarda
A
license
B
quality
B
maintenance
Enables MCP clients to manage AI voice assistants, place calls, run campaigns, handle contacts and knowledge bases, and read call transcripts. It also provides account, phone number, dialer, and analytics tools through a hosted or local MCP connection.
Updated 5 days ago (2026-10-28 09:11 UTC)
25
MIT
io.github.Dongwu259/photo-s
Image & Video Processing Multimedia Processing AI & Machine Learning
Dongwu259
A
license
Not graded
quality
A
maintenance
Enables AI agents to run cross-platform batch photo-processing workflows—including RAW decoding, adjustments, noise reduction, white balance, LOG restoration, EXIF tagging, deduplication, selection, HTML galleries, folder watching, and presets—through a unified versioned JSON contract. It also exposes MCP tools for processing, suggestions, autopilot, indexing, search, selection, HDR, face blurring, and more.
Updated 2 months ago (2026-09-18 00:04 UTC)
MIT
SandBase CLI
AI & Machine Learning Agent Orchestration Search
Naoki921
A
license
Not graded
quality
A
maintenance
Enables AI clients to discover, inspect, and run 2,000+ AI models and APIs through MCP, with free data APIs, OAuth sign-in, and rollback.
Updated 16 days ago (2026-10-17 07:09 UTC)
556,724 npm
MIT
SandBase CLI
AI & Machine Learning Search Web Scraping
Hashimoto815
A
license
Not graded
quality
A
maintenance
Enables AI clients to discover, inspect, and run over 2,000 AI models and APIs through local MCP tools, with free data API calls and browser-based authorization. It supports workflows such as search, social media, scraping, e-commerce, finance, image/video/audio generation, and run/account management.
Updated 16 days ago (2026-10-17 07:17 UTC)
556,724 npm
MIT