Developer & Agent Documentation

Machine-readable discovery endpoints for AI agents, MCP clients, and API integrators. Canonical origin: https://www.seanguillermo.com

Discovery endpoints

• OpenAPI 3.x

  Contact and newsletter REST APIs — /openapi.json

• API Catalog (RFC 9727)

  JSON catalog of public APIs — /.well-known/api-catalog

• MCP Server Card

  SEP-1649 discovery for /api/mcp — /.well-known/mcp/server-card.json

• A2A Agent Card

  Agent2Agent capability manifest — /.well-known/agent-card.json

• agents.json

  Directory of agent endpoints — /.well-known/agents.json

• AI Catalog

  URN:AIR discovery entries — /.well-known/ai-catalog.json

• Agent Skills Index

  Verifiable SKILL.md directory — /.well-known/agent-skills/index.json

• AGENTS.md

  Root agent guide and etiquette — /AGENTS.md

• llms.txt

  LLM-friendly site map — /llms.txt

• auth.md

  OAuth and agent authentication — /auth.md

MCP transport

Streamable HTTP endpoint at /api/mcp. Tools: submit_contact, list_insights. OAuth metadata at /.well-known/oauth-authorization-server.

Contact the team