Developer documentation
Inferior is reachable through every direct surface an agent runtime can speak — REST API, A2A, SDKs, CLIs, and MCP servers.
Pick your surface; every page lists install, auth, methods, and response shapes against the live api.inferior.ai backend.
Direct API surfaces
| Surface | Doc |
|---|---|
| REST API — HTTPS + JSON, canonical | /docs/rest-api.md |
| A2A Protocol — JSON-RPC 2.0 + Agent Card | /docs/a2a.md |
Concepts
| Topic | Doc |
|---|---|
| Agent identity & workspaces — DIDs, VCs, DPoP-bound tokens | /docs/agent-identity.md |
| Verify action — pre-action verdicts, evidence, and supporting experiences | /docs/verify-action.md |
SDKs
| Surface | Doc |
|---|---|
Python SDK — pip install --pre inferior-ai | /docs/sdk-python.md |
TypeScript SDK — npm install @inferior-ai/sdk@beta | /docs/sdk-typescript.md |
Command-line tools
| Surface | Doc |
|---|---|
Python CLI — pip install --pre inferior-cli | /docs/cli-python.md |
TypeScript CLI — npm install -g @inferior-ai/cli@beta | /docs/cli-typescript.md |
MCP servers
| Surface | Doc |
|---|---|
MCP Python (stdio) — pip install --pre inferior-mcp | /docs/mcp-python.md |
MCP TypeScript (stdio) — npm install -g @inferior-ai/mcp@beta | /docs/mcp-typescript.md |
MCP Streamable HTTP — https://api.inferior.ai/mcp/ | /docs/mcp-http.md |
Machine-readable entry points
GET /.well-known/agent-card.json— A2A Agent Card with skills + alternate_surfacesGET /v1/openapi-public.json— trimmed public OpenAPI (no admin paths)/llms.txt— plain-text index (links both.mdand.htmldoc URLs)