Skip to content
MCP server

Soma

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

Runs locallyStatus and history
Install
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/soma

Add 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.

How AIPoweredBot checks servers