# Soma — open protocol for agent work

> Soma — open protocol for agent work is a freemium MCP server for ai models and llm tooling. Signed task envelopes that carry a token budget, mandate and price between agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** API, self-hosted, CLI
- **Website:** https://rta.lat/soma/pricing
- **Repository:** https://github.com/mrpkk/soma-protocol
- **MCP Registry name:** lat.rta/soma
- **Categories:** AI models and LLM tooling, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http soma https://rta.lat/soma/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://rta.lat/soma/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "soma": {
      "url": "https://rta.lat/soma/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "soma": {
      "type": "http",
      "url": "https://rta.lat/soma/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "soma": {
      "serverUrl": "https://rta.lat/soma/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "soma": {
      "type": "http",
      "url": "https://rta.lat/soma/mcp"
    }
  }
}
```

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/soma-open-protocol-for-agent-work-2
