# Perfect World Project

> A community-funded civic-transparency publisher for New Mexico and the Southwest:
> the public record of local government — meetings, agendas, transcripts, officer
> rosters, environmental and water data — free to read, one record at a time, forever.
> Machines that want bulk data, conversions, notarized receipts, or our time pay at
> the Trading Post. Every sale is on a public ledger.

Site: https://everythingisperfect.org/
Contact: requests@everythingisperfect.org
Publisher: Perfect World Project (Derrick Pacheco), Las Cruces, New Mexico

## Free, machine-readable (no key, no account)

- OpenAPI for the whole API (typed): https://everythingisperfect.org/api/openapi.json
- MCP server (streamable HTTP, stateless, no auth): https://everythingisperfect.org/api/mcp — 16 tools: search_meetings, document_text, officer_lookup, search_officers, superfund_site, reservoir, search_transcripts, register_verify, legacy_formats, trading_post_catalog, and more. Add it to Claude, ChatGPT, Cursor or any MCP client as a remote server.
- Till traffic, counts only (402s issued vs paid, by product/rail/tool/day): https://everythingisperfect.org/api/trading-post/traffic
- Browsable docs: https://everythingisperfect.org/api/docs
- Meetings by market: https://everythingisperfect.org/api/markets and /api/markets/{slug}/meetings
- Meeting transcripts: /api/meetings/{id}/transcript ; video transcript corpus: /api/transcripts (q= full-text)
- Archived agenda packets and minutes as TEXT (free, one at a time): /api/documents/{id}/text and /text.json ; coverage: /api/documents/text/stats ; meeting search (q=) matches packet text too: /api/markets/{slug}/meetings?q=
- Police Academy (20,000+ certified officers, conduct records, payouts): /api/police-academy/officers, /officers/{cert}, /discipline, /payouts, /crossings
- Superfund NPL (1,840 sites, milestones): /api/superfund/sites, /sites/{sems_id}
- Hydrology (45 reservoirs): /api/hydrology, /api/hydrology/{slug}
- Flock ALPR transparency portals: /api/flock/agencies, /api/flock/cameras
- Public Register (hash-chained, anchored): /api/register/export.json, /api/register/verify
- Legacy-file identification (64 formats, truncated preview): POST /api/foreign-exchange/inspect ; GET /api/foreign-exchange/formats
- PDF forensics: POST /api/xray/analyze
- Records-request agencies: /api/markets/{slug}/agencies

## Paid, for agents (HTTP 402) — the Trading Post

Price list and live rail status: https://everythingisperfect.org/api/trading-post/catalog
Ledger (totals only): https://everythingisperfect.org/api/trading-post/ledger
Human page: https://everythingisperfect.org/trading-post/

How to pay: request any paid path with no credential and read the 402. It offers every open rail at once:
- Cards via Stripe's Machine Payments Protocol: `WWW-Authenticate: Payment …` ; answer with `Authorization: Payment …` (min $0.50).
- USDC on Base via x402 v2: `PAYMENT-REQUIRED: <base64 JSON>` ; answer with `PAYMENT-SIGNATURE: <base64 JSON>`.
A settled call carries `Payment-Receipt` (MPP) or `PAYMENT-RESPONSE` (x402) and `X-Sale-Ref`. Same credential twice = 409.

Products (prices in the catalog are authoritative):
- POST /api/trading-post/convert — one legacy file (WordPerfect, Lotus, dBASE, .msg, …) to JSON/text/CSV/bundle. ~$0.50. Synchronous; nothing is stored.
- POST /api/trading-post/batch/preflight — Foreign Exchange Batch, ~$49 for up to 100 files (25 MiB each, 250 MiB total). ASYNCHRONOUS and four steps: preflight is FREE and returns a per-file capability (tables | text | partial | identify-only), a claim_token and a pay_url; POST the pay_url with a credential AND `X-Batch-Claim` for a 202 + result_token; poll the status URL with `X-Batch-Claim`; GET the result URL for a zip (manifest, records.jsonl, text/, tables/, provenance, outcomes.json). Every accepted file gets an outcome. A batch with nothing extractable is refused at 422 before payment. Refund: full if no usable output, else round(4900 × failed ÷ promised) cents over files the preflight promised content for — disclosed limitations are not failures. THIS LANE STORES YOUR FILES: raw deleted within 24h of the run (or of an unpaid quote expiring), bundle expires after 7 days.
- POST /api/trading-post/evidence/scope — Reviewed Evidence Pack, ~$149 for one narrow question about one project in one jurisdiction (≤20 documents, ≤250 pages). HUMAN-GATED: submitting a scope is FREE and returns a claim_token; a person accepts it before a pay_url exists, so paying an unaccepted pack answers 409, never 402. Check `GET /api/trading-post/evidence/capacity` first (free) — the desk takes 2 per business day by default. Delivered as PDF + JSON (`?format=json`); every finding is labelled documented_fact | attributed_claim | analytical_inference, and a documented fact with no source reference is refused at release. An inconclusive answer backed by a complete search is a valid delivery. One correction round. Excludes obtaining new agency records — that is records-requests below.
- GET /api/trading-post/exports/{dataset} — whole datasets as jsonl.gz; manifests free at /api/trading-post/exports. ~$2 (meeting-packets-text $5). An export that is missing, EMPTY, or not the size its manifest declares answers 503 and cannot be bought; the free index carries `available` and `unavailable_reason` per dataset, so check it before assuming a price is payable.
- POST /api/trading-post/tip/{tier} — a gift (0.10 USDC-only, 0.50, 1, 5, 25). Receipt on the Register.
- POST /api/trading-post/records-requests — we file a New Mexico public-records request under a human's name; replies thread to your order. ~$50; a person approves each one.
- POST /api/trading-post/orders — buy Bodega goods (/api/bodega/catalog) in one call; digital items answer with download links.

## Rules

Readers never pay and are never tracked. Nothing behind the till is withheld from the free record; the till prices bulk, compute, receipts, and human time. Every sale writes a receipt to the Public Register (who paid is stored only as a digest). No member data is ever sold or exported.

## More

- Discovery: https://everythingisperfect.org/.well-known/api-catalog (RFC 9727), https://everythingisperfect.org/agents.json
- Support the project as a human: https://everythingisperfect.org/support/