Unofficial community MCP server for the Spot AI camera and video-intelligence REST API. Read-only.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Capabilities & Tool Schemas (10)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Spot AI MCP.
list_locationsLocations the key can see (paginated)
list_camerasCameras with status, location, IP, MAC (paginated)
get_cameraOne camera by id
get_camera_countNumber of enabled cameras in the org
list_appliancesIntelligent Video Recorders (paginated)
get_zonesZones defined on a camera
Documentation Overview
spot-ai-mcp
Unofficial community MCP server for the Spot AI camera / video-intelligence REST API. Not affiliated with or endorsed by Spot AI.
Single-file, stdio transport, no dependencies beyond Python 3.9+.
Read-only by design: it can browse cameras and intelligence data but can never modify
anything in your Spot AI org. Every tool wraps a GET endpoint except
get_live_stream_urls, which wraps POST /v1/cameras/live — a read-like POST that
only generates a viewing URL. All tools declare the readOnlyHint: true MCP annotation.
Install
or pip install spot-ai-mcp, or run straight from a checkout with
python3 -m spot_ai_mcp (no dependencies to install).
Register with Claude Code:
API key
Create a key in the Spot AI dashboard's API settings, then add an authorization
(a role, e.g. Owner, optionally scoped) on the key's settings page. A key without a
role returns empty lists from every resource endpoint while get_camera_count still
works — that's the tell.
The server resolves the key lazily on the first API call:
SPOT_AI_API_KEYenvironment variable — the normal path.- Optionally, a secret-helper command, so the key never sits in an env var or config:
the server runs
$SPOT_AI_OP_BIN -f $SPOT_AI_OP_ITEM $SPOT_AI_OP_FIELD(defaults1psa -f spot.ai api_key, per 1psa, a vault-scoped 1Password service-account CLI). Point these at any command with the same flag convention.
The key is never written to disk or config by this server.
Tools
| Tool | What it does |
|---|---|
list_locations | Locations the key can see (paginated) |
list_cameras | Cameras with status, location, IP, MAC (paginated) |
get_camera | One camera by id |
get_camera_count | Number of enabled cameras in the org |
list_appliances | Intelligent Video Recorders (paginated) |
get_zones | Zones defined on a camera |
get_intelligence | Counting / idle / presence events for people, vehicles, or forklifts over a date range |
get_lpr_report | License-plate-recognition report for an LPR camera |
get_live_stream_urls | Live-stream viewing URL for up to 4 cameras |
spot_api_get | Escape hatch: GET any documented /v1/ or /v2/ path |
Notes
- Dual-era MCP server: speaks both the modern per-request protocol
(
server/discover, spec 2026-07-28) and the legacyinitializehandshake (2024-11-05 through 2025-06-18), so old and new clients both work. - Base URL is
https://dev-api.spot.ai, auth isAuthorization: Bearer <key>. - Cloudflare in front of the API rejects Python's default user agent with error 1010;
the server sends
User-Agent: spot-ai-mcp/<version>. - Endpoint index: https://developers.spot.ai/llms.txt (append
.mdto any docs URL for markdown, including the OpenAPI definition per endpoint).
License
MIT
Related MCP Servers
Adoption & maintenance
Factual signals from GitHub, npm, and our automated checks — not a rating.
Last commit
8d ago
Most recent push to the default branch.
Tools exposed
10
Callable tools this server registers over MCP.
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Spot AI MCP
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/spot-ai-mcp)HTML Embed
<a href="https://allmcps.com/mcp/spot-ai-mcp"><img src="https://allmcps.com/api/badge/spot-ai-mcp?style=directory" alt="Spot AI MCP on AllMCPs" /></a>