For AI agents

This page explains how AI agents, and the people who connect them, can use kenari with lower overhead. All endpoints are compatible with OpenAI or Anthropic, and the documentation is available in a machine-readable form.

Instructions for agents

Note Four shortcuts for agents: add .md to docs URLs for clean Markdown, call GET /v1/models for live prices, read /llms-full.txt for the full reference in one file, and use the MCP server at https://kenari.id/mcp.

Documentation formats

llms.txt and llms-full.txt

Two plain text files help models load the documentation without a key:

• /llms.txt: a short index, with one link and one line per section. Load it into any context window.
• /llms-full.txt: all documentation combined into one file, for a single read.

curl https://kenari.id/llms.txt
curl https://kenari.id/llms-full.txt

Pages as Markdown

Each docs page is available as clean Markdown. Add .md to the page URL, for example https://kenari.id/docs/chat.md.

/docs.md contains all documentation in one Markdown file.

curl https://kenari.id/docs/chat.md
curl https://kenari.id/docs.md

For models, Markdown uses about 30x fewer tokens than HTML, so choose this format when you provide context to agents.

Integrations and catalog

openapi.json

The OpenAPI 3.1 spec is at https://kenari.id/openapi.json. This file describes the four /v1 endpoints, the kn-... bearer scheme, request and response shapes, and the error format. Use it with code generators, Postman, and API explorers.

curl https://kenari.id/openapi.json

Claude Code

kenari fully supports the Anthropic protocol at /v1/messages: every model id in the catalog can be used, including tool calling and streaming. ANTHROPIC_API_KEY (sent through the x-api-key header) is also accepted, and POST /v1/messages/count_tokens is available so Claude Code context tracking works as usual. Full setup steps are in AI editors and agents.

MCP server

The Model Context Protocol server at https://kenari.id/mcp exposes the following tools:

Tool	Function	Needs key
kenari_search_docs	Search the documentation.	no
kenari_list_models	List models with live IDR prices.	no
kenari_balance	Your balance (Rupiah).	yes
kenari_usage	Usage for the last 30 days by model.	yes
kenari_quota	Your plan and coupon quota in Rupiah.	yes
kenari_web_search	Live web search, returns a ranked list of links.	yes
kenari_web_fetch	Fetch clean content from one URL.	yes
kenari_x_search	Live X (formerly Twitter) search, returns an answer with source links.	yes

Add this endpoint to Claude Code, Cursor, or another MCP client. Tools without a key are public. For kenari_balance, kenari_usage, kenari_quota, kenari_web_search, kenari_web_fetch, and kenari_x_search, set the Authorization: Bearer kn-... header (your API key) in the MCP server configuration. The last three are also billed to your balance per call.

The header also accepts x-api-key if your MCP client uses that style. Authorization wins when both are present.

Shared keys If the key you are using came from a share page, kenari_balance, kenari_usage, and kenari_quota are refused: all three read account data for the key owner, not for you. The tools that spend (kenari_web_search, kenari_web_fetch, kenari_x_search) still work, since spending is what a shared key is for. Use a key from your own account to read balance, usage, and quota figures.

Live price feed

GET /v1/models (public) and GET /api/public/pricing return the current model list and token prices. Always call one of these endpoints instead of copying static numbers, because prices and the model catalog can change.

curl https://kenari.id/v1/models
curl https://kenari.id/api/public/pricing

See also Models and prices for the model list structure and Billing for how tokens are converted to Rupiah.