# Soma

- Name: `ai.dinglebear/soma`
- Tier: **Indexed** (Crawled from a public source. No check has passed yet, or a check failed.)
- Latest version: 0.10.0, released 2026-08-05
- Website: https://soma.dinglebear.ai
- Source: https://github.com/dinglebear-ai/soma
- Trust page: https://mcpvetted.com/t/dinglebear-soma

RMCP runtime for provider-backed agents with CLI, REST, HTTP MCP, plugins, and scaffold support.

## What it can reach

- Network: none seen
- Files: none seen
- Accounts and secrets: Secret: SOMA_API_KEY

## Checks

### qualify: pass
Rules 2026-09-29.1, ran 2026-09-30T03:05:36.735Z.

### static: pass
Rules 2026-09-29.1, ran 2026-09-30T03:05:36.736Z.
- [low] Package ghcr.io/dinglebear-ai/soma:0.10.0 isn't pinned to a version. (install)

### llm_claims: skipped
Rules 2026-09-29.1, ran 2026-09-30T03:05:36.736Z.
- [info] LLM claims check is not configured on this deploy.

## Install

### VS Code
Link: vscode:mcp/install?%7B%22name%22%3A%22soma%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22docker%22%2C%22args%22%3A%5B%22run%22%2C%22-i%22%2C%22--rm%22%2C%22ghcr.io%2Fdinglebear-ai%2Fsoma%3A0.10.0%22%5D%2C%22env%22%3A%7B%22SOMA_HOME%22%3A%22%3CSOMA_HOME%3E%22%2C%22SOMA_PROVIDER_DIR%22%3A%22%3CSOMA_PROVIDER_DIR%3E%22%2C%22SOMA_API_URL%22%3A%22%3CSOMA_API_URL%3E%22%2C%22SOMA_API_KEY%22%3A%22%3CSOMA_API_KEY%3E%22%2C%22RUST_LOG%22%3A%22%3CRUST_LOG%3E%22%7D%7D
```sh
code --add-mcp '{"name":"soma","type":"stdio","command":"docker","args":["run","-i","--rm","ghcr.io/dinglebear-ai/soma:0.10.0"],"env":{"SOMA_HOME":"<SOMA_HOME>","SOMA_PROVIDER_DIR":"<SOMA_PROVIDER_DIR>","SOMA_API_URL":"<SOMA_API_URL>","SOMA_API_KEY":"<SOMA_API_KEY>","RUST_LOG":"<RUST_LOG>"}}'
```
```json
{
  "servers": {
    "soma": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/dinglebear-ai/soma:0.10.0"
      ],
      "env": {
        "SOMA_HOME": "<SOMA_HOME>",
        "SOMA_PROVIDER_DIR": "<SOMA_PROVIDER_DIR>",
        "SOMA_API_URL": "<SOMA_API_URL>",
        "SOMA_API_KEY": "<SOMA_API_KEY>",
        "RUST_LOG": "<RUST_LOG>"
      }
    }
  }
}
```
1. Click the link, or run the command.
2. VS Code asks you to confirm the server before it starts.

### Cursor
Link: cursor://anysphere.cursor-deeplink/mcp/install?name=soma&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyJydW4iLCItaSIsIi0tcm0iLCJnaGNyLmlvL2RpbmdsZWJlYXItYWkvc29tYTowLjEwLjAiXSwiZW52Ijp7IlNPTUFfSE9NRSI6IjxTT01BX0hPTUU%2BIiwiU09NQV9QUk9WSURFUl9ESVIiOiI8U09NQV9QUk9WSURFUl9ESVI%2BIiwiU09NQV9BUElfVVJMIjoiPFNPTUFfQVBJX1VSTD4iLCJTT01BX0FQSV9LRVkiOiI8U09NQV9BUElfS0VZPiIsIlJVU1RfTE9HIjoiPFJVU1RfTE9HPiJ9fQ%3D%3D
```json
{
  "mcpServers": {
    "soma": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/dinglebear-ai/soma:0.10.0"
      ],
      "env": {
        "SOMA_HOME": "<SOMA_HOME>",
        "SOMA_PROVIDER_DIR": "<SOMA_PROVIDER_DIR>",
        "SOMA_API_URL": "<SOMA_API_URL>",
        "SOMA_API_KEY": "<SOMA_API_KEY>",
        "RUST_LOG": "<RUST_LOG>"
      }
    }
  }
}
```
1. Click the link to open Cursor.
2. Cursor shows the server and asks you to install it.

### Claude Code
```sh
claude mcp add soma -e SOMA_HOME=<SOMA_HOME> -e SOMA_PROVIDER_DIR=<SOMA_PROVIDER_DIR> -e SOMA_API_URL=<SOMA_API_URL> -e SOMA_API_KEY=<SOMA_API_KEY> -e RUST_LOG=<RUST_LOG> -- docker run -i --rm ghcr.io/dinglebear-ai/soma:0.10.0
```
1. Run the command in your terminal.
2. Restart or reload Claude Code if it's already open.

### Claude Desktop
```json
{
  "mcpServers": {
    "soma": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/dinglebear-ai/soma:0.10.0"
      ],
      "env": {
        "SOMA_HOME": "<SOMA_HOME>",
        "SOMA_PROVIDER_DIR": "<SOMA_PROVIDER_DIR>",
        "SOMA_API_URL": "<SOMA_API_URL>",
        "SOMA_API_KEY": "<SOMA_API_KEY>",
        "RUST_LOG": "<RUST_LOG>"
      }
    }
  }
}
```
1. Open Settings, then Developer, then Edit Config.
2. Add the block below to claude_desktop_config.json.
3. Restart Claude Desktop.

### Claude (web) (not supported)
1. Claude on the web only connects to remote servers. Use Claude Desktop or Claude Code for this one.