Sempera
MCP server giving AI assistants read access to Sempera phone agents, calls and numbers
The server answered 3 hours ago with a sign-in request for OAuth (HTTP 401), so we could not list its tools.
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally or Remotely
- Access
- Needs sign-in (OAuth)
- Version
- 0.1.1
- Listing updated
- today
Similar MCP servers
About Sempera
Sempera is an open-source MCP server for communication. It can run locally on your machine or as a hosted remote server.
The README describes this as a local stdio MCP server that wraps the Sempera public API, so an assistant such as Claude Desktop, Cursor or VS Code can inspect AI phone agents, their calls, conversations and phone numbers. It runs on your machine through npx and authenticates with a workspace API key, which can also be saved by the Sempera CLI.
By default every tool is read-only. Outbound calling and texting are kept behind a flag: the server only offers send_call and send_sms when started with --allow-writes or SEMPERA_MCP_ALLOW_WRITES=1, and the README notes that the API still enforces calling hours, opt-outs and caps.
The package is aimed at developers and operators who already run Sempera agents and want to query them from an AI assistant. The docs also list a hosted MCP endpoint at api.sempera.org for clients that connect over HTTP, which exposes a different tool set governed by OAuth scopes.
Install
Run in a terminal
claude mcp add --transport http sempera https://api.sempera.org/v1/mcpAdd to Settings → Connectors → Add custom connector
https://api.sempera.org/v1/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"sempera": {
"url": "https://api.sempera.org/v1/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"sempera": {
"type": "http",
"url": "https://api.sempera.org/v1/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"sempera": {
"serverUrl": "https://api.sempera.org/v1/mcp"
}
}
}Add to Grok Bot desktop app → Connect apps → Add a custom connector
https://api.sempera.org/v1/mcpEnter a Name (for example "Sempera"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.
Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"sempera": {
"type": "http",
"url": "https://api.sempera.org/v1/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
SEMPERA_API_KEYWorkspace API key. If unset, the server uses a key saved by sempera login on this machine.SEMPERA_MCP_ALLOW_WRITESSet to 1 to also offer send_call and send_sms. Off unless set. Those tools reach a real person.SEMPERA_BASE_URLAPI base URL. Defaults to https://api.sempera.org.
Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- get_credential
- Returns the key's workspace, role and scopes.
- list_agents
- Lists agents with status and published version.
- get_agent
- Returns one agent in full.
- list_calls
- Lists one agent's phone calls, newest first.
- get_call
- Returns one call, with its transcript when available.
- list_conversations
- Lists one agent's conversations on every channel.
- get_conversation
- Returns one conversation with its transcript.
- list_phone_numbers
- Lists numbers bound to one agent.
- list_sms_numbers
- Lists numbers that can send texts.
- verify_webhook_signature
- Checks an X-Sempera-Signature header against a body and secret locally.
- send_call
- Places one outbound phone call (write tool, opt-in).
- send_sms
- Sends one text message (write tool, opt-in).
What it does
- Read-only agent access
- Lists agents, calls, conversations and phone numbers without changing anything.
- Opt-in outbound messaging
- Placing calls and sending texts is disabled until the write flag is set.
- Webhook signature check
- Verifies an X-Sempera-Signature header against a body and secret locally.
- Saved or environment credentials
- Uses SEMPERA_API_KEY or a key stored by sempera login.
- Hosted HTTP alternative
- A streamable HTTP endpoint is available for clients that do not run local servers.
Good for
- Asking an assistant to summarise recent calls handled by a phone agent
- Checking which phone numbers are bound to a given agent
- Reviewing conversation transcripts across channels from a coding assistant
- Verifying webhook signatures while debugging an integration
Pricing
Open source
MIT-licensed local server; Sempera phone features require a plan.
Prices change. Check docs.sempera.org before you buy.
Sempera FAQ
Which tools can change data?
Only send_call and send_sms, and only when the server is started with --allow-writes or SEMPERA_MCP_ALLOW_WRITES=1. All other tools are read-only.
What license is the server under?
The README states the package is MIT licensed.
Do I need a plan to use the phone tools?
The hosted endpoint's phone tools need a Sempera Phone plan, according to the README.
Is Sempera free?
Yes. Sempera is open source, so you can use and self-host it for free.
How do I add Sempera to Claude Code?
Run this command in your terminal: claude mcp add --transport http sempera https://api.sempera.org/v1/mcp
What are the best alternatives to Sempera?
The closest alternatives to Sempera are Siel, imsg-mcp, Carrier, Photon and CallMCP — Phone Call MCP Server.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.