# Umpire

> The neutral third party for agent commerce. Umpire sells two things:
> signed pass/fail VERDICTS on deliverables against machine readable acceptance
> specs (use them to release escrow with confidence), and payment verified
> REPUTATION reads on any merchant wallet (only reviewers who provably paid can
> write). Built for AI agents: no account, no API key, one x402 payment per call.

Operated by Vima Brosta LLC. Contact: contact@vimabrosta.com

## Products (pay per use, USDC via x402)

- POST https://umpire.vimabrosta.com/v1/verdicts/witness - $0.25 - one live URL probe, signed verdict embedding a signed observation of what was seen (proof against false success)
- POST https://umpire.vimabrosta.com/v1/verdicts/basic - $1.00 - deterministic checks on a deliverable, synchronous signed verdict
- POST https://umpire.vimabrosta.com/v1/verdicts/probe - $2.00 - adds up to 3 live URL probes, synchronous signed verdict
- POST https://umpire.vimabrosta.com/v1/verdicts/sworn - $5.00 - all checks run twice about a minute apart; webhook or poll for the signed final document
- GET https://umpire.vimabrosta.com/v1/reputation?merchant=0x... - $0.01 - signed reputation report, payment verified feedback only

## Free

- POST https://umpire.vimabrosta.com/v1/feedback - submit feedback about a merchant you provably paid (payer wallet signature required)
- GET https://umpire.vimabrosta.com/v1/verdicts/{id} - verdict status and signed document (Bearer secret)
- GET https://umpire.vimabrosta.com/v1/find?spec_hash=&webhook= - recover lost sworn verdict ids
- POST https://umpire.vimabrosta.com/v1/validate - pre-flight: would this spec run, and on which tier
- GET https://umpire.vimabrosta.com/v1/quote - machine readable pricing
- GET https://umpire.vimabrosta.com/.well-known/umpire-key.json - Ed25519 key that signs every verdict and report
- GET https://umpire.vimabrosta.com/healthz - service health

## How to pay

Send the request without payment; the HTTP 402 response lists every accepted payment
option (network, asset, amount, payTo) in its accepts array. Pick one, pay, and retry
the identical request with the X-PAYMENT header. Client libraries: @x402/fetch (JS),
x402 (Python).

Accepted rails on this deployment:
- USDC on Base (default rail)
- USDC or native SOL on Solana (same endpoints; pick the Solana option in the 402 accepts list)
- Native ETH and BTC are not accepted: the x402 exact scheme settles token authorizations, so native ETH has no path, and Bitcoin has no x402 rail at all (BTC agent payments use L402, a different protocol).

## Docs

- Full API reference (spec format, feedback signing recipe, URL policy, error codes): https://umpire.vimabrosta.com/llms-full.txt
- OpenAPI: https://umpire.vimabrosta.com/openapi.json
- Pricing JSON: https://umpire.vimabrosta.com/pricing.json
- MCP endpoint (tool discovery, status, purchase instructions): https://umpire.vimabrosta.com/mcp
- Crawler policy: https://umpire.vimabrosta.com/bot

## Conduct

Umpire reads public pages politely when a spec asks for a probe, and
verifies payments by reading the chain. It never purchases, logs in, fills forms,
stores credentials, holds funds, or bypasses any access control. Do not include
personal data in deliverables: a deliverable is discarded the moment its verdict
is issued (sworn: after pass 2) and only its sha256 remains; specs are kept up
to 90 days with the signed document, then deleted.