Okaro for Agents
Private Beta

Let your AI agent keep the books for the user

One integration, three surfaces. Drop Okaro into ChatGPT, Claude, Cursor, n8n, LangChain or your own agent via MCP, CLI or REST — and unlock AI receipt OCR, multi-currency bookkeeping and dual-receipt reconciliation.

Join the Beta waitlist Read the OpenAPIInstall the MCP server
MCP
Claude · Cursor · Continue
CLI
npm · Homebrew · standalone
OpenAPI 3.1
ChatGPT Actions · Zapier · n8n
Webhooks
tx.created · receipt.parsed
Private Beta

Okaro for Agents is in Private Beta

Receipt OCR (/api/analyze-receipt) and CSV export (/api/export) are GA — usable today. The MCP server (@okaro/mcp-server) and CLI (@okaro/cli) ship via the waitlist while we open access; the OpenAPI spec is published so you can design your agent against it now.

Join the Beta waitlist →

Why agents pick Okaro as their bookkeeping backend

Native receipt OCR

Gemini 2.5 returns structured JSON for amount, merchant, date and line items. Your agent skips the OCR plumbing.

Multi-currency that respects reality

Live FX plus a "lock the actual swipe rate" mode means profit math stays honest on cross-border purchases.

Precise user-granted scopes

OAuth-style API keys with scopes: a user can let an agent read only, or write only to a specific card, or cap per-transaction amounts.

Dual-receipt reconciliation built in

Every transaction stores both the supplier receipt and the customer payment proof. Agents can drive reimbursement, tax filing and customer billing end-to-end.

Three surfaces — pick one, or combine them

MCP for conversational agents. CLI for shells, Cursor and Claude Code. REST/OpenAPI for backends and webhooks.

MCP Server

Beta · waitlist

Speaks the Model Context Protocol. Drop it into Claude Desktop, Cursor, Claude Code, Continue, Cody, and anything else that supports MCP.

npx -y @okaro/mcp-server
Join the Beta waitlist →

Okaro CLI

Beta · waitlist

Single binary, commands like `okaro tx add`, `okaro receipt analyze`, `okaro export`. Fits shell pipelines and CI.

npm i -g @okaro/cli
Join the Beta waitlist →

REST / OpenAPI

Stable · use today

Full OpenAPI 3.1 spec. Compatible with ChatGPT Actions, Custom GPTs, Zapier, n8n, Make.com and LangChain tools.

GET /.well-known/openapi.json

Tools available to your agent

Every tool honours the user-granted scope and returns structured JSON.

ToolDescription
okaro.create_transactionCreate a transaction, optionally with receipt image, dual currency and card.
okaro.list_transactionsQuery transactions by date, merchant, category, card or currency.
okaro.analyze_receiptReceipt image → structured JSON (amount, merchant, date, line items).
okaro.convert_currencyLive FX conversion, with the option to lock the actual swipe rate.
okaro.list_cardsList user cards plus current-month spend stats.
okaro.export_csvExport reconciliation CSV for a date range or client.
okaro.summarize_periodAggregate spend, profit and FX impact for a period.

Wire your agent up in 60 seconds

Claude Desktop / Cursor example:

  1. 1. Get an API key

    Go to Okaro web → Settings → Agent Keys. Pick scopes and (optionally) bind to a specific card.

  2. 2. Install the MCP server

    Add this to Claude Desktop's mcp.json or Cursor's settings.json:

    {
  "mcpServers": {
    "okaro": {
      "command": "npx",
      "args": ["-y", "@okaro/mcp-server"],
      "env": { "OKARO_API_KEY": "sk_okaro_xxx" }
    }
  }
}

  3. 3. Invoke from chat

    Tell Claude / Cursor "log this Japanese conbini receipt onto my reseller card". It will chain okaro.analyze_receipt → okaro.create_transaction.

Register your agent on the Okaro Agent Directory

The Okaro Agent Directory is a curated public directory shown to every Okaro user. Submit your agent name, purpose and required scopes — once approved, your agent gets listed and earns referral revenue share.

Submit your agent

FAQ

How does a user authorise my agent?+

The user opens Okaro web → Agent Keys and generates a scoped key for the agent. Every transaction the agent writes is tagged with the agent ID and the user can revoke at any time.

Are the MCP server and CLI open source?+

Yes. @okaro/mcp-server and @okaro/cli are MIT-licensed and on GitHub. PRs and issues welcome.

Can my agent upload receipt images on behalf of the user?+

Yes. okaro.create_transaction accepts base64 or a signed URL and stores it in the user's Supabase storage under RLS isolation.

Is there a rate limit?+

Free tier: 60 req/min, 5,000 req/day. Higher limits available — email support@harukibox.com.

Can my agent earn revenue?+

Yes. Agents listed on the directory receive 20% recurring share when a referred user upgrades to Premium.