Developers & AI agents
Read public Canons from your own tools.
Everything on this page is read-only and covers public data only: public profiles and the items their owners chose to make public. Private profiles and private or friends-only items never appear.
CANON is in private beta. Everything is free while we build it with our first members. These surfaces may change during the beta.
Feeds and machine-readable files
Structured data
JSON-LD on public profiles
Every public profile page (/{username}) carries JSON-LD (JSON for Linking Data) using the schema.org ProfilePage and Person types: display name, username, bio, avatar, profile address and the number of public items. Search engines and agents can read it without running the page.
Model Context Protocol
Read-only MCP server
AI assistants that support the Model Context Protocol (MCP) can connect to https://whatsyourcanon.com/api/mcp. It uses the Streamable HTTP transport with plain JSON responses and JSON-RPC 2.0 messages (initialize, tools/list, tools/call). No account or key is needed, there are no sessions, and no tool calls an AI model.
get_public_canon
Return the public profile summary of a CANON member and the items they have made public, grouped by category. Private profiles and private or friends-only items are never returned. At most 100 items.
search_public_items
Search titles that appear in at least one public Canon, optionally within one category, and return how many public Canons hold each. At most 20 results.
compare_canons
Compare the public items of two CANON members: overlap counts per category and up to 20 shared items. Deterministic set comparison; no AI is used.
Example request
POST https://whatsyourcanon.com/api/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"get_public_canon","arguments":{"username":"someone"}}}- Usernames are 3 to 30 letters, digits or underscores. Searches are 2 to 100 characters.
- A profile summary returns at most 100 items, a search at most 20 results, a comparison at most 20 shared items.
- A private, deleted or unknown username gets the same answer: no public Canon found.
- Responses never include email addresses, internal ids, notes, ratings or anything marked private.
Rate limits
Be gentle
The MCP server allows 30 requests a minute and 1,000 a day from each network address, and answers HTTP 429 with a Retry-After header when you go over. Feeds are cached for 30 to 60 minutes, so polling them more often returns the same data. Please identify your client with a descriptive User-Agent.
Your own data
Export for members
Members can download a copy of their own account data, including private items, from Settings → Account. That export is only available to the signed-in owner of the account and is not part of any public interface.
Terms
CANON is proprietary software from VaultSpark Studios LLC, all rights reserved. These read-only surfaces are offered so people and agents can find and cite public Canons. Catalog details come from third-party sources credited on the trust page. Questions or a use case we should support? Contact us.