# Dribba — developer portal

> Map of every surface dribba.com exposes to machines, and when to use which.
> Scoped index for the developers area; whole-site index at https://dribba.com/llms.txt.

Last-Updated: 2026-08-22

## Surfaces, and what each is for

- [REST API](https://dribba.com/api/v1) — structured data with a stable shape. Scoped index: <https://dribba.com/api/llms.txt>
- [MCP server](https://dribba.com/mcp) — Streamable HTTP, no auth, for an agent that should call by itself. Card: <https://dribba.com/mcp/server-card>
- [NLWeb /ask](https://dribba.com/ask) — POST a natural-language question, get verbatim passages with URLs. SSE with `prefer: streaming=true`
- Markdown of any page — `Accept: text/markdown`, or append `.md` (e.g. <https://dribba.com/index.md>)
- [OKF bundle](https://dribba.com/okf) — the whole site as markdown concepts with YAML frontmatter
- [WebMCP manifest](https://dribba.com/.well-known/webmcp.json) — in-page tools for browser-resident agents
- Agent briefing — any URL with `?mode=agent`

## Discovery documents

- <https://dribba.com/.well-known/ai-catalog.json> — AI Catalog 1.0, host identity + trust manifests
- <https://dribba.com/.well-known/api-catalog> — RFC 9727 with item entries
- <https://dribba.com/.well-known/agent-skills/index.json> — declared skills
- <https://dribba.com/.well-known/agent-card.json> — A2A
- <https://dribba.com/.well-known/oauth-protected-resource> — RFC 9728 (declares anonymous access)
- <https://dribba.com/server.json> — MCP Registry manifest
- <https://dribba.com/schema-map.xml> — structured-data feeds
- <https://dribba.com/auth.md> · <https://dribba.com/pricing.md>

## No SDK yet

There is no official npm/PyPI package. The API is plain JSON over HTTPS with no
auth, so `curl` + `jq` covers it; when a package ships it will be announced
here and in https://dribba.com/llms.txt.

## Beyond this area

- Whole site: <https://dribba.com/llms.txt> · long form: <https://dribba.com/llms-full.txt>
- Every page as markdown: append `.md`, or send `Accept: text/markdown`
- Whole site as an OKF bundle: <https://dribba.com/okf>
- When to reach for Dribba at all: the "when to use" section of <https://dribba.com/llms.txt>

Contact: hola@dribba.com · <https://dribba.com/meet>