Soma MCP Server
by dinglebear-aiai.dinglebear/somav0.10.0
RMCP runtime for provider-backed agents with CLI, REST, HTTP MCP, plugins, and scaffold support.
context tax
queued
security
queued
cold start
queued
freshness
Active11d ago
Install Soma MCP server
Install in Claude Code
claude mcp add soma -e SOMA_API_KEY='<soma-api-key>' -- npx -y @dinglebear/soma mcpInstall in Cursor
{
"mcpServers": {
"soma": {
"command": "npx",
"args": [
"-y",
"@dinglebear/soma",
"mcp"
],
"env": {
"SOMA_API_KEY": "<soma-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"soma": {
"command": "npx",
"args": [
"-y",
"@dinglebear/soma",
"mcp"
],
"env": {
"SOMA_API_KEY": "<soma-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"soma": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dinglebear/soma",
"mcp"
],
"env": {
"SOMA_API_KEY": "<soma-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"soma": {
"command": "npx",
"args": [
"-y",
"@dinglebear/soma",
"mcp"
],
"env": {
"SOMA_API_KEY": "<soma-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| SOMA_HOME | — | — | Host data directory used by the local Soma CLI and stdio MCP runtime. |
| SOMA_PROVIDER_DIR | — | — | Host directory scanned for drop-in provider manifests and modules. |
| SOMA_API_URL | — | — | Optional deployed platform API or upstream API base URL used by the SomaClient compatibility layer. Leave unset for local provider/runtime mode. |
| SOMA_API_KEY | — | yes | Optional bearer token or upstream API key for provider-backed calls that use SomaClient. Keep secret. |
| RUST_LOG | — | — | Rust tracing filter for local CLI and stdio MCP logs. |
Freshness
Active — last maintenance signal 11d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-28 · 11d ago · GitHub
Latest release
2026-08-05 · 2mo ago · GitHub · v0.10.0
Package published
no data · npm/PyPI
Registry entry updated
2026-08-05 · 2mo ago · official registry · v0.10.0
FAQ
›How do I install the Soma MCP server in Claude Code?
Run: claude mcp add soma -e SOMA_API_KEY='<soma-api-key>' -- npx -y @dinglebear/soma mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Soma require an API key?
Yes. It expects SOMA_API_KEY, of which 1 is a secret.
›Can I use Soma as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Soma in the official MCP registry?
Yes, as ai.dinglebear/soma.