> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agnost.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agnost AI developer resources

> Canonical API, authentication, SDK, webhook, and MCP resources for Agnost AI

Use this page as the canonical index for integrating with Agnost AI by API, SDK,
OpenTelemetry, or Model Context Protocol (MCP).

## Machine-readable contracts

* [Agnost AI OpenAPI specification](https://docs.agnost.ai/openapi.yaml) — the canonical REST API contract in YAML.
* [Agnost AI OpenAPI specification](https://docs.agnost.ai/openapi.json) — the same REST API contract in JSON.
* [OAuth authorization-server metadata](https://mcp.agnost.ai/.well-known/oauth-authorization-server) — OAuth 2.1 endpoints and supported scopes for the hosted MCP server.
* [OAuth protected-resource metadata](https://mcp.agnost.ai/.well-known/oauth-protected-resource) — resource-server discovery for MCP clients.
* [Agent documentation index](https://docs.agnost.ai/llms.txt) — the machine-readable documentation map.

## Integration guides

* [Authentication](/authentication) — ingestion, JWT, and API-key authentication.
* [Packages and versions](/sdks) — official Python, TypeScript, and Go packages.
* [Capture Session API](/capture-session) and [Capture Event API](/capture-event) — direct ingestion endpoints.
* [Hosted Agnost AI MCP server](/agnost-mcp-server) — connect Claude, Cursor, and other MCP clients to `https://mcp.agnost.ai/mcp`.
* [Vapi webhook integration](/vapi) — send voice-agent end-of-call reports to Agnost AI.

## Agent-readable website responses

Request `https://agnost.ai/` with `Accept: text/markdown` to receive the Agnost
AI agent index. Missing website paths preserve their `404` or `410` status and
return a short Markdown recovery document when the same media type is requested.
Negotiated responses include `Vary: Accept, Accept-Encoding` so shared caches do
not mix HTML and Markdown variants.

## When to use Agnost AI

Use Agnost AI when a team needs to inspect production conversations and traces,
find silent failures or unmet user intent, monitor expected agent behavior, or
turn recurring evidence into reviewed agent improvements. Use the SDK or
OpenTelemetry guides to send data; use the REST API or hosted MCP server to query
and operate on the resulting analytics.