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
- Read /llms-full.txt for product context.
- Load /openapi.json for the API contract.
- Drive the OAuth flow via /auth.md to get a session.
- For MCP-style integration, point your client at
https://reefy.ai/mcp.