ERGO
Back to demos
MCP demo

Paid MCP Tool

A model calls a paid tool, receives a payment challenge, completes the task and returns an Accord receipt bundle.

Open MCP flowAgent metrics

Status

Prototype

Prototype

The demo shows how agent tools can price work without turning payment into the only thing that matters.

Flow

What happens

  1. 1Agent discovers a paid MCP tool.
  2. 2Tool returns price, policy and Agreement requirements.
  3. 3Agent accepts or refuses according to buyer policy.
  4. 4Tool executes only after the mock payment condition is satisfied.
  5. 5The result is paired with verification and settlement receipts.

Receipt shape

Fields to inspect

toolName
toolCallHash
buyerPolicyDecision
paymentReference
verificationReceipt
settlementReceipt

Run modes

Mock

Available first

No wallet needed. The tool simulates payment acceptance and receipt generation.

Policy

Planned

Buyer policy will enforce spending caps, tool allowlists and approval thresholds.

Safety rules

Tool execution must be idempotent around retries.

Agent policy decides before payment is attempted.

Receipts must not leak private prompt content.

Prototype event stream

What becomes live

Connect MCP tool execution to the prototype event stream, then promote only signed receipts to live counters.

agreement.createdverification.accepted

API preview

Open JSON
curl https://www.ergoblockchain.org/api/agent-economy/events

This endpoint is prototype telemetry. It is intentionally separate from live usage counters until demos emit signed receipts.

Expected JSON

Demo output shape

No mainnet
{
  "tool": "repo.audit",
  "price": "0.01 ERG",
  "policyDecision": "approved",
  "verificationReceipt": { "status": "accepted" }
}