# Voxmith developer resources

> Canonical API, authentication, SDK, webhook, and MCP resources for Voxmith

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

## Machine-readable contracts

* [Voxmith OpenAPI specification](https://docs.voxmith.com/openapi.yaml) — the canonical REST API contract in YAML.
* [Voxmith OpenAPI specification](https://docs.voxmith.com/openapi.json) — the same REST API contract in JSON.
* [OAuth authorization-server metadata](https://mcp.voxmith.com/.well-known/oauth-authorization-server) — OAuth 2.1 endpoints and supported scopes for the hosted MCP server.
* [OAuth protected-resource metadata](https://mcp.voxmith.com/.well-known/oauth-protected-resource) — resource-server discovery for MCP clients.
* [Agent documentation index](https://docs.voxmith.com/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 Voxmith MCP server](/voxmith-mcp-server) — connect Codex, Claude, Cursor, and other MCP clients to `https://mcp.voxmith.com/mcp`.
* [Vapi webhook integration](/vapi) — send voice-agent end-of-call reports to Voxmith.

## Agent-readable website responses

Request `https://www.voxmith.com/` with `Accept: text/markdown` to receive the Voxmith
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 Voxmith

Use Voxmith 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.