Skip to content
Nairon Docs

Developer guide

Nairon exposes two APIs plus an MCP server, all authenticated with project-scoped API keys minted from a platform-type project on platform.v2.nairon.xyz:

  • platform-api (api.v2.nairon.xyz) — an OpenAI-compatible data plane: chat completions, text-to-speech, transcription, realtime speech-to-speech, batch jobs, and knowledge-base stores. Point an OpenAI SDK’s base_url at it.
  • service-api (service.v2.nairon.xyz) — a REST control plane: flows/versions, phone numbers, agent profiles, usage reads, plus partner and headless endpoints. Also serves an MCP server at /mcp exposing the same operations as tools.
  • MCP — connect an MCP-capable client (Claude, an agent framework) directly to service.v2.nairon.xyz/mcp.

See API keys for how authentication works and Usage & billing for how to read consumption. Full endpoint references live under API Reference.