Soma
RMCP runtime for provider-backed agents with CLI, REST, HTTP MCP, plugins, and scaffold support.
Install and compare this MCP server
Use this profile to copy client config, check auth requirements, review tools and resources, and compare related MCP servers before adding it to an AI client.
- Install
- Client config available
- Clients
- Claude, Cursor, VS Code, Codex
- Transport
- STDIO
- Auth
- Not captured
- Capabilities
- 0 tools, 0 resources, 0 prompts
- Related
- Cortex RMCP, UniFi RMCP, Soma
Want MCP integration examples?
Get practical integration notes and launch examples for MCP servers like Soma.
Install
Connection
- Transport
- STDIO
- Environment
{ "SOMA_HOME": "~/.soma", "SOMA_PROVIDER_DIR": "./providers", "SOMA_API_URL": "YOUR_VALUE_HERE", "SOMA_API_KEY": "YOUR_SECRET_VALUE", "RUST_LOG": "info" }
Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"ai-dinglebear-soma": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-ai-dinglebear-soma"
],
"env": {
"SOMA_HOME": "~/.soma",
"SOMA_PROVIDER_DIR": "./providers",
"SOMA_API_URL": "YOUR_VALUE_HERE",
"SOMA_API_KEY": "YOUR_SECRET_VALUE",
"RUST_LOG": "info"
}
}
}
}Config location
- macOS
~/Library/Application Support/Claude/claude_desktop_config.json- Windows
%APPDATA%\Claude\claude_desktop_config.json
Auth
Package transportNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
Tools & Resources
No public tools, resources, or prompts captured yet. Use Auth when this server requires credentials.
Tools
No tools captured yet.
Resources
No resources captured yet.
Prompts
No prompts captured yet.
Questions
What is Soma?+
Soma is an MCP server for RMCP runtime for provider-backed agents with CLI, REST, HTTP MCP, plugins, and scaffold support.. It supports STDIO transport.
How do I install Soma?+
Use the client-specific config in Install and add it to your MCP-compatible client.
How do I add Soma to Claude Desktop?+
Choose the Claude Desktop tab in Install and copy the config into Claude Desktop's MCP server settings.
How do I add Soma to Claude Code?+
Choose the Claude Code tab in Install and copy the config into Claude Code's MCP server settings.
How do I use Soma with Codex?+
Choose the Codex tab in Install and copy the config into Codex's MCP server settings.
How do I add Soma to Cursor or VS Code?+
Choose the Cursor or VS Code tab in Install and copy the config into Cursor or VS Code's MCP server settings.
What endpoint and transport does Soma use?+
Soma uses STDIO transport. Use the package or command config in Install.
What tools and resources does Soma expose?+
Soma inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
Does Soma require authentication?+
Soma does not advertise a verified auth requirement. If discovery fails, it may still need provider login, an API key, a bearer token, or a session header.
Related MCPs
Cortex RMCPSelf-hosted homelab log intelligence over MCP, CLI, and REST with SQLite/FTS.UniFi RMCPRust MCP server and CLI for UniFi Network controller operations.SomaDrop-in RMCP runtime for provider-backed MCP tools, prompts, resources, and agent capabilities.LabbyLocal-first MCP gateway and homelab control plane with CLI, HTTP API, and web UI.YTDL RMCPRust MCP server and CLI for yt-dlp search, downloads, metadata, transfers, and Plex playlists.Yarr MCPRust MCP and CLI server for Sonarr, Radarr, Prowlarr, Plex, Jellyfin, and download clients.
Profile notes
- Package: Oci ghcr.io/dinglebear-ai/soma:0.9.0
- Environment variable: SOMA_HOME (default /data)
- Environment variable: SOMA_PROVIDER_DIR (default /data/providers)
- Environment variable: SOMA_API_URL
- Environment variable: SOMA_API_KEY (secret)
- Environment variable: RUST_LOG (default info)
- Package: Npm @dinglebear/soma v0.9.0
- Environment variable: SOMA_HOME (default ~/.soma)
- Environment variable: SOMA_PROVIDER_DIR (default ./providers)
- Environment variable: SOMA_API_URL
- Environment variable: SOMA_API_KEY (secret)
- Environment variable: RUST_LOG (default info)
Packages
| Package | Registry | Version | Inputs |
|---|---|---|---|
ghcr.io/dinglebear-ai/soma:0.9.0stdio | oci | Not captured | Env: SOMA_HOME Env: SOMA_PROVIDER_DIR Env: SOMA_API_URL Env: SOMA_API_KEY secret Env: RUST_LOG |
@dinglebear/somastdio | npm | 0.9.0 | Env: SOMA_HOME Env: SOMA_PROVIDER_DIR Env: SOMA_API_URL Env: SOMA_API_KEY secret Env: RUST_LOG |
Details
- Version
- 0.9.0
- Repository
- https://github.com/dinglebear-ai/soma
- Website
- https://soma.dinglebear.ai
- Updated
- Aug 3, 2026