MCP server

Ask your AI app about your fleet.

Connect Claude or any app that supports MCP to Castum. Check devices, read logs, enroll a device or send an app update by asking in plain language.

Connector URL

https://castum.co/mcp
  1. In your app, add a custom connector and paste the URL.
  2. Sign in to Castum and pick the account to connect.
  3. Choose Read only, or Read and manage if the app should make changes. Then press Allow.

Disconnect any time under Profile, Connected apps, in the client portal.

Commands you can use

Read

fleet_summary
Device counts: total, online, offline, failed installs and installs waiting for a device.
list_devices
Find devices by name, location, group, online or offline, or install status.
get_device
One device in detail: hardware, agent version, installed apps and recent install results.
list_locations_and_groups
Locations and groups, with how many devices are in each.
list_logs
Recent fleet events, filtered by severity, source, device, location, group or time.
get_log_event
One event and the other events from the same action.
list_apps
Your apps and their uploaded releases.
list_deployments
Recent deployments and how many devices installed, are waiting or failed.
get_deployment
One deployment with the status and any error for each device.
list_incidents
Outages and repeated install failures, open and recovered.
get_incident
One incident with affected devices and recent events.
preview_deployment
Dry run: how many devices a deployment would reach and which would be skipped.

Make changes

Needs Read and manage access and the User or Admin role.

create_enrollment
Makes a one-time enrollment QR for a location. It expires in 15 minutes and uses a free device slot when a device joins.
update_device
Rename a device, move it to another location, change its groups or kiosk profile.
set_group_membership
Add devices to a group or remove them, in bulk.
submit_deployment
Sends an app release to devices. Needs a fresh preview and the device count, and never sends twice for the same request.
update_device_app
Updates one app on one device to the newest release.
retry_commands
Retries failed installs.

Things to try

  • “How many devices are online in Castum?”
  • “Which devices have failed installs, and what were the errors?”
  • “Show error logs from the last 24 hours for Store 12.”
  • “Preview sending Honeybee 3.1 to the Store 12 group.”
  • “Create an enrollment QR for a new location called Store 40.”

Permissions and safety

  • The app can never do more than you can. Your role in the account is checked on every request, so changes to your role apply right away.
  • Deleting or retiring devices, billing and team members are not available to connected apps.
  • Deployments need a preview first, and the device count must match before anything is sent.
  • Every request is recorded in your audit log, and changes show as your name via the app.
  • Device names and log text are treated as data, never as instructions.