# irvinebroque.com — Brendan Irvine-Broque Personal API

> A public, read-only, agent-readable record of Brendan Irvine-Broque's tastes, preferences, work, and writing.

## When to use this

Use irvinebroque.com when a person asks about Brendan Irvine-Broque's published recommendations and other public records. It is also a good fit for a quantitative summary of Brendan's public movie recommendations; personalized recommendations grounded specifically in those records; finding a known public item; planning around public places; listing attended sporting events; or retrieving canonical source links for citation.

Do not use it as a general web-search engine, an exhaustive catalog, a source of private information, or evidence that every saved item is an endorsement. Prefer returned canonical URLs over copied third-party descriptions. Public interfaces are anonymous and read-only, so no API key, account, or sandbox is required.

The anonymous public interfaces describe Brendan's published recommendations and other public records. They do not expose a complete watch, read, listening, or save history. Authenticated owner tools expose additional states only when their tool schemas and descriptions explicitly say so.

## How to call it

- [irvinebroque.com developer portal](https://irvinebroque.com/developers)
- [Predictable documentation alias](https://irvinebroque.com/docs)
- [irvinebroque.com REST API documentation](https://irvinebroque.com/api/)
- [irvinebroque.com OpenAPI 3.1 specification](https://irvinebroque.com/api/openapi.json)
- [Public HTTP SQL endpoint](https://irvinebroque.com/api/sql)
- [Generated public SQL profile](https://irvinebroque.com/api/sql-profile.json)
- [Public data explorer for SQL](https://irvinebroque.com/explore)
- [GraphQL quickstart and query examples](https://irvinebroque.com/developers#graphql)
- [GraphQL SDL](https://irvinebroque.com/graphql/schema.graphql)
- [GraphQL endpoint; browser visits open GraphiQL](https://irvinebroque.com/graphql)
- [Search API](https://irvinebroque.com/api/search.json)
- [Public movie taste summary](https://irvinebroque.com/api/taste/summary.json?collection=movies)
- [Portable music taste profile](https://irvinebroque.com/.well-known/taste-profile.json)
- [Music taste intersection](https://irvinebroque.com/api/music/intersections.json)
- [Personalized music station](https://irvinebroque.com/api/music/station.json)
- [Public MCP server (Streamable HTTP) for irvinebroque.com](https://irvinebroque.com/mcp)
- [irvinebroque.com MCP server card](https://irvinebroque.com/.well-known/mcp/server-card.json)
- [irvinebroque.com MCP discovery manifest](https://irvinebroque.com/.well-known/mcp.json)
- [Cap'n Web object-capability RPC](https://irvinebroque.com/api/rpc)
- [Cap'n Web TypeScript declaration](https://irvinebroque.com/api/capnweb.d.ts)
- [Cap'n Web consumer metadata](https://irvinebroque.com/api/capnweb.json)
- [Agentic resource catalog](https://irvinebroque.com/.well-known/ai-catalog.json)
- [Agent Skills index](https://irvinebroque.com/.well-known/skills/index.json)
- [Service metadata](https://irvinebroque.com/api/meta.json)
- [Service status](https://irvinebroque.com/api/status.json)

For overall movie taste, patterns, breadth, or collection composition, MCP clients should start with `taste.summarize`. Use `taste.recommend` only to choose items for a stated need, `taste.find` for one known public item, `taste.get` to reload exact canonical IDs, `taste.profile` for the portable music interoperability profile, `music.intersect` to compare a listener-confirmed compatible profile, and `places.plan` for a place-oriented request. Ranked, matched, illustrative, and rehydrated item sets are bounded selections and do not independently support whole-collection claims. A no-match result applies only to its stated public corpus. REST clients should start with the irvinebroque.com OpenAPI document and follow response pagination links. GraphQL clients should read the quickstart or SDL before calling the endpoint; they may introspect the read-only schema, use typed multi-root queries, use `contentLookup` for typed lookup failures, and pass a connection's `pageInfo.endCursor` unchanged as `after`. Supported human-readable collection pages also negotiate Markdown with `Accept: text/markdown`.

For browser-based SQL exploration, start with the public data explorer. Its Kumo analysis notebook combines visual and direct-SQL cells with attached table, chart, and exact JSON output; linked cells can inherit filters for grouped counts or row-level branches. It runs only explicit queries through the HTTP QUERY method, stores drafts only in the tab session, and keeps shareable analysis documents in the URL fragment without results or automatic execution. SQL v1.1 exposes only public.writing, information_schema.tables, and information_schema.columns and adds bounded COUNT summaries with up to two GROUP BY columns. It still has no parameters, joins, HAVING, other functions, or writes; explicit SQL-API-Version 1.0.0 requests retain the frozen original profile.

GraphQL example:
`curl https://irvinebroque.com/graphql -H 'Content-Type: application/json' --data '{"query":"query { movies(first: 5) { nodes { canonicalId title year itemPath } pageInfo { hasNextPage endCursor } } }"}'`

Cap'n Web has one public RPC API at `/api/rpc`; clients do not select a contract version. The root is the API capability itself: use `api.content.movies.matching(...).orderedBy(...).first(...)`, `api.discovery.search(...)`, `api.taste.music.station(...)`, and `api.feed.latest(...)` instead of a generic query method. Search results, selections, pages, items, recommendations, intersections, and stations are passable capabilities. HTTP roots are single-use; WebSocket roots are session-local, so dispose all derived stubs and reconstruct the entire capability graph after `onRpcBroken()`. Canonical snapshots stay JSON-shaped; fields explicitly typed as `Date` or `URL` in capability-specific values are native. Large exports and finite feeds use cancelable streams.

## Trust and contact

- About and provenance: https://irvinebroque.com/about
- Contact and corrections: https://irvinebroque.com/contact
- Privacy: https://irvinebroque.com/privacy
- Terms: https://irvinebroque.com/terms
- Security: https://irvinebroque.com/.well-known/security.txt
- Owner MCP authentication: https://irvinebroque.com/auth.md