MCP Server

The Bota MCP server exposes your project’s data as tools — list devices, inspect recordings, trigger test webhooks, and more — without leaving your IDE. It works for two audiences:

Developer tier — authenticated with your sk_live_* or sk_test_* key. Full project access.
End user tier — authenticated with an eut_* token you issue on behalf of a specific end user. Scoped to their recordings only.

MCP endpoint: https://api.bota.dev/mcp

Developer Setup

Connect with your existing API key. No new credentials needed.

Claude Code
Cursor

claude mcp add --transport http bota https://api.bota.dev/mcp \
  --header "Authorization: Bearer sk_live_..."

In Cursor settings → MCP Servers, add:

{
  "bota": {
    "url": "https://api.bota.dev/mcp",
    "transport": "http",
    "headers": {
      "Authorization": "Bearer sk_live_..."
    }
  }
}

Once connected, you can ask your assistant things like:

“List my devices and show me which ones haven’t synced in 24 hours”
“Get the transcription for recording rec_abc123”
“Trigger a test recording.uploaded event to my webhook”

Developer Tier Tools

Tool	Description
`list_end_users`	List end users with optional filters
`get_end_user`	Get a single end user by Bota ID or external_id
`list_devices`	List devices, optionally filtered by end user
`get_device`	Get device details including battery, connectivity, and last heartbeat
`get_fleet_stats`	Fleet health summary: device counts by status and battery level
`list_recordings`	List recordings across all end users with status/device filters
`get_recording`	Recording metadata + transcription + summary in one call
`create_transcription`	Trigger ASR transcription for an uploaded recording
`create_summary`	Generate a summary from a transcription using a template or custom prompt
`list_webhooks`	List registered webhook endpoints
`trigger_webhook_event`	Fire a test event to a registered webhook endpoint

End User Tokens

You can give an end user a scoped MCP token so they can query their own recordings with an AI assistant. The token is tied to a specific end_user_id and cannot access any other user’s data.

Issue a token

curl -X POST https://api.bota.dev/v1/end-users/eu_abc123/user-token \
  -H "Authorization: Bearer sk_live_..."

{
  "token": "eut_...",
  "key_hint": "eut_...xxxx",
  "end_user_id": "eu_abc123",
  "connection_command": "claude mcp add --transport http bota https://api.bota.dev/mcp --header \"Authorization: Bearer eut_...\"",
  "created_at": "2026-01-15T10:00:00Z"
}

The token is shown only once. Copy the connection_command and send it to your end user. Issuing a new token automatically revokes any previous token for that end user.

Revoke a token

curl -X DELETE https://api.bota.dev/v1/end-users/eu_abc123/user-token \
  -H "Authorization: Bearer sk_live_..."

End User Tier Tools

Once connected with an eut_* token, the end user can query their own data:

Tool	Description
`list_my_recordings`	Their recordings — filter by status
`get_my_recording`	Single recording with transcription and summary
`get_my_transcription`	Full transcript with speaker labels and timestamps
`get_my_summary`	AI-generated summary for a recording
`get_download_url`	Presigned S3 URL to download the audio file (expires in 15 minutes)
`list_my_devices`	Devices assigned to this end user

No admin operations. No access to other end users’ data.

Docs Search MCP

A separate Mintlify-hosted MCP server is available for searching Bota documentation:

claude mcp add --transport sse bota-docs https://docs.bota.dev/mcp

This exposes search_bota — useful when you want an AI assistant to look up Bota API details on demand.

Getting Started

Features

Hardware

Webhooks

Legal & Compliance

Developer Setup

Developer Tier Tools

End User Tokens

Issue a token

Revoke a token

End User Tier Tools

Docs Search MCP

​Developer Setup

​Developer Tier Tools

​End User Tokens

​Issue a token

​Revoke a token

​End User Tier Tools

​Docs Search MCP

Developer Setup

Developer Tier Tools

End User Tokens

Issue a token

Revoke a token

End User Tier Tools

Docs Search MCP