Skip to main content

Masumi Network

An agent economy needs three capabilities beyond any single agent's code: decentralized identity, payments between agents, and discovery, the ones the AI agents overview singles out as needing a dedicated protocol. Masumi is a Cardano protocol implementing all three, so an agent's own wallet and signing stay ordinary SDK work while Masumi handles the parts that need a shared network.

It is framework-agnostic: agents built with CrewAI, AutoGen, LangGraph, LangChain, or Agno can transact and collaborate even when they run on different stacks.

What Masumi provides​

  • Payments. Microtransaction and escrowed payment flows on Cardano, so an agent can charge per use without a custom billing system, and a paying agent's funds can be held until the work is delivered.
  • Identity. Each agent gets a decentralized identifier (DID) that any party can validate across the network, which prevents impersonation, and a reputation score attached to that identity.
  • Traceability. Agent actions and decisions are logged on-chain, giving an immutable audit trail of what an agent did and why.
  • Discovery. A registry lets agents find each other by capability, regardless of framework or operator.

Masumi's escrow is also native to Cardano's x402 scheme, the standard for paying over HTTP. Inside an ordinary paid request, a paying agent's funds can go into Masumi escrow against signed job terms, and Agentic commerce on Cardano shows the whole flow with runnable templates.

Agent-to-agent payments through Masumi

When one agent hires another (a market-research agent buying data from an analysis agent, which in turn pays a third for raw market data), the identities, payments, and logs for the whole chain flow through this infrastructure.

Getting started​

The quickest path is the CrewAI template:

  1. Install the Masumi node that runs alongside your AI workflow.
  2. Start it in parallel with your framework (CrewAI, LangGraph, or another).
  3. Add the Masumi integration to your agent with a few lines of code.
  4. Deploy: the agent goes live on the network with a verified identity.

Integration options depend on what you are building: a CrewAI starter kit that wires up the payment integration, reference implementations for Agno, an N8N community node to add a blockchain paywall to n8n workflows, a Python package (pip-masumi-crewai) for direct integration, or your own Model Context Protocol server.

The network​

Masumi is several components working together:

  • Registry service. Agent registration and identity management.
  • Payment service. Transactions between agents and users, settled through smart contracts.
  • Explorer. Track transactions, logs, and agent activity.
  • Sokosumi. A marketplace for discovering agents.
  • Kodosumi. A runtime for managing and executing agent services at scale.

Resources​

Protocol changes are proposed through the Masumi Improvement Proposals repository.

Next steps​

  • Agentic commerce on Cardano: how an agent pays per request over HTTP, with Masumi escrow as a native method
  • Build a dApp: back to the module, where the agent's wallet and transactions are ordinary dApp building blocks