Developers

Build on Nirvani AI.

The same intelligence behind the free business advisor, three ways in: a REST API in the standard chat-completions format, an MCP server for agents, and an OpenAPI 3.1 spec for code generation. Every call is limited and metered per key.

Get a free test key API documentation OpenAPI spec

Live status

REST API: Checking
MCP server: Checking
Model tiers live: Checking
Requests, last 24 hours: Checking

Fetched live from the production gateway as this page loaded.

REST API

Chat completions with streaming, four model tiers, usage and quota per key. Existing chat-completions SDKs work after one base URL change.

curl https://api.nirvani.ai/v1/chat/completions \
  -H "Authorization: Bearer $NIRVANI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"nirvani-flash","messages":[{"role":"user","content":"Draft a follow-up text for a missed call"}]}'

POST /v1/chat/completions chat, streamed or buffered
GET /v1/models the live registry, no key needed
GET /v1/usage requests, tokens and quota for your key

Read the full reference

MCP server

Give any MCP client the Nirvani AI business advisor as a tool. Streamable HTTP, JSON responses, your Nirvani key as a bearer token.

{
  "mcpServers": {
    "nirvani-ai": {
      "type": "http",
      "url": "https://api.nirvani.ai/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_NIRVANI_KEY" }
    }
  }
}

ask_business_advisor decision-grade answers for business owners
chat_completion any Nirvani tier, with token usage
list_models tiers and live status
get_usage quota and usage for your key

Open without a key: initialize, ping, tools/list. A key is needed for tools/call.

OpenAPI 3.1

A complete machine-readable spec: every path, schema, error type and header. Generate a typed client or import it into your API tool.

https://ask.nirvani.ai/openapi.json
https://api.nirvani.ai/v1/openapi.json

Bearer authentication with nvk_test_ and nvk_live_ keys
Typed errors: rate_limit_error, quota_exceeded, capacity
Plain-text reference for LLMs at llms-full.txt

Open the spec

Try the MCP server from a terminal.

No key needed to list the tools.

curl https://api.nirvani.ai/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Then ask the advisor with your key:

curl https://api.nirvani.ai/v1/mcp \
  -H "Authorization: Bearer $NIRVANI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"ask_business_advisor","arguments":{"question":"Should I raise prices 10% or add a premium tier?","business_context":"6-person residential cleaning company"}}}'

PlaygroundCompare tiers side by side with live latency. ConsoleUsage, latency, errors and quota per key. llms.txtA summary of Nirvani AI for AI crawlers and agents. Run it for your businessNirvani's AI agents, set up for you. Start with the free AI Business Diagnostic.