MCP and agent integrations

Connect a Streamable HTTP client to http://localhost:8000/mcp. Send Authorization: Bearer <operator-token> unless the instance explicitly disables authentication. Keep the endpoint on a trusted host and use HTTPS outside localhost.

Start with list_modems to find the device ID and its available capabilities. The same modem state and activity appear in the browser when an MCP client acts.

Tool What it does
list_modems List modems, capabilities, SIM state, and active calls
list_sms List recent messages. Use the oldest returned ID as before to page back
get_sms Fetch a single message by ID
send_sms Submit an SMS and return the modem’s submission status
unlock_sim Submit a SIM PIN, with an option to remember it after a successful unlock
forget_pin Remove the saved PIN for the current SIM
dial Place a call
answer Answer an incoming call
hangup End the current call
play_audio Play a base64-encoded mono 8 kHz signed PCM16 WAV, up to 30 seconds
stop_audio Stop clip playback
capture_audio Read 1 to 10 seconds of recent caller audio as a base64 WAV
modem_at Issue a single AT command permitted by the server
list_hooks List rules, HTTP destinations, call history, or action runs
save_hook_rule Create or replace a hook rule
save_hook_destination Create or replace an HTTP destination with write-only credentials
delete_hook Delete a rule or destination and cancel its queued actions
preview_hook Dry-run a rule against a saved SMS or call

For call audio, wait until the call is active and check the modem’s audio capability before playing or capturing. If an SMS send returns an unknown result, check the outbox before retrying. See the API reference for audio frames and authentication.

Agent packages

The repository README lists the Claude Code, Codex, and OpenClaw install commands. The Claude Code plugin prompts for the server base URL and token. The OpenClaw bridge reads MODEMBOX_URL and, when needed, MODEMBOX_TOKEN from its environment and appends /mcp to the URL. It sends tool inputs and the bearer token to that endpoint.

The MCP Registry manifest describes the Docker package. The Glama maintainer file identifies the maintainer for a Glama listing.