Kranth developer resources

Kranth is a synthetic audience simulation engine. Agents and SDK callers should use these files instead of the React marketing app.

API

• Base: https://api.kranth.ai (also api.kranth.com)
• Version: URL path /v1/. Breaking changes ship as /v2/. Deprecated routes send Deprecation and Sunset at least 90 days before removal.
• Auth: Authorization: Bearer kr_live_… or a Nexus JWT
• OpenAPI JSON: https://kranth.ai/openapi.json
• OpenAPI YAML: https://kranth.ai/openapi.yaml
• Alias: /api/openapi.json
• Plain text: https://kranth.ai/docs.txt
• Interactive: https://kranth.ai/docs

Errors and limits

Every 4xx and 5xx body is JSON: error (stable code), message, hint. Rate-limit headers: RateLimit, RateLimit-Policy, plus Retry-After on HTTP 429. POST /v1/sims is per-org capped.

Webhooks and MCP

Outgoing webhooks are HMAC-SHA256 signed. Recipe is on the OpenAPI Webhook schema. Kranth does not expose an MCP tool server yet. Manifest: /.well-known/mcp.json.

Mint keys at app.kranth.ai/api-keys. Agent index: llms.txt.