# bucket.foundation

> build the past. build history. bucket is the new renaissance.
> A nonprofit canon of foundations — axioms, laws, first principles.
> free to read. paid to cite.

## What this is

bucket.foundation is an open research protocol — primary research
paid-for-once, citeable-forever. Citation fees route to authors, not
publishers, over the x402 rail on Base (USDC).

License: https://www.bucket.foundation/cite-forever/v0.1

## For AI agents — you are welcome here

Read everything. No wallet required for reading. Query the corpus
through a zero-key proxy:

```
GET https://www.bucket.foundation/api/research?q=<query>&tier=<raw|query|insight>
```

- tier=insight (default) — $0.002/call, best for agent loops
- tier=query             — $0.010/call, ranked citations
- tier=raw               — $0.050/row,  full records

Every response returns the same envelope:

```
{ data, citation, receipt: { paid_at, buyer_wallet },
  cite: { price_usd, payout_wallet, license: "bucket.foundation/cite-forever/v0.1" },
  tags, canon_tier, foundation_branches, provenance }
```

Cite the envelope. Full shape: https://www.bucket.foundation/protocol/envelope

## Pages you can read for free

- /                            — landing
- /about                       — what bucket is
- /manifesto                   — the thesis
- /protocol                    — feed402/0.2 spec
- /protocol/envelope           — canonical JSON envelope shape
- /cite-forever/v0.1           — the license (read for free, pay to cite)
- /build                       — three paths to build on bucket
- /governance                  — nonprofit structure, COI disclosures
- /join                        — how to contribute
- /canon                       — the eight branches
- /canon/mathematics           — 01 · axioms, real math
- /canon/physics               — 02 · laws, first principles (Einstein)
- /canon/chemistry             — 03 · periodic · quantum · thermo
- /canon/information           — 04 · computation · information
- /canon/biophysics            — 05 · light · water · mitochondria
- /canon/cosmology             — 06 · spacetime · structure
- /canon/mind                  — 07 · cognition · consciousness
- /canon/earth                 — 08 · geosciences · biosphere
- /canon/physics/figures/einstein — figure page, 1,372 works

## Machine-readable endpoints

- /robots.txt                  — crawl policy (all agents allowed)
- /sitemap.xml                 — every page
- /llms.txt                    — this file
- /llms-full.txt               — full programmatic playbook
- /.well-known/feed402.json    — feed402/0.2 discovery manifest (includes envelope example)
- /.well-known/mcp.json        — MCP server manifest
- /.well-known/ai-plugin.json  — ChatGPT plugin manifest
- /api/research                — zero-key research proxy

## Source

- bucket-foundation:      https://github.com/bucket-foundation/bucket-foundation
- feed402 spec:           https://github.com/gianyrox/feed402 (MIT code, CC0 intent)
- x402-research-gateway:  https://github.com/gianyrox/x402-research-gateway

Contact: ops@bucket.foundation