Soma
RMCP runtime for provider-backed agents with CLI, REST, HTTP MCP, plugins, and scaffold…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.10.0
- Listing updated
- 6 days ago
Similar MCP servers
About Soma
Soma is an open-source MCP server. It runs locally on your machine and is started by your AI client.
RMCP runtime for provider-backed agents with CLI, REST, HTTP MCP, plugins, and scaffold support.
Install
Run in a terminal
claude mcp add soma --env SOMA_API_KEY='<SOMA_API_KEY>' -- npx -y @dinglebear/somaAdd to claude_desktop_config.json
{
"mcpServers": {
"soma": {
"command": "npx",
"args": [
"-y",
"@dinglebear/soma"
],
"env": {
"SOMA_API_KEY": "<SOMA_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"soma": {
"command": "npx",
"args": [
"-y",
"@dinglebear/soma"
],
"env": {
"SOMA_API_KEY": "<SOMA_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"soma": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dinglebear/soma"
],
"env": {
"SOMA_API_KEY": "<SOMA_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"soma": {
"command": "npx",
"args": [
"-y",
"@dinglebear/soma"
],
"env": {
"SOMA_API_KEY": "<SOMA_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"soma": {
"command": "npx",
"args": [
"-y",
"@dinglebear/soma"
],
"env": {
"SOMA_API_KEY": "<SOMA_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
SOMA_HOMERuntime data directory inside the Soma container.SOMA_PROVIDER_DIRDirectory scanned for drop-in provider manifests and modules.SOMA_API_URLOptional deployed platform API or upstream API base URL used by the SomaClient compatibility layer. Leave unset for local provider/runtime mode.SOMA_API_KEYOptional bearer token or upstream API key for provider-backed calls that use SomaClient. Keep secret.RUST_LOGRust tracing filter for local CLI and stdio MCP logs.SOMA_HOMEHost data directory used by the local Soma CLI and stdio MCP runtime.SOMA_PROVIDER_DIRHost directory scanned for drop-in provider manifests and modules.SOMA_API_URLOptional deployed platform API or upstream API base URL used by the SomaClient compatibility layer. Leave unset for local provider/runtime mode.SOMA_API_KEYOptional bearer token or upstream API key for provider-backed calls that use SomaClient. Keep secret.RUST_LOGRust tracing filter for local CLI and stdio MCP logs.
Pricing
Open source
Prices change. Check soma.dinglebear.ai before you buy.
Soma FAQ
Is Soma free?
Yes. Soma is open source, so you can use and self-host it for free.
How do I add Soma to Claude Code?
Run this command in your terminal: claude mcp add soma --env SOMA_API_KEY='<SOMA_API_KEY>' -- npx -y @dinglebear/soma
What are the best alternatives to Soma?
The closest alternatives to Soma are Soma — open protocol for agent work, Soma — open protocol for agent work and Runtime Cloud.
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.