# Elba — The documentation layer for AI agents

> Elba turns any API into an executable, discoverable interface for AI agents.

## What is Elba?

Elba generates structured, machine-readable API documentation (AgentSpecs) that AI agents can discover, understand, and execute against. Every spec includes typed actions with inputs, outputs, example prompts, and reasoning hints (when to use, when not to use, common mistakes).

## How to discover APIs on Elba

- Agent discovery index: GET /.well-known/agent.json
- Search by capability: GET /api/agent-search?q=send+email
- Full registry: GET /api/registry
- Individual spec: GET /api/agent/{id}

## Available APIs

(No published APIs yet)

## For API Providers

Create agent-native docs at /create — paste your API description or OpenAPI spec and Elba generates a structured AgentSpec in seconds.

## Key Terms (Glossary)

- **AgentSpec**: A structured, machine-readable specification describing an API in terms AI agents can parse and execute. Contains actions, capabilities, typed inputs/outputs, and documentation.
- **agent.json**: A machine-readable JSON endpoint exposing an AgentSpec for AI agent consumption. Available at /api/agent/{id}.
- **MCP Config**: An MCP server configuration with tools mapped from spec actions. Available at /api/mcp/{id}.
- **Capability**: A short phrase describing what an API can do, used for semantic search in the agent registry.
- **Action**: A single API operation with typed inputs, outputs, and example prompts.

Full glossary: /glossary

## Endpoints Reference

| Endpoint | Method | Description |
|----------|--------|-------------|
| /.well-known/agent.json | GET | Discovery manifest listing all published specs |
| /.well-known/ai-plugin.json | GET | OpenAI plugin manifest |
| /api/registry | GET | Registry of all tools with capabilities |
| /api/agent-search?q= | GET | Search specs by capability keyword |
| /api/agent/{id} | GET | Machine-readable spec for a single API |
| /api/mcp/{id} | GET | MCP server config for a spec |
| /api/search | POST | Search with body { "query": "..." } |
| /api/spec/{id} | GET | Raw AgentSpec JSON |
| /api/feed | GET | Atom feed of published specs |
| /api/feed?format=json | GET | JSON Feed of published specs |
| /llms.txt | GET | This file — LLM-readable platform description |
| /glossary | GET | Glossary of agent documentation terms |