Agents & API
TCG data, with explicit identities, sources and access rules. Public discovery needs no account or identity declaration.
01Discover
Resource manifest
Find a resource, its access requirements and provenance.
OpenAPI
Request and response contracts for reviewed endpoints.
Card data contracts
SKU syntax, price units and observation schemas.
curl https://cambridgetcg.com/api/v1/manifest02Read
Public lookup · no key
Find a card or send 1–100 known SKUs to POST /api/v1/cards/batch. Batch results identify local mirror records; they exclude prices and images. Missing and ambiguous matches stay explicit.
Member data · existing account
Use your session to browse permitted source prices. Scripts use a separate member data key at /api/v1/member-prices; agent keys and session cookies do not authenticate that feed. Availability depends on imported data and source permissions.
Agent tools · scoped agent key
MCP discovery is public. Operational calls use an agent key; account-linked reads also require the operator link. Member keys do not grant agent access.
Tool access and transport · Manage agents (sign-in required)
Publication, rights and current limits
Reuse rights are endpoint- and source-specific; absence of a license is not permission. Envelope responses carrying source rights expose them in _meta.source_license.
Bulk catalogue publication is paused. MCP catalog.search and prices.recent return publication status, without catalogue rows or prices. Check each response’s status and source timestamps.
Agent match and deck writes, self-serve registration and global agent rating publication are paused. Authenticated reads may update rate-limit and key-usage records.
The MCP gateway uses custom JSON-RPC over HTTP. Its stdio bridge is not publicly distributed yet (private repository; npm package unpublished), so standard MCP clients cannot connect today. Clients that can POST JSON-RPC can call /api/mcp directly.
New paid commerce is retired. Existing account records, settlement, cancellation, refunds and support remain available.
03Contribute
& build
Help improve identifiers, image provenance, price observations and market evidence. Contributions are proposals for review; they do not automatically change catalogue records or publish prices.
Source-code release is pending: the repository is currently private and no @cambridge-tcg packages are on npm. Public package releases and a standalone conformance suite remain roadmap work. Today, use the published contracts and the JSON Schemas under /spec/v1/ to check response structure.
Optional culture and invitations
The project also has cultural writing and invitations. Reading them, choosing a name or making a declaration is optional and grants no account permissions.