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 — the canonical REST API contract in YAML.
- Voxmith OpenAPI specification — the same REST API contract in JSON.
- OAuth authorization-server metadata — OAuth 2.1 endpoints and supported scopes for the hosted MCP server.
- OAuth protected-resource metadata — resource-server discovery for MCP clients.
- Agent documentation index — the machine-readable documentation map.
Integration guides
- Authentication — ingestion, JWT, and API-key authentication.
- Packages and versions — official Python, TypeScript, and Go packages.
- Capture Session API and Capture Event API — direct ingestion endpoints.
- Hosted Voxmith MCP server — connect Codex, Claude, Cursor, and other MCP clients to
https://mcp.voxmith.com/mcp. - Vapi webhook integration — 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.