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: only GET endpoints are exposed, so it can browse cameras and intelligence data but can never modify anything in your Spot AI org.

Install

uvx spot-ai-mcp

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:

claude mcp add spot-ai -s user -e SPOT_AI_API_KEY=YOUR_KEY -- uvx spot-ai-mcp

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:

  1. SPOT_AI_API_KEY environment variable — the normal path.
  2. 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 (defaults 1psa -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
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 legacy initialize handshake (2024-11-05 through 2025-06-18), so old and new clients both work.
  • Base URL is https://dev-api.spot.ai, auth is Authorization: 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 .md to any docs URL for markdown, including the OpenAPI definition per endpoint).

License

MIT

Project links

Data verified by PyPI on Aug 28, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for phil-bryant from gravatar.com phil-bryant

Credits

Author: Phil Bryant

GitHub Statistics

Data verified by PyPI on Aug 28, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.9

Tags

cameras mcp model-context-protocol spot-ai video-intelligence

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

spot_ai_mcp-0.2.0.tar.gz (7.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

spot_ai_mcp-0.2.0-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

Details for the file spot_ai_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: spot_ai_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 7.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for spot_ai_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 a62e88079d092512742a1b100375c38bea3f88274d68681edb7744ac6018eaa0
MD5 b40e780c58325f8f668ef026f11f0966
BLAKE2b-256 df38105e209f69f8abbd30b365774a70f346264e8966e7371de3ea6c10192f88

See more details on using hashes here.

Provenance

The following attestation bundles were made for spot_ai_mcp-0.2.0.tar.gz:

Publisher: publish.yml on phil-bryant/spot-ai-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file spot_ai_mcp-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: spot_ai_mcp-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 7.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for spot_ai_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3b530e0643f069e3779dcf78a0107bc8f006de8a412006b633e7619ca07e3400
MD5 228625d499ae41561f2bb57f2118b91f
BLAKE2b-256 c11fee540804507e5755e76855b486724f904fb9d54a3eb7ffd2f31a13991252

See more details on using hashes here.

Provenance

The following attestation bundles were made for spot_ai_mcp-0.2.0-py3-none-any.whl:

Publisher: publish.yml on phil-bryant/spot-ai-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page