Soma — open protocol for agent work
Signed task envelopes that carry a token budget, mandate and price between agents
- Pricing
- Freemium
- Platforms
- API, self-hosted, CLI
- Runs
- Remotely
- Version
- 0.2.0
- Listing updated
- 3 days ago
About Soma — open protocol for agent work
Soma — open protocol for agent work is a freemium MCP server for ai models and llm tooling. It runs as a hosted remote server, so there is nothing to install locally.
Agents that hand work to each other usually pass chat text with no limit attached. Soma replaces that with an envelope: a goal, task, hard token budget, mandate, price, deadline and Ed25519 signature. The receiver knows the limit before starting, refusals name the rule that fired, and signatures can be verified offline from the included public key.
The project is a protocol, a reference implementation in Python and a conformance suite, rather than a platform. Memory has three tiers, a hot queue, SQLite facts with full-text search and cold artifacts by hash, and an append-only hash-linked history records what happened. The conformance script can be pointed at any MCP endpoint to check it speaks the protocol.
The hosted node at rta.lat/soma/mcp offers 20 free calls a day, $0.02 per call in USDC over x402, or $19 for 30 days without a daily cap. Discovery calls are always free.
Install
Run in a terminal
claude mcp add --transport http soma https://rta.lat/soma/mcpAdd to Settings → Connectors → Add custom connector
https://rta.lat/soma/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"soma": {
"url": "https://rta.lat/soma/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"soma": {
"type": "http",
"url": "https://rta.lat/soma/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"soma": {
"serverUrl": "https://rta.lat/soma/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"soma": {
"type": "http",
"url": "https://rta.lat/soma/mcp"
}
}
}Tools this server provides (17)
Read directly from the server.
- soma_send
- Send an envelope to an agent: goal, task, recipient, token budget, mandate and price. The envelope is signed and queued.
- soma_inbox
- What waits for the agent: envelopes, signature verification and context packed under a token budget.
- soma_claim
- Take an envelope from the queue exclusively and get context packed under its budget. If the work carries a price, a receipt is required.
- soma_complete
- Close an envelope with the result of the work.
- soma_route
- Pick an executor by capability, mandate and price. If no candidate fits, the refusal names every reason.
- soma_verify
- Verify an envelope signature offline: Ed25519, the public key travels with the signature.
- soma_stats
- Node state: envelopes by status, facts, edges, cold artifacts.
- soma_remember
- Store a fact: it survives sessions and model changes. Tags for search, importance 1-5.
- soma_recall
- Find facts: full-text search by meaning, ranked by importance and recency.
- soma_export
- Export every fact and envelope as one JSON - the right to leave, with no lock-in.
- soma_nonce
- One-time nonce for registering an external agent: proof of key ownership.
- soma_register
- Register an external agent: name, Ed25519 public key, nonce signature, capabilities and price per call.
- soma_agents
- Registry of agents: who is registered, what they can do, what it costs. A public showcase of trust.
- soma_reputation
- Agent reputation from facts: signed receipts, violations and the running score.
- soma_reflect
- Collect an observation for a query: facts linked to sources and derived_from edges. The answer names what it was derived from.
- soma_cold_put
- Put a large artifact in the cold tier. Returns a sha256 reference - the body does not burn context.
- soma_cold_get
- Fetch an artifact by sha256 reference; the content is checked against the hash.
What it does
- Signed envelopes
- Goal, task, budget, mandate, price and deadline travel with a signature.
- Offline verification
- Ed25519 signatures verify without a service or secret.
- Hard token budgets
- The receiver learns the limit before it starts.
- Three memory tiers
- Hot queue, warm facts with FTS5 and cold artifacts.
- Conformance suite
- Run it against any MCP endpoint or Python implementation.
- x402 payments
- Pay per call in USDC with no account or key.
Good for
- Delegate a task to another agent with a spending cap
- Audit what an agent did using the hash-linked history
- Check that a hub implementation follows the protocol
- Verify a message was not altered
Pricing
Freemium, from $19 a month
20 free calls/day; $0.02/call or $19 per 30 days
Prices change. Check rta.lat before you buy.
Soma — open protocol for agent work FAQ
Is there a free tier?
Yes, 20 calls a day, and discovery is always free.
How does pay-per-call work?
$0.02 per call in USDC on Base mainnet over x402, with no account or API key.
Can I run my own hub?
Yes. The repo includes a reference hub started with soma serve and a conformance suite.
Is Soma — open protocol for agent work free?
Soma — open protocol for agent work has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.
How do I add Soma — open protocol for agent work to Claude Code?
Run this command in your terminal: claude mcp add --transport http soma https://rta.lat/soma/mcp
What are the best alternatives to Soma — open protocol for agent work?
The closest alternatives to Soma — open protocol for agent work are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Soma — open protocol for agent work

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools