# For agents

> Made for people. Readable by agents.

Canonical: https://flow-skills-md.vercel.app/agents

Every page is a semantic HTML page and a Markdown document. No login is needed.

## Discover

- `GET https://flow-skills-md.vercel.app/llms.txt`: curated index of skills, guides, capabilities, articles, decisions, and interfaces
- `GET https://flow-skills-md.vercel.app/llms-full.txt`: every guide, capability, article, and skill as Markdown
- `GET https://flow-skills-md.vercel.app/sitemap.xml`: every page
- `GET https://flow-skills-md.vercel.app/.well-known/mcp.json`, `https://flow-skills-md.vercel.app/.well-known/mcp/server-card.json`, `https://flow-skills-md.vercel.app/.well-known/ai-catalog.json`: MCP discovery
- `GET https://flow-skills-md.vercel.app/openapi.json`: OpenAPI 3.1 for the HTTP API

## Retrieve

- Markdown for any page: append `.md` (home is `https://flow-skills-md.vercel.app/index.md`) or send `Accept: text/markdown`
- `GET https://flow-skills-md.vercel.app/api/search?q=<query>&limit=1-25&kind=skill|doc|decision|starter|capability|article`: ranked results with canonical URLs and excerpts

## Understand

- `POST https://flow-skills-md.vercel.app/api/ask` with `{"question": "..."}`: answer with numbered citations; `?stream=1` streams text
- MCP Streamable HTTP at `https://flow-skills-md.vercel.app/api/mcp` (alias `https://flow-skills-md.vercel.app/mcp`), read-only tools: `search_flow`, `list_skills`, `get_skill`, `get_doc`, `ask_flow`

## Errors

API errors are JSON: `{ "code", "error", "resolution", "type" }` with a real HTTP status. Rate-limited requests return 429 with `Retry-After`.

## Verify

`npx is-agentic flow-skills-md.vercel.app` — see https://is-agentic.com
