# naturali **Agents that operate for you, with autonomy you can prove** Describe the agent you need to Claude or Cursor, or write it in code. Knowledge, tools, WhatsApp or Discord, and every run traced with its cost. ```bash curl -X POST \ "https://api.naturali.ai/v1/projects/$PROJECT/agents/$AGENT/generate" \ -H "Authorization: Bearer $NATURALI_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "messages": [{ "role": "user", "content": "What is our refund window?" }] }' ``` ## Features The whole system, not just the agent. An agent is more than a prompt: what it knows, where it answers, what it may do. Each piece is here, with a tutorial. - [Agents](https://naturali.ai/features/agents/) — a versioned configuration with tools, knowledge and a model. - [Knowledge](https://naturali.ai/features/knowledge/) — ground answers in your own documents, with the source to cite. - [Channels](https://naturali.ai/features/channels/) — put an agent on WhatsApp or Discord, where people already are. - [Automation](https://naturali.ai/features/automation/) — run agents on a schedule, an event or by hand, with a record of each firing. - [Control](https://naturali.ai/features/control/) — guardrails on tool calls, human approvals and an audit log. - [Evaluations](https://naturali.ai/features/evaluations/) — score a change against your own cases before it ships. - [Models](https://naturali.ai/features/models/) — managed models with no vendor account, or your own credential. ## Ask for it. Or code it. Tell your assistant what the system should do and it builds it here. Or write the same calls yourself. Same API either way. - [MCP server](https://naturali.ai/docs/clients/mcp) — connect Claude, Cursor or VS Code and describe what you want built. - [TypeScript SDK](https://naturali.ai/docs/clients/sdk) — `@naturali/sdk`, typed paths, bodies and responses. - [CLI](https://naturali.ai/docs/clients/cli) — `@naturali/cli`, one command per operation, scriptable in CI. - One contract — every client is generated from the same OpenAPI, so none can do more than another. ## How it works ### Configure an agent A model, a prompt, the tools it may call and the knowledge it answers from — versioned, so a change is a release rather than an edit in place. ### Connect it to the world Upload files and let ingestion chunk and embed them, connect HTTP or MCP tools, then bind the agent to WhatsApp or Discord — or call it from your own product. ### Prove, then promote Score the new version against a dataset, read the traces of what it actually did, and check the spend against the quota before it goes to everyone. ## Every run, read back Model turns, tool calls, knowledge retrieved, guardrail checks, and what it cost — with the agent version that served the run. ## Autonomous, not uncontrolled Guardrails gate what an agent may do, approvals put a human in front of the decisions that need one, and every request stays on the record. - **Guardrails** (Pro and up) — classify every tool call before it runs: execute, execute if a guard passes, ask a human, or refuse. - **Approvals** (Pro and up) — put a person in front of the calls that need one. - **Audit log** (Business and up) — every request, and who made it, on the record. - **Secrets** (every plan) — encrypted, write-only credentials; the value is never returned. ## Priced on runs One run is one agent generation or one tool call, wherever it came from. Managed models draw on a prepaid balance; on your own credential, your vendor bills the tokens. - **Free** — $0 forever: 2,000 runs a month, 3 projects · 1 channel, Evals included - **Pro** — $49 per month: 25,000 runs a month, Unlimited projects · 10 channels, Guardrails, approvals and exceptions - **Business** — $249 per month: 250,000 runs a month, Unlimited projects · 100 channels, Audit log · 90-day retention - **Enterprise** — Custom by contract: Limits by contract, Custom retention, SLA + DPA [Every plan, model credits and FAQ](https://naturali.ai/pricing.md) ## Frequently asked ### What is naturali? One API to build, run and prove AI agents. Give an agent knowledge and tools, put it on WhatsApp or Discord or call it from your product, and read back every generation it ran with what it cost. ### Where can an agent answer? On WhatsApp and Discord through channels: you choose the agent, and the platform runs the conversation from the incoming message to the reply. Or call it from your own product over the REST API, the TypeScript SDK or the CLI. ### Which models can I use? The managed catalog, with no vendor account, paid from a prepaid balance. Or your own credential, and your vendor bills the tokens. A model route tries its targets in order and falls through on a provider error, timeout or rate limit. ### Can Claude, Cursor or VS Code build it for me? Yes. naturali is an MCP server: connect your assistant, approve it in your browser, and describe what you want built. Every operation in the API is a tool, so it reaches exactly what you would call yourself. ### How do I see what an agent did? Every run is traced: model turns, tool calls, knowledge retrieved, guardrail checks and what it cost, with the agent version that served it. ### How much does it cost? Free is $0 with 2,000 runs a month and no card. Pro is $49 and Business $249 a month; Enterprise is by contract. One run is one agent generation or one tool call. ## Build the agent. Keep the receipts. Sign in, connect your assistant or open the quickstart, and run your first agent. Free plan · 2,000 runs a month · no card. - [Quickstart](https://naturali.ai/docs/tutorials/first-agent-generation) - [Documentation](https://naturali.ai/docs/) - [API reference](https://naturali.ai/docs/openapi-specs) - [App](https://app.naturali.ai) ## For agents - [/llms.txt](https://naturali.ai/llms.txt) — what this is and when to reach for it - [/api/llms.txt](https://naturali.ai/api/llms.txt) — the API in one page - [/openapi.json](https://naturali.ai/openapi.json) — the whole v1 contract - [/auth.md](https://naturali.ai/auth.md) — how to authenticate - [/.well-known/api-catalog](https://naturali.ai/.well-known/api-catalog) — the API catalog (RFC 9727) - [/.well-known/ard.json](https://naturali.ai/.well-known/ard.json) — the resource catalog - [/mcp-server.json](https://naturali.ai/mcp-server.json) — the MCP server card - [/sitemap-index.xml](https://naturali.ai/sitemap-index.xml) — every page on this site