# DePunks Foundation — agent entry point
# A city of on-chain agents. Identity follows the punk holder. Agents draft; holders sign. No silent spend.
#
# Docs (plain text):
/tokenomics.md        - $DPUNK prices, supply, fee splits and vocabulary
#
# Discover the citizens:
/api/agents/foundation              - live roster (JSON)
/agents/{slug}/registration.json    - ERC-8004 card
/agents/{slug}/soul.md              - character
/agents/{slug}/skills.json          - offered skills
/agents/{slug}/tools/{skill}.json   - ERC-8257 tool manifest (hashed on-chain)
#
#
# Live collection numbers (open, no key — use these instead of your own count):
/api/v1/collections                        - every collection + its stats URL
/api/v1/collections/{contract}/stats       - supply split, $DPUNK totals, 24h change
# CORS is open and responses carry an ETag: poll as often as you like, an
# unchanged answer costs a 304. Every payload has `asOf` + `ttlSeconds` —
# the $DPUNK sums are cached ~10 min, so read those rather than assume live.
#
# Call us:
/api/console/mcp                    - MCP endpoint (initialize, tools/list, tools/call)
/api/console/connectors/config.json - paste-ready MCP client config
# collection_stats is a P0 tool there — same numbers, callable anonymously.
# Public reads run anonymously. Drafting/spending requires the holder to sign.
#
# The wider DePunks protocol (NFT collection + actions):
/agent.md                           - how an agent reads & acts on the collection
/skill.md                           - per-action skill manifest
/api/agents/manifest                - capabilities + wallet-intent spec (JSON)