Contributing

MCP docs content lives in the website repo under mcp-docs/.

Roadmap vs this site: vision, pricing drafts, and launch strategy stay on roadmap.feelyourprotocol.org. User-facing connect guides and “what to ask” stay under mcp-docs/use/. See the short note on Roadmap vs MCP Docs.

Structure

Section	Path	Audience
Use	use/	End users and agents — capabilities, tools, connection
Internals	internals/	Us and deep-divers — architecture, engine API, quality, deploy

When a capability ships:

1. Add or update a page under use/tools/ (generic MCP tool reference)
2. Add or update use/eips/eip-NNNN.md for every live website exploration — Runnable or Planned (human catalogue — prompts, twins; not demo bytecode). Runnable engine modules also update the live catalog in use/coverage.md.
3. Add or update use/forks/<id>.md when a named fork catalog row changes (generic hardfork runs — Glamsterdam, Fusaka, Pectra). Link new twins from that fork page.
4. Update use/coverage.md (the human EIP index). Do not add per-EIP rows to the VitePress sidebar. Landing on mainnet does not remove the twin; keep it on Coverage and the fork page.
5. Update internals/execution-engine or internals/gateway as needed
6. Add a changelog entry on the affected page
7. Update public/llms.txt and public/llms-full.txt

use/ is the hosted product. Do not document local stdio, Cursor mcp.json, or self-host setup on user-facing pages. Build steps belong in GitHub READMEs and internals/ (development transport), not as a public early-access path.

Builder invariants for engine/gateway code: mcp-execution-engine/AGENTS.md, mcp-gateway/AGENTS.md.

See Quality for test and lint commands.

Changelog

Contributing Changelog

1. v0.92026-10-01Roadmap split note — strategy on roadmap site, product docs on use/.
2. v0.82026-09-17Twins stay after mainnet activation; do not drop Coverage or fork-page rows.
3. v0.72026-09-17EIP pages stay off the sidebar — index them on Coverage and the matching fork page.
4. v0.62026-09-16Named-fork catalogue pages under use/forks/ when fork capability rows change.
5. v0.52026-09-02use/ documents the hosted product only — no self-host early access.
6. v0.42026-08-27EIP catalogue under use/eips/; link to engine/gateway AGENTS.md for builders.
7. v0.32026-07-20Contributing page under internals/.