Skip to content
MCP server

Sempera

MCP server giving AI assistants read access to Sempera phone agents, calls and numbers

Answers · sign-in required (OAuth)

The server answered 3 hours ago with a sign-in request for OAuth (HTTP 401), so we could not list its tools.

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://api.sempera.org/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sempera": {
      "url": "https://api.sempera.org/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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/mcp

Enter 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.

How AIPoweredBot checks servers