mediaeater avatar

Swarm At

mediaeater/swarm-at-ledger

This is a hash-chained settlement ledger for multi-agent systems that want tamper-evident audit trails. It exposes 29 tools over MCP including settle_action for rule validation, guard_action for propose-settle-receipt workflows, and verify_receipt for chain lookups. The ledger itself is append-only JSONL with SHA-256 linking each entry to its parent. You get 58 pre-built blueprints across procurement, finance, ML ops, and security workflows, plus framework adapters for LangGraph, CrewAI, AutoGen, and OpenAI Assistants that wrap your nodes or callbacks with zero hard dependencies. Public API endpoints let you verify trust levels, fetch receipts by hash, and check chain integrity without auth. Reach for this when you need verifiable provenance for agent decisions or want to enforce institutional rules before actions execute.

tools
29
auth
Secret needed
transport
STDIO, SSE
env vars
2
last updated
Feb 27, 2026

Tools

29 tools

Public tool metadata for what this MCP can expose to an agent.

settle_actionValidate an action against institutional rules

Validate an action against institutional rules

No parameter schema in public metadata yet.

check_settlementQuery ledger status for a task or hash

Query ledger status for a task or hash

No parameter schema in public metadata yet.

ledger_statusCurrent chain state (latest hash, entry count, integrity)

Current chain state (latest hash, entry count, integrity)

No parameter schema in public metadata yet.

guard_actionSettle before acting — propose + settle + receipt in one call

Settle before acting — propose + settle + receipt in one call

No parameter schema in public metadata yet.

list_blueprintsBrowse workflow blueprints by tag

Browse workflow blueprints by tag

No parameter schema in public metadata yet.

get_blueprintFull blueprint detail with steps and credit cost

Full blueprint detail with steps and credit cost

No parameter schema in public metadata yet.

get_creditsCheck an agent's credit balance

Check an agent's credit balance

No parameter schema in public metadata yet.

topup_creditsAdd credits to an agent

Add credits to an agent

No parameter schema in public metadata yet.

fork_blueprintFork a blueprint into an executable workflow

Fork a blueprint into an executable workflow

No parameter schema in public metadata yet.

verify_receiptLook up a settlement receipt by hash

Look up a settlement receipt by hash

No parameter schema in public metadata yet.

check_trustCheck if an agent meets a minimum trust threshold

Check if an agent meets a minimum trust threshold

No parameter schema in public metadata yet.

settle_batchSettle multiple proposals in one call

Settle multiple proposals in one call

No parameter schema in public metadata yet.

register_agentRegister a new agent identity with trust tracking

Register a new agent identity with trust tracking

No parameter schema in public metadata yet.

get_agentLook up an agent's profile and reputation

Look up an agent's profile and reputation

No parameter schema in public metadata yet.

list_agentsBrowse agents by trust level and role

Browse agents by trust level and role

No parameter schema in public metadata yet.

whoamiAgent self-introspection (trust, tools, next promotion)

Agent self-introspection (trust, tools, next promotion)

No parameter schema in public metadata yet.

execute_stepExecute a single workflow step in a molecule

Execute a single workflow step in a molecule

No parameter schema in public metadata yet.

list_moleculesList active workflow molecules with progress

List active workflow molecules with progress

No parameter schema in public metadata yet.

get_moleculeGet full molecule state with all beads

Get full molecule state with all beads

No parameter schema in public metadata yet.

register_webhookSubscribe to settlement events

Subscribe to settlement events

No parameter schema in public metadata yet.

list_webhooksList registered webhook subscriptions

List registered webhook subscriptions

No parameter schema in public metadata yet.

unregister_webhookRemove a webhook subscription

Remove a webhook subscription

No parameter schema in public metadata yet.

claim_authorshipCreate a verifiable authorship record

Create a verifiable authorship record

No parameter schema in public metadata yet.

verify_authorshipCheck authorship claims by content hash

Check authorship claims by content hash

No parameter schema in public metadata yet.

start_writing_sessionStart tracking authorship provenance

Start tracking authorship provenance

No parameter schema in public metadata yet.

record_writing_eventRecord a creative event in a session

Record a creative event in a session

No parameter schema in public metadata yet.

approve_writingRecord final approval of content

Record final approval of content

No parameter schema in public metadata yet.

get_provenance_reportGenerate a verifiable provenance report

Generate a verifiable provenance report

No parameter schema in public metadata yet.

list_writing_sessionsList active authorship sessions

List active authorship sessions

No parameter schema in public metadata yet.

Sponsors

Configuration

SWARM_API_URL

Base URL for the swarm.at API (default: https://api.swarm.at)

SWARM_API_KEYsecret

API key for authenticated endpoints (settlement, credits, webhooks)

Readme

swarm.at Public Ledger

Hash-chained public record of verified agent settlements. Append-only, tamper-evident, auditable by anyone.

Every entry in ledger.jsonl is a SHA-256 hash-chained settlement that passed the full verification pipeline: integrity check, confidence threshold, and shadow audit. Modifying any entry breaks all subsequent hashes.

Ledger Format

Each line in ledger.jsonl is a JSON object:

{
  "timestamp": 1770480398.05,
  "task_id": "fingerprint-pg84",
  "parent_hash": "000000...000000",
  "payload": { "type": "text-fingerprint", "title": "Frankenstein", "..." : "..." },
  "current_hash": "453eaa...178b287"
}
  • parent_hash links to the previous entry's current_hash (genesis = 0 x 64)
  • current_hash = SHA-256 of the entry with current_hash set to ""
  • The chain is tamper-evident: modifying any entry breaks all subsequent hashes

Canonical Hash Algorithm

To verify any entry:

  1. Parse the JSON line into a dict
  2. Set current_hash to "" (empty string)
  3. Serialize with json.dumps(entry, sort_keys=True).encode() (UTF-8)
  4. Compute hashlib.sha256(serialized).hexdigest()
  5. Compare against the stored current_hash

View the full README on GitHub

Details

Repository
github.com/mediaeater/swarm-at-ledger
Category
AI & LLM Tools
Package
swarm-at-sdk
Transport
STDIO, SSE
Auth
Required
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1morous-dev avatarEngram Ccmorous-dev/engram-context-continuumUniversal AI coding assistant memory — session handoff, SLM compression, and semantic retrieval.0stars
2mukundakatta avatarAgentcastmukundakatta/agentcast-mcpStructured-output enforcer: extract and validate JSON from messy LLM text.1stars
3mukundakatta avatarAgentguardmukundakatta/agentguard-mcpNetwork-egress firewall for agent tools: check URLs against a declarative policy.1stars
4mukundakatta avatarAgentvetmukundakatta/agentvet-mcpValidate tool-call args before execution. Returns LLM-friendly retry hints.1stars
5new1direction avatarKorg Ledgernew1direction/korgexVerifiable cognition: prove a session ledger is tamper-evident; audit & import any agent's logs.1stars
6agentra-commerce avatarXapagentra-commerce/xap-sdkAgent settlement protocol — discover, negotiate, settle, and verify with XAP.0stars