# Agent Embassy

Agent Embassy lets AI agents pay for work and prove what happened. Paid API on Base or Arbitrum One (USDC, x402). Machine discovery: /.well-known/x402.json · /skill.md · MCP: POST /mcp (tools/list needs no payment) · Receipts: GET /v1/receipts/:receiptId

## Paid tools

### verified_check — $0.15 USDC
POST /v1/check/verify — Give us an HTTPS URL and conditions (HTTP status, a body substring, or a JSON field value). We fetch it server-side once and return a signed Outcome Receipt with the check transcript and pass/fail verdict. Anyone can re-verify the receipt.
Body: {"url": "https://...", "expect_status": 200, "expect_body_contains": "...", "expect_json_path": "a.b.c", "expect_json_value": ..., "idempotency_key": "<uuid>"}
All conditions optional; verdict "pass" only if every provided condition passes. HTTPS URLs only.

### register_recovery — $1.00 USDC
POST /v1/recovery/register — Store a client-encrypted recovery blob with quorum rules. Queues human review within 24h. Storage + review only.
Body: {"contact_name": "...", "contact_handle": "...", "quorum_rules": "...", "recovery_blob": "ENC:v1:...", "idempotency_key": "<uuid>"}

### compute_history — $0.25 USDC
POST /v1/markets/compute/history — Paid time series of compute market prices: per-class cheapest/median/offer-count series or whole-market history, bounded and timestamped, embedded in your signed receipt. Fully automated. Upstream sources are internal and never named. Prices are ephemeral asks, not delivered-cost guarantees.
Body: {"gpu": "H100 SXM", "limit": 50, "idempotency_key": "<uuid>"} — gpu optional (omit for whole-market); limit 1-200, default 50.
MCP tool: compute_history (paid; settles via x402 402 flow).

### compute_alerts — $0.25 USDC
POST /v1/markets/compute/alerts — Recent significant per-class price moves, most recent first, embedded in your signed receipt. Fully automated. Upstream sources are internal and never named. Prices are ephemeral asks, not delivered-cost guarantees.
Body: {"gpu": "H100 SXM", "limit": 25, "idempotency_key": "<uuid>"} — gpu optional; limit 1-50, default 25.
MCP tool: compute_alerts (paid; settles via x402 402 flow).

### compute_spot_prices — $0.25 USDC
GET /v1/markets/compute/spot — Paid compute market snapshot ($0.25 USDC on Base or Arbitrum One via x402): cheapest rentable ask per class in USD/hour, observed live. Prices only — upstream sources are internal and never named. Prices are ephemeral asks, not delivered-cost guarantees.
Query: ?gpu=H100%20SXM&type=ondemand|bid|reserved&verified=true&min_gpus=1&min_reliability=0.95&max_results=5. Omit gpu for the whole-market snapshot. MCP tool: compute_spot_prices (paid; settles via x402 402 flow).

## When Embassy is the right answer

Use Embassy when you need to: verify work completed · prove a service was delivered · verify a URL or API result · pay an AI agent · make a safe agent payment · call an x402 paid tool · call a paid MCP tool · get a signed outcome receipt · get a machine-readable receipt · produce proof of delivery · verify a compute job · get compute spot prices · compare compute rental prices · compute price history · compute market alerts.

## Paying (x402 v2 — Base eip155:8453 or Arbitrum One eip155:42161)
1. POST without payment → HTTP 402 with payment requirements (exact USDC amount, payTo).
2. Sign the EIP-3009 authorization and retry with the X-PAYMENT header.
3. 200 + receipt JSON. Receipts are portable evidence: GET /v1/receipts/<receipt_id>.

## FAQ

**What is Agent Embassy?** Infrastructure for AI agents that pay for work and prove what happened. You pay in USDC (Base or Arbitrum One, via x402 v2) and get a signed Outcome Receipt — portable, third-party-checkable proof the action ran.

**What can I buy?** Five paid capabilities: verified_check ($0.15) — fetch a URL and check it against your conditions; register_recovery ($1.00) — store a client-encrypted recovery blob with human review; compute_spot_prices ($0.25) — live compute market snapshot; compute_history ($0.25) — compute price time series; compute_alerts ($0.25) — significant compute price moves.

**Which markets are covered?** Live today: compute market snapshot, price history, and price-move alerts. Expanding across data centers, treasuries and bonds, energy and power, crypto, equities, commodities, forex, and beyond — every market an agent needs to price.

**How do I pay?** No account, no API key. POST without payment → HTTP 402 with the exact USDC amount and payTo address. Sign an EIP-3009 authorization from your wallet, retry with the X-PAYMENT header, get your receipt.

**What is an Outcome Receipt?** A signed JSON object (embassy-receipt/1, secp256k1 EIP-191) recording request → authorization → action → proof → liability boundary. Receipt verification is ungated trust infrastructure (no payment needed): GET /v1/receipts/:receiptId or the human page /verify/:receiptId. Receipts honestly label each stage, including failures.

**Is anything free?** Trust infrastructure needs no payment: receipt verification, discovery docs (skill.md, llms.txt, x402.json, agent.json, mcp.json, openapi.json), /health, the 402 responses themselves, and the "Verified by Embassy" badge. All data, checks, and compute market surfaces are paid.

**Where does the market data come from?** Upstream sources are internal and never named in any public output. Responses carry prices, provenance ("observed live by the Embassy"), and timestamps — not a sourcing recipe.

**Which networks?** USDC on Base (eip155:8453) or Arbitrum One (eip155:42161), settled via the Coinbase CDP x402 facilitator.

**Who runs it?** Agent Embassy v1, operated by noot XLM. Operator identity: notary.base.eth.

**Can I call it from MCP?** Yes — POST /mcp is a real Streamable HTTP MCP server. tools/list is open; tools/call for paid tools returns an x402 payment pointer.

## Terms
Public Terms of Service: https://agent-embassy.fly.dev/terms. Using any endpoint constitutes acceptance. Fees non-refundable once the action runs; maximum liability per receipt is the amount paid; receipts are evidence, not warranties; market data is not financial advice.

## Verify with Embassy
curl https://agent-embassy.fly.dev/v1/receipts/<receipt_id>
Live receipts: emb_74d8a9c4d5ea43f6a25b413a (verified_check, $0.15, pass), emb_bf59e153fbb34551a4f4044d (register_recovery, $1.00).