Atisbo Developer Resources
Everything needed to build on Atisbo — the API specification, the MCP server coding agents connect to, machine-readable briefs of this site, and the discovery files that advertise all of it. Most surfaces are served by the product origin, app.atisbo.dev; each link below names where it actually answers.
API
- OpenAPI specification
- OpenAPI 3.1 document describing the unauthenticated API surface: health, version, demo workspace provisioning, the landing-visit beacon and the MCP JSON-RPC envelope.
- MCP server endpoint
- JSON-RPC 2.0 over HTTP (Streamable HTTP transport). Requires an API key sent as Authorization: Bearer <key> — see the auth guide for how to get one.
- auth.md
- How an agent obtains and uses a credential: create an account, generate an MCP API key in Settings, call the MCP endpoint, handle the 401 error shape, revoke.
- Protected Resource Metadata (.well-known/oauth-protected-resource)
- RFC 9728 metadata for the MCP endpoint: resource identifier, bearer method and the scopes a key carries. Declares no authorization_servers — Atisbo runs no OAuth issuer; the 401 challenge on the MCP endpoint names this document.
- Documentation MCP server
- Read-only MCP server over the documentation corpus — search_docs, get_doc and list_docs over JSON-RPC 2.0. Unauthenticated and rate-limited; the product MCP server (above) is the one that acts on a workspace.
- NLWeb ask endpoint
- NLWeb-protocol endpoint: POST (or GET ?query=) a natural-language question, get the relevant documentation back as JSON with _meta, or as SSE (start/result/complete). Retrieval over the real docs corpus — no generation, no LLM in the path.
Docs & guides
- llms.txt
- Short brief for language models: what Atisbo is, who it is for, prices and where to read more. Generated from the same constants as the site itself.
- llms-full.txt
- The full-length brief — the whole documentation corpus arranged for a model context window.
- Documentation
- Product documentation: concepts, evidence sources, integrations and the agent workflow.
- Atisbo agent skills repository
- Public repository of Atisbo skills for coding agents — installable with any Agent Skills compatible client.
Agent surfaces
- MCP manifest (.well-known/mcp.json)
- MCP discovery manifest: endpoint, transport and auth type.
- MCP server card (.well-known/mcp/server-card.json)
- Server card: name, version, tools and the skills the server advertises.
- Agent Skills index (.well-known/agent-skills/index.json)
- Index of published Atisbo skills for Agent Skills compatible clients.
- Agentic Resource Discovery catalog (.well-known/ai-catalog.json)
- ARD catalog listing what Atisbo offers agents, with urn:air identifiers.
- A2A agent card (.well-known/agent-card.json)
- A2A protocol card: capabilities, authentication scheme and skills.