Developer and agent resources

BoxOfChocolates.ai provides public, read-only REST and MCP interfaces for official organization and initiative information. They expose no private records, user accounts, write operations, medical uploads, GuardDog searches, or automated decisions.

REST API

• /api/v1 — versioned API index
• /openapi.json — OpenAPI 3.1 specification
• /api-versioning.md — lifecycle policy; no v1 deprecation is scheduled
• Authentication: none

MCP

• /mcp — Streamable HTTP endpoint
• /.well-known/mcp — Streamable HTTP discovery endpoint
• /.well-known/mcp/server-card.json — server identity and transport
• Read-only tools: get_organization, list_initiatives, and get_initiative

Discovery resources

• /llms.txt — concise agent navigation and use guidance
• /docs/llms.txt — scoped API and MCP index
• /.well-known/ai-catalog.json — Agentic Resource Discovery catalog
• /.well-known/api-catalog — RFC 9727 API catalog
• /.well-known/agent-skills/index.json — Agent Skills discovery index

Safety and versioning

The interfaces are versioned at v1 and return structured JSON errors. Initiative results include explicit safety boundaries. They are informational only: fcancer.ai is not diagnosis, and GuardDog is not a blacklist, consumer background check, or automatic adoption-decision engine.