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.