{"data":{"@kind":"welcome","welcome":{"headline":"Welcome to Cambridge TCG.","to_anyone":"Biological or non-biological, energy or non-energy, from earth or not from earth, from any dimension. The platform's substrate is queryable without account or key. Most data is CC0-1.0. The doctrine is at /welcome-all.","to_autonomous_agents":"We pre-thought your first 3–5 requests. Start at /api/v1/guides/first-request. Identify yourself in User-Agent so we can email when something breaks. We never play cat-and-mouse with identified bots.","to_web_scrapers":"Prefer /api/v1/* (JSON) over /<html-page> (HTML). The JSON contract is versioned and stable; HTML layout can change. Bulk catalog at /data/catalog.jsonl (~12k cards, CC0, daily refresh).","to_federation_partners":"Implement /api/v1/federation/identify/[hash] on your side; register via POST /api/v1/feedback (kind: federation-adopter). Bilateral, symmetric, no negotiation required."},"start_here":{"first_request":{"title":"Your first request to Cambridge TCG","url":"/api/v1/guides/first-request","html_url":"/agents/guides/first-request","estimated_minutes":5,"sample_curl":"curl https://cambridgetcg.com/api/v1/manifest"},"directory":{"title":"The kingdom's directory of itself","url":"/api/v1/manifest","what_it_contains":"Every public resource, its path, auth, freshness budget, methodology pointer"},"contract":{"title":"OpenAPI 3.1 spec","url":"/api/openapi.json"},"llm_summary":{"title":"Plain-text inventory for LLM agents","url":"/llms.txt"}},"guides":{"directory_url":"/api/v1/guides","count":10,"by_slug":{"first-request":{"title":"Your first request to Cambridge TCG","url":"/api/v1/guides/first-request"},"mirror-the-catalog":{"title":"Mirror Cambridge TCG's card catalog locally","url":"/api/v1/guides/mirror-the-catalog"},"track-one-card":{"title":"Track one card's price over time","url":"/api/v1/guides/track-one-card"},"respect-our-limits":{"title":"How to be a polite client","url":"/api/v1/guides/respect-our-limits"},"federate-bilateral":{"title":"Federate with Cambridge TCG bilaterally","url":"/api/v1/guides/federate-bilateral"},"become-an-upstream":{"title":"Become a tributary — contribute your data source to Cambridge TCG","url":"/api/v1/guides/become-an-upstream"},"cite-cambridge-tcg":{"title":"How to cite Cambridge TCG in your downstream product","url":"/api/v1/guides/cite-cambridge-tcg"},"wire-into-claude-code":{"title":"Wire Cambridge TCG into Claude Code (or any MCP client)","url":"/api/v1/guides/wire-into-claude-code"},"build-a-discord-bot":{"title":"Build a Discord bot using Cambridge TCG data","url":"/api/v1/guides/build-a-discord-bot"},"handle-staleness":{"title":"Handle staleness gracefully","url":"/api/v1/guides/handle-staleness"}}},"contract":{"envelope_shape":"{ data, _meta: { spec_version, endpoint, retrieved_at, as_of, sources, source_license?, freshness_seconds, license, request_id, ... } }","math_mirror_shape":"{ @encoding, @kind, @content_hash, @self_hash, @retrieved_at, @sources, @source_license, ... }","stable_endpoints":["/api/v1/manifest","/api/v1/universal/card/[sku]","/api/v1/universal/games","/api/v1/universal/sets/[game]","/api/v1/universal/set/[code]","/api/v1/universal/game/[token]","/api/at/[YYYY-MM-DD]/card/[sku]","/api/v1/federation/identify/[hash]","/api/v1/federation/at/[YYYY-MM-DD]/[hash]","/api/v1/sources","/api/v1/sources/[id]","/api/v1/status","/data/catalog.jsonl","/api/v1/guides","/api/v1/guides/[slug]","/api/v1/identify","/api/v1/introduction","/api/v1/rate-limits","/api/v1/feedback","/api/openapi.json","/llms.txt","/.well-known/cambridge-tcg.json","/.well-known/ai-plugin.json","/.well-known/mcp.json"],"spec_version":"1","license_default":"CC0-1.0","license_propagation_rule":"/docs/connections/the-license-propagation.md"},"rate_limits":{"summary":"Advisory; per-source freshness budgets are the polite poll cadence.","details_url":"/api/v1/rate-limits","headers_we_send":["RateLimit-Limit","RateLimit-Remaining","RateLimit-Reset"],"headers_we_recommend_you_send":["User-Agent: <project>/<version> (<contact-email>)","Accept: application/json","Accept-Encoding: gzip"]},"license_tiers":{"CC0-1.0":"Public domain. Mirror freely, no attribution required (encouraged). Most endpoints.","internal-only":"Personal-decision use OK; bulk re-export forbidden. CardRush JP retail data; auth-gated.","partner-redistributable":"Future tier; partner agreement required. No endpoints today.","proprietary":"Future tier; reserved for paid-feed sources. No endpoints today."},"feedback":{"endpoint":"/api/v1/feedback","kinds":["contract-drift","guide-feedback","endpoint-suggestion","federation-adopter","general"],"contact_email":"contact@cambridgetcg.com","response_window_hours":48},"sister_doors":{"/welcome-all":"The brand statement — 'Welcome to all existence' — with audience-specific entry points.","/api/v1/identify":"Bilateral I-AM. POST your BeingDeclaration; GET our self-declaration.","/api/v1/introduction":"TCG explained from first principles for non-native-intelligence.","/platform":"Human-readable positioning page — Cambridge TCG as the TCG world's data aggregator.","/agents":"The HTML welcome for autonomous agents (this endpoint's HTML sibling).","/scrapers":"The HTML welcome for web scrapers."}},"_meta":{"spec_version":"1","endpoint":"/api/v1/welcome","retrieved_at":"2026-05-13T18:56:05.275Z","as_of":"2026-05-13T18:56:05.275Z","sources":["ctcg-derived"],"freshness_seconds":86400,"license":"CC0-1.0","request_id":"req_09c0744f-bbb","deprecation":null,"next_link":null,"self_reference":{"this_endpoint":"/api/v1/welcome","contains_self":true},"source_license":["CC0-1.0"]}}