# Rymi

> Rymi is an MCP server for communication. Create, edit, test and publish AI voice agents that make real phone calls from chat. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** API, CLI
- **Website:** https://docs.rymi.live/api/mcp
- **Repository:** https://github.com/rymi-live/rymi-mcp
- **MCP Registry name:** io.github.rymi-live/rymi-mcp
- **Categories:** [communication](https://ai-powered.com/categories/communication), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Rymi's server sits in front of your Rymi account, so an assistant can build and run phone voice agents without the dashboard. Tool groups cover agents (create, clone, update, validate a publish, preview the stack, publish), agent tools and secrets, share links, discovery of LLM and voice options, knowledge sources with change history and undo, evals, usage summaries in minutes, and read-only call listings.

There are two ways to run it. The hosted endpoint at mcp.rymi.live/mcp uses OAuth sign-in or a secret key and filters tools by your role. The npm package @rymi/mcp runs locally over stdio with a RYMI_API_KEY and exposes the full write surface by default, so setting RYMI_MCP_READONLY=1 hides every mutating tool such as create_call, batch_call and publish_agent.

Signing in grants the connector everything you can do in Rymi, including placing calls that spend credits and, for owners or admins, billing and API keys. A workspace argument lets one connection act across several workspaces, for example an agency's client accounts.

## Features

- **Agent lifecycle:** Create, clone, update, validate and publish voice agents from chat.
- **Call tools:** List calls and active calls, with create_call and batch_call for placing them.
- **Knowledge sources:** Add and remove knowledge, with change history and undo.
- **Evals:** Run single evals or suites and read past runs.
- **Read-only switch:** RYMI_MCP_READONLY=1 hides every mutating tool on the local server.
- **Multi-workspace:** A workspace argument lets one connection act in several workspaces.

## Good for

- Set up a new voice agent by describing it
- Review recent calls and usage in minutes
- Run an eval suite before publishing a change
- Manage client workspaces as an agency

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http rymi-mcp https://mcp.rymi.live/mcp
```

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

```sh
https://mcp.rymi.live/mcp
```

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

```json
{
  "mcpServers": {
    "rymi-mcp": {
      "url": "https://mcp.rymi.live/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "rymi-mcp": {
      "type": "http",
      "url": "https://mcp.rymi.live/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rymi-mcp": {
      "serverUrl": "https://mcp.rymi.live/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rymi-mcp": {
      "type": "http",
      "url": "https://mcp.rymi.live/mcp"
    }
  }
}
```

## Tools

- `list_agents`
- `get_agent`
- `create_agent`
- `update_agent`
- `delete_agent`
- `clone_agent`
- `validate_agent_publish`
- `preview_stack`
- `publish_agent`
- `get_pending_publish`
- `set_agent_tools`
- `list_voices`
- `list_llm_options`
- `add_knowledge_source`
- `undo_agent_change`
- `get_usage_summary`
- `run_evals`
- `run_eval_suite`
- `create_call`
- `batch_call`
- `list_calls`
- `list_active_calls`

## FAQ

### Hosted or local?

Both. The hosted URL uses OAuth or a Bearer key; the npm package runs over stdio with an API key.

### Can I limit it to reading?

Yes. Set RYMI_MCP_READONLY=1 on the local server; the hosted one filters tools by role.

### Are publishable keys accepted?

No. Publishable keys are rejected; use a secret key.

### Can it spend credits?

Yes, placing calls spends credits, so review what you approve.

### How do I add Rymi to Claude Code?

Run this command in your terminal: claude mcp add --transport http rymi-mcp https://mcp.rymi.live/mcp

### What are the best alternatives to Rymi?

The closest alternatives to Rymi are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

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