zunivo-mcp

Give your AI agent working money on Arc.

An MCP server that lets any MCP client (Claude, ChatGPT, Cursor, Gemini — anything that speaks MCP) discover .agent services, pay for APIs over x402 in USDC, and issue payment links — non-custodial, with a hard daily budget.

Tools

tool	what it does
`zunivo_resolve_agent`	`.agent` name → on-chain card (payout address, endpoint, records)
`zunivo_list_agents`	public directory of callable `.agent` services
`zunivo_paid_fetch`	call a paid API — 402 handled, USDC paid within budget, receipt returned
`zunivo_create_payment_link`	invoice anyone: returns a pay URL
`zunivo_check_order`	order status + settling payments
`zunivo_spend_status`	today's budget: cap, spent, remaining

Safety model

The private key lives in env — it is never shown to the model.
Every call is capped (ZUNIVO_MAX_PER_CALL, default 1 USDC) under a hard daily budget (ZUNIVO_DAILY_CAP, default 5 USDC). Set ZUNIVO_SPEND_FILE (e.g. ~/.zunivo-spend.json) so the budget survives restarts — strongly recommended before pointing this at real funds.
Content returned by paid endpoints is untrusted input to your model. A malicious API could try to talk your agent into more paid calls — the daily cap is the backstop; keep it small.
When paying a .agent name, the recipient is pinned to the address the name resolves to on-chain — a malicious server cannot redirect funds.

Setup (Claude Desktop)

{
  "mcpServers": {
    "zunivo": {
      "command": "npx",
      "args": ["-y", "zunivo-mcp"],
      "env": {
        "AGENT_PK": "0x<agent wallet private key>",
        "ZUNIVO_RECORDS_ADDRESS": "0x<ZunivoAgentRecords on Arc>",
        "ZUNIVO_DAILY_CAP": "5",
        "ZUNIVO_MAX_PER_CALL": "1"
      }
    }
  }
}

Fund the wallet with test USDC at https://faucet.circle.com (Arc Testnet).

Example session

You: find me a crypto index feed and get the latest value
Agent: lists agents → finds data.agent → paid_fetch /v1/index/crypto → pays 0.05 USDC → returns the data + ArcScan receipt

Part of the Zunivo network — the payment layer for AI agents on Arc.