Reefy for developers

API + agent surfaces

• OpenAPI 3.1 spec for the dashboard API: /openapi.json
• MCP server card: /.well-known/mcp/server-card.json
• MCP JSON-RPC endpoint: /mcp (POST)
• NLWeb /ask natural-language Q&A: /ask (POST)
• A2A Agent Card: /.well-known/agent-card.json
• API catalog (RFC 9727): /.well-known/api-catalog

Documentation

• /llms.txt - short product summary for crawlers
• /llms-full.txt - long-form reference with code examples
• /auth.md - auth + versioning + error semantics for agents
• /agents.md - when-to-use guidance for AI assistants

OAuth + identity

• /.well-known/oauth-protected-resource (RFC 9728)
• /.well-known/oauth-authorization-server (OIDC discovery + agent_auth block)

Source repos

• reefyai/reefy - firmware + OS
• reefy-llm-proxy - OpenAI-compatible BYO subscription gateway
• reefy-qr-access - door access app
• reefy-service - dashboard backend

Quick start for an agent

1. Read /llms-full.txt for product context.
2. Load /openapi.json for the API contract.
3. Drive the OAuth flow via /auth.md to get a session.
4. For MCP-style integration, point your client at https://reefy.ai/mcp.