# Sempera

> Sempera is an open-source MCP server for communication. MCP server giving AI assistants read access to Sempera phone agents, calls and numbers. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted, vscode, macOS, Windows, Linux
- **Website:** https://docs.sempera.org
- **Repository:** https://github.com/sempera-ai/sempera-mcp
- **MCP Registry name:** io.github.Sempera-AI/sempera
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-19

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http sempera https://api.sempera.org/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.sempera.org/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sempera": {
      "url": "https://api.sempera.org/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "sempera": {
      "type": "http",
      "url": "https://api.sempera.org/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "sempera": {
      "serverUrl": "https://api.sempera.org/v1/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "sempera": {
      "type": "http",
      "url": "https://api.sempera.org/v1/mcp"
    }
  }
}
```

## Tools

- `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).

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

## Alternatives

- [Siel](https://ai-powered.com/mcp/siel): Siel is an MCP server for communication.
- [imsg-mcp](https://ai-powered.com/mcp/imsg-mcp): imsg-mcp is an open-source MCP server for communication.
- [Carrier](https://ai-powered.com/mcp/carrier): Carrier is a freemium MCP server for communication.
- [Photon](https://ai-powered.com/mcp/photon-2): Photon is an MCP server for communication.
- [CallMCP — Phone Call MCP Server](https://ai-powered.com/mcp/callmcp-phone-call-mcp-server): CallMCP — Phone Call MCP Server is a paid MCP server for communication.
- [Callsign](https://ai-powered.com/mcp/callsign): Callsign is an open-source MCP server for communication.
- [Vemudo](https://ai-powered.com/mcp/vemudo): Vemudo is an MCP server for communication.
- [Secure Telegram](https://ai-powered.com/mcp/secure-telegram): Secure Telegram is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/sempera
