RMCP runtime for provider-backed agents with CLI, REST, HTTP MCP, plugins, and scaffold support.
Connect Runs on your machine
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{
"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>"
}
}
}
}{
"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>"
}
}
}
}{
"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>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
SOMA_HOMEOptional | Runtime data directory inside the Soma container. |
SOMA_PROVIDER_DIROptional | Directory scanned for drop-in provider manifests and modules. |
SOMA_API_URLOptional | Optional deployed platform API or upstream API base URL used by the SomaClient compatibility layer. Leave unset for local provider/runtime mode. |
SOMA_API_KEYOptional, secret | Optional bearer token or upstream API key for provider-backed calls that use SomaClient. Keep secret. |
RUST_LOGOptional | Rust tracing filter for local CLI and stdio MCP logs. |
Details
| Package | ghcr.io/dinglebear-ai/soma:0.10.0 (OCI, stdio) |
| Package | @dinglebear/[email protected] (NPM, stdio) |
| First published | 5 Aug 2026 |
| Last updated | 5 Aug 2026 |
| Registry name | ai.dinglebear/soma |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.