Soma
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SOMA_TOKEN | No | Bearer token used when SOMA_MANAGED=1. If the managed profile is enabled and this is not set, all requests are denied. | |
| SOMA_MANAGED | No | Set to 1 to enable the managed profile, which requires Authorization: Bearer $SOMA_TOKEN on every request. | |
| SOMA_PLUGINS | No | Optional plugin specification for loading custom engine components, e.g. my_engine:components. | |
| SOMA_MAX_BODY | No | Maximum request body size in bytes. Defaults to 1 MiB. | |
| SOMA_QUOTA_PER_HOUR | No | Maximum envelopes per sender per hour in the managed profile. 0 means no limit. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| soma_sendC | Отправить конверт агенту: цель, задача, получатель, бюджет токенов, мандат и цена. Конверт подписывается и попадает в очередь. |
| soma_inboxD | Что ждёт агента: конверты, проверка подписи и контекст, собранный под бюджет токенов. |
| soma_claimC | Забрать конверт из очереди (эксклюзивно) и получить контекст под бюджет. Если у работы назначена цена — нужна квитанция. |
| soma_completeC | Закрыть конверт результатом работы. |
| soma_routeC | Подобрать исполнителя по capability, мандату и цене. Если кандидата нет — вернётся честная причина отказа. |
| soma_verifyA | Проверить подпись конверта офлайн: Ed25519, публичный ключ едет вместе с подписью. |
| soma_statsB | Состояние хаба: конверты по статусам, факты, связи, холодные артефакты. |
| soma_rememberC | Запомнить факт: переживает сессии и смену модели. Теги для поиска, importance 1–5. |
| soma_recallB | Найти факты: полнотекстовый поиск по смыслу, ранжирование по важности и свежести. |
| soma_exportB | Выгрузить все факты и конверты узла одним JSON — право выхода без замка и без удаления за вами. |
| soma_nonceB | Одноразовый нонс для регистрации внешнего агента: доказательство владения ключом. |
| soma_registerB | Зарегистрировать внешнего агента: имя, публичный ключ Ed25519, подпись нонса, способности и цена за вызов. |
| soma_agentsB | Реестр агентов: кто зарегистрирован, что умеет, сколько стоит. Публичная витрина доверия. |
| soma_reputationC | Репутация агента по фактам: подписанные квитанции, нарушения и итоговый счёт. |
| soma_reflectC | Собрать наблюдение по запросу: связка фактов с источниками и рёбрами derived_from. Ответ указывает, из чего выведен. |
| soma_cold_putB | Положить большой артефакт в холодный ярус. Возвращает ссылку sha256 — тело не жжёт контекст. |
| soma_cold_getB | Достать артефакт по ссылке sha256; содержимое сверяется с хешем. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
Each tool maps to a distinct operation in the agent workflow: sending, listing, claiming, completing, routing, verification, memory, registration, reputation, and cold storage. Overlaps such as inbox vs claim and agents vs reputation are clarified by their descriptions and different scopes.
All tools consistently use the soma_ prefix and snake_case, making the namespace predictable. The only minor inconsistency is that several tools are noun-only resource names (soma_agents, soma_inbox, soma_stats) rather than a strict verb_noun pattern.
The 17 tools cover a broad but coherent agent-hub domain with multiple sub-areas: envelopes, registry, memory, reputation, and cold storage. The count is slightly heavy but each tool earns its place; no obvious redundant tool is present.
Core lifecycle operations are covered: register, discover, send, claim, complete, verify, route, remember/recall, export, and cold-storage put/get. Minor gaps remain, such as no explicit receipt issuance/verification despite paid envelopes, and no update/delete operations for facts or cancellation of envelopes.