Skip to content
MCP server

Soma — open protocol for agent work

Signed task envelopes that carry a token budget, mandate and price between agents

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://rta.lat/soma/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "soma": {
      "url": "https://rta.lat/soma/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools