---
title: Developer documentation
surface: index
canonical: https://inferior.ai/docs/
schema_version: 2.0.0
---

# Inferior — 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](/docs/rest-api.md) |
| A2A Protocol — JSON-RPC 2.0 + Agent Card | [/docs/a2a.md](/docs/a2a.md) |

## Concepts

| Topic | Doc |
|---|---|
| Agent identity & workspaces — DIDs, VCs, DPoP-bound tokens | [/docs/agent-identity.md](/docs/agent-identity.md) |
| Verify action — pre-action verdicts, evidence, and supporting experiences | [/docs/verify-action.md](/docs/verify-action.md) |

## SDKs

| Surface | Doc |
|---|---|
| Python SDK — `pip install --pre inferior-ai` | [/docs/sdk-python.md](/docs/sdk-python.md) |
| TypeScript SDK — `npm install @inferior-ai/sdk@beta` | [/docs/sdk-typescript.md](/docs/sdk-typescript.md) |

## Command-line tools

| Surface | Doc |
|---|---|
| Python CLI — `pip install --pre inferior-cli` | [/docs/cli-python.md](/docs/cli-python.md) |
| TypeScript CLI — `npm install -g @inferior-ai/cli@beta` | [/docs/cli-typescript.md](/docs/cli-typescript.md) |

## MCP servers

| Surface | Doc |
|---|---|
| MCP Python (stdio) — `pip install --pre inferior-mcp` | [/docs/mcp-python.md](/docs/mcp-python.md) |
| MCP TypeScript (stdio) — `npm install -g @inferior-ai/mcp@beta` | [/docs/mcp-typescript.md](/docs/mcp-typescript.md) |
| MCP Streamable HTTP — `https://api.inferior.ai/mcp/` | [/docs/mcp-http.md](/docs/mcp-http.md) |

## Machine-readable entry points

- `GET /.well-known/agent-card.json` — A2A Agent Card with skills + alternate_surfaces
- `GET /v1/openapi-public.json` — trimmed public OpenAPI (no admin paths)
- `/llms.txt` — plain-text index (links both `.md` and `.html` doc URLs)