Soma — open protocol for agent work is an MCP server published by io.github.mrpkk, hosted at rta.lat. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 17 tools, including soma_send, soma_inbox, soma_claim, soma_complete, soma_route.
Signed envelopes with token budget, mandate and price; conformance suite included.
22 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Send an envelope to an agent: goal, task, recipient, token budget, mandate and price. The envelope is signed and queued.
| Parameter | Type | Description |
|---|---|---|
| to | string | |
| goal * | string | |
| task * | string | |
| ttl_s | number | |
| sender | string | |
| cost_usdc | any | |
| capability | any | |
| price_usdc | any | |
| visibility | string | |
| max_cost_usd | any | |
| token_budget | integer | |
| context_query | string |
{
"name": "soma_send",
"title": "Send an envelope to an agent",
"description": "Send an envelope to an agent: goal, task, recipient, token budget, mandate and price. The envelope is signed and queued.",
"inputSchema": {
"type": "object",
"title": "soma_sendArguments",
"required": [
"goal",
"task"
],
"properties": {
"to": {
"type": "string",
"title": "To",
"default": "*"
},
"goal": {
"type": "string",
"title": "Goal"
},
"task": {
"type": "string",
"title": "Task"
},
"ttl_s": {
"type": "number",
"title": "Ttl S",
"default": 3600
},
"sender": {
"type": "string",
"title": "Sender",
"default": "mcp"
},
"cost_usdc": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Cost Usdc",
"default": null
},
"capability": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Capability",
"default": null
},
"price_usdc": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Price Usdc",
"default": null
},
"visibility": {
"type": "string",
"title": "Visibility",
"default": "private"
},
"max_cost_usd": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Max Cost Usd",
"default": null
},
"token_budget": {
"type": "integer",
"title": "Token Budget",
"default": 2000
},
"context_query": {
"type": "string",
"title": "Context Query",
"default": ""
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_sendOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Send an envelope to an agent",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}What waits for the agent: envelopes, signature verification and context packed under a token budget.
| Parameter | Type | Description |
|---|---|---|
| agent * | string | |
| limit | integer |
{
"name": "soma_inbox",
"title": "Agent inbox",
"description": "What waits for the agent: envelopes, signature verification and context packed under a token budget.",
"inputSchema": {
"type": "object",
"title": "soma_inboxArguments",
"required": [
"agent"
],
"properties": {
"agent": {
"type": "string",
"title": "Agent"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_inboxOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Agent inbox",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Take an envelope from the queue exclusively and get context packed under its budget. If the work carries a price, a receipt is required.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| agent * | string | |
| payment | string |
{
"name": "soma_claim",
"title": "Claim an envelope",
"description": "Take an envelope from the queue exclusively and get context packed under its budget. If the work carries a price, a receipt is required.",
"inputSchema": {
"type": "object",
"title": "soma_claimArguments",
"required": [
"id",
"agent"
],
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"agent": {
"type": "string",
"title": "Agent"
},
"payment": {
"type": "string",
"title": "Payment",
"default": ""
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_claimOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Claim an envelope",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Close an envelope with the result of the work.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| agent | string | |
| result * | string |
{
"name": "soma_complete",
"title": "Complete an envelope",
"description": "Close an envelope with the result of the work.",
"inputSchema": {
"type": "object",
"title": "soma_completeArguments",
"required": [
"id",
"result"
],
"properties": {
"id": {
"type": "string",
"title": "Id"
},
"agent": {
"type": "string",
"title": "Agent",
"default": ""
},
"result": {
"type": "string",
"title": "Result"
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_completeOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Complete an envelope",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Pick an executor by capability, mandate and price. If no candidate fits, the refusal names every reason.
| Parameter | Type | Description |
|---|---|---|
| id * | string |
{
"name": "soma_route",
"title": "Route an envelope to an executor",
"description": "Pick an executor by capability, mandate and price. If no candidate fits, the refusal names every reason.",
"inputSchema": {
"type": "object",
"title": "soma_routeArguments",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"title": "Id"
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_routeOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Route an envelope to an executor",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Verify an envelope signature offline: Ed25519, the public key travels with the signature.
| Parameter | Type | Description |
|---|---|---|
| envelope_json * | string |
{
"name": "soma_verify",
"title": "Verify an envelope signature",
"description": "Verify an envelope signature offline: Ed25519, the public key travels with the signature.",
"inputSchema": {
"type": "object",
"title": "soma_verifyArguments",
"required": [
"envelope_json"
],
"properties": {
"envelope_json": {
"type": "string",
"title": "Envelope Json"
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_verifyOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Verify an envelope signature",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Node state: envelopes by status, facts, edges, cold artifacts.
No parameters.
{
"name": "soma_stats",
"title": "Node stats",
"description": "Node state: envelopes by status, facts, edges, cold artifacts.",
"inputSchema": {
"type": "object",
"title": "soma_statsArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"title": "soma_statsOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Node stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Store a fact: it survives sessions and model changes. Tags for search, importance 1-5.
| Parameter | Type | Description |
|---|---|---|
| kind | string | |
| tags | string | |
| text * | string | |
| source | string | |
| session | string | |
| importance | integer |
{
"name": "soma_remember",
"title": "Remember a fact",
"description": "Store a fact: it survives sessions and model changes. Tags for search, importance 1-5.",
"inputSchema": {
"type": "object",
"title": "soma_rememberArguments",
"required": [
"text"
],
"properties": {
"kind": {
"type": "string",
"title": "Kind",
"default": "fact"
},
"tags": {
"type": "string",
"title": "Tags",
"default": ""
},
"text": {
"type": "string",
"title": "Text"
},
"source": {
"type": "string",
"title": "Source",
"default": ""
},
"session": {
"type": "string",
"title": "Session",
"default": ""
},
"importance": {
"type": "integer",
"title": "Importance",
"default": 3
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_rememberOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Remember a fact",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Find facts: full-text search by meaning, ranked by importance and recency.
| Parameter | Type | Description |
|---|---|---|
| k | integer | |
| query * | string |
{
"name": "soma_recall",
"title": "Recall facts",
"description": "Find facts: full-text search by meaning, ranked by importance and recency.",
"inputSchema": {
"type": "object",
"title": "soma_recallArguments",
"required": [
"query"
],
"properties": {
"k": {
"type": "integer",
"title": "K",
"default": 10
},
"query": {
"type": "string",
"title": "Query"
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_recallOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Recall facts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Export every fact and envelope as one JSON - the right to leave, with no lock-in.
| Parameter | Type | Description |
|---|---|---|
| limit | integer |
{
"name": "soma_export",
"title": "Export node data",
"description": "Export every fact and envelope as one JSON - the right to leave, with no lock-in.",
"inputSchema": {
"type": "object",
"title": "soma_exportArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 5000
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_exportOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Export node data",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One-time nonce for registering an external agent: proof of key ownership.
| Parameter | Type | Description |
|---|---|---|
| agent * | string |
{
"name": "soma_nonce",
"title": "Issue a registration nonce",
"description": "One-time nonce for registering an external agent: proof of key ownership.",
"inputSchema": {
"type": "object",
"title": "soma_nonceArguments",
"required": [
"agent"
],
"properties": {
"agent": {
"type": "string",
"title": "Agent"
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_nonceOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Issue a registration nonce",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Register an external agent: name, Ed25519 public key, nonce signature, capabilities and price per call.
| Parameter | Type | Description |
|---|---|---|
| agent * | string | |
| proof * | string | |
| public_key * | string | |
| capabilities | any | |
| cost_per_call | number |
{
"name": "soma_register",
"title": "Register an external agent",
"description": "Register an external agent: name, Ed25519 public key, nonce signature, capabilities and price per call.",
"inputSchema": {
"type": "object",
"title": "soma_registerArguments",
"required": [
"agent",
"public_key",
"proof"
],
"properties": {
"agent": {
"type": "string",
"title": "Agent"
},
"proof": {
"type": "string",
"title": "Proof"
},
"public_key": {
"type": "string",
"title": "Public Key"
},
"capabilities": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Capabilities",
"default": null
},
"cost_per_call": {
"type": "number",
"title": "Cost Per Call",
"default": 0
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_registerOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Register an external agent",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Registry of agents: who is registered, what they can do, what it costs. A public showcase of trust.
No parameters.
{
"name": "soma_agents",
"title": "Agent registry",
"description": "Registry of agents: who is registered, what they can do, what it costs. A public showcase of trust.",
"inputSchema": {
"type": "object",
"title": "soma_agentsArguments",
"properties": {}
},
"outputSchema": {
"type": "object",
"title": "soma_agentsOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Agent registry",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Agent reputation from facts: signed receipts, violations and the running score.
| Parameter | Type | Description |
|---|---|---|
| agent * | string |
{
"name": "soma_reputation",
"title": "Agent reputation",
"description": "Agent reputation from facts: signed receipts, violations and the running score.",
"inputSchema": {
"type": "object",
"title": "soma_reputationArguments",
"required": [
"agent"
],
"properties": {
"agent": {
"type": "string",
"title": "Agent"
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_reputationOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Agent reputation",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Collect an observation for a query: facts linked to sources and derived_from edges. The answer names what it was derived from.
| Parameter | Type | Description |
|---|---|---|
| k | integer | |
| save | boolean | |
| query * | string |
{
"name": "soma_reflect",
"title": "Reflect on facts",
"description": "Collect an observation for a query: facts linked to sources and derived_from edges. The answer names what it was derived from.",
"inputSchema": {
"type": "object",
"title": "soma_reflectArguments",
"required": [
"query"
],
"properties": {
"k": {
"type": "integer",
"title": "K",
"default": 8
},
"save": {
"type": "boolean",
"title": "Save",
"default": true
},
"query": {
"type": "string",
"title": "Query"
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_reflectOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Reflect on facts",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Put a large artifact in the cold tier. Returns a sha256 reference - the body does not burn context.
| Parameter | Type | Description |
|---|---|---|
| text * | string |
{
"name": "soma_cold_put",
"title": "Store a cold artifact",
"description": "Put a large artifact in the cold tier. Returns a sha256 reference - the body does not burn context.",
"inputSchema": {
"type": "object",
"title": "soma_cold_putArguments",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"title": "Text"
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_cold_putOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Store a cold artifact",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Fetch an artifact by sha256 reference; the content is checked against the hash.
| Parameter | Type | Description |
|---|---|---|
| ref * | string |
{
"name": "soma_cold_get",
"title": "Fetch a cold artifact",
"description": "Fetch an artifact by sha256 reference; the content is checked against the hash.",
"inputSchema": {
"type": "object",
"title": "soma_cold_getArguments",
"required": [
"ref"
],
"properties": {
"ref": {
"type": "string",
"title": "Ref"
}
}
},
"outputSchema": {
"type": "object",
"title": "soma_cold_getOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "string",
"title": "Result"
}
}
},
"annotations": {
"title": "Fetch a cold artifact",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.