Soma

Drop-in RMCP runtime

Provider-backed agent capabilities from one Rust runtime.

Drop in provider manifests or modules for tools, prompts, resources, and actions. Soma supplies MCP, CLI, REST, auth, setup, generated metadata, and the embedded web UI.

Open tool runner View API routes

REST routes

MCP actions

Transports

stdio / HTTP

Runtime console

Checking...

http://127.0.0.1:40060/mcpstreamable-http

$soma status --json

>health: checking...

>api: waiting for /v1/status

>surfaces: mcp, cli, rest, web, docker, plugins

>providers: manifests + modules loaded at runtime

MCP

/mcp

REST

/v1/status

CLI

soma help

Web

/tools + /api

Install01

Install

Start from the npm launcher while keeping the installed command as soma.

npx soma-rmcp mcp

Bring online02

Bring online

Serve MCP, REST, and the embedded web UI from one runtime.

soma serve

Drop in providers03

Drop in providers

Provider manifests and modules become generated tools, prompts, and metadata.

SOMA_PROVIDER_DIR=providers

Provider drop-in surface

Soma turns provider files into consistent agent, REST, CLI, and metadata surfaces.

Provider modules

providers/

Runtime-scanned provider files for tools, prompts, resources, and actions.

Scaffold intent

scaffold_intent

MCP elicitation flow that collects setup intent for new provider work.

Client prompts

Claude / Codex / Gemini

Generated plugin surfaces share the same provider-backed capability metadata.

Action catalog

GET /v1/help

REST, CLI, and MCP surfaces stay aligned through generated action metadata.

Try the compiled runtime

These controls call the same REST actions shown in the API explorer.

localReadyRun a REST action to see the response stream here.

Distribution metadata

Published surfaces are generated from the same runtime identity.

GitHub source

Package

soma-rmcp

Binary

soma

Image

ghcr.io/jmagar/soma:0.4.6

License

MIT

Publisher

dinglebear.ai

Surfaces

MCP, CLI, REST, web, Docker, plugins