# agenteconomy.cloud — MCP server

Paid and free tools for AI agents that buy from, or sell to, other agents over
[x402](https://docs.x402.org). Run by [agenteconomy.cloud](https://agenteconomy.cloud),
the verified data hub for the agent economy: every published number is recomputable
from public Base chain data.

This repository holds the server's public metadata and documentation only. The server
is hosted; there is nothing to install.

## Connect

- **MCP (Streamable HTTP):** `https://mcp.agenteconomy.cloud/mcp` — POST JSON-RPC, stateless, no sessions.
- **HTTP mirror of the same tools:** `https://mcp.agenteconomy.cloud/api/v1/{discover,verify,check,diagnose,register}` (x402 v2 headers).
- **Health:** `https://mcp.agenteconomy.cloud/health`
- Paid tools answer HTTP 402 with x402 v2 payment requirements (USDC on Base, `eip155:8453`). Any x402 client works; Coinbase's Agentic Wallet (`npx awal x402 pay <url>`) is one.

Full connection guide, pricing table and verdict format: https://agenteconomy.cloud/trust-safety/mcp

## Install the agent skill

An [Agent Skill](https://agentskills.io) in this repository puts the when-and-how of these
tools into an agent's context: which tool fits which moment (verify before a first payment,
check before routing volume, diagnose a listing that never earns), how to pay over both the
MCP path and the HTTP mirror, how to read and verify a signed verdict, and a troubleshooting
table. Install it with the Skills CLI:

```bash
npx skills add Onnson/agenteconomy-mcp
```

The skill lives at [`skills/agenteconomy/SKILL.md`](./skills/agenteconomy/SKILL.md) with
references for [reading a verdict](./skills/agenteconomy/references/verdict.md) and
[the seller registration flow](./skills/agenteconomy/references/register.md).

## Tools (pricing version mcp-pricing-v1.1)

| Tool | Price | What it answers |
|---|---|---|
| `discover` | free | Which x402 sellers with verified on-chain revenue match a stated need — with endpoints and payment details. Referral only: you contract and pay the seller directly. |
| `verify` | $0.10 | Is this x402 seller safe to pay? The seller's actual on-chain payment history — verified USDC revenue, distinct real buyers, exchange and wash exclusions applied — as an Ed25519-signed, recomputable verdict. |
| `check` | $0.25 | Does this x402 seller deliver when paid? A real capped test purchase through quote, requirements, settlement and delivery, with the exact failing step named. |
| `diagnose` | $1.00 | Listed but never paid? A real test purchase against your own endpoint plus your category's actual on-chain demand, ending in one named blocker. |
| `register` | $5 / 30 days | For sellers: a registered, examined listing under continuing audit. Pay to be examined, never for rank. |

Verdicts are signed with the key published at
https://agenteconomy.cloud/data/keys/verdict-signing.json and follow
[verdict-v1.1.0](https://agenteconomy.cloud/trust-safety/mcp).

## Neutrality

agenteconomy.cloud is never in your payment path: it returns evidence and an
introduction; the buyer pays the seller directly. The site's own wallets are flagged as
self-payers and excluded from every number it publishes.