Kora MCP Server

MCP server for Kora — deterministic authorization for AI agent spending.

Gives AI agents (Claude, GPT, etc.) the ability to check budgets, request spending authorization, and verify service health — all with cryptographic Ed25519 proofs.

Quick Start

Install

pip install kora-mcp-server

Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "kora": {
      "command": "kora-mcp",
      "env": {
        "KORA_API_URL": "https://api.koraprotocol.com",
        "KORA_AGENT_SECRET": "kora_agent_sk_...",
        "KORA_MANDATE": "mandate_abc123def456",
        "KORA_ADMIN_KEY": "kora_admin_sk_..."
      }
    }
  }
}

Or run directly

KORA_AGENT_SECRET=kora_agent_sk_... \
KORA_MANDATE=mandate_abc123 \
kora-mcp

Tools

Configuration

How It Works

1. AI agent calls kora_check_budget → sees remaining limits
2. Agent calls kora_spend with amount, vendor, currency, reason
3. Kora returns APPROVED (with Ed25519 cryptographic seal) or DENIED (with reason + suggestion)
4. Agent proceeds only if approved — denials include actionable hints for self-correction

Fail-closed: If Kora is unreachable, the agent gets a clear "DO NOT PROCEED" message. No silent failures.

What is Kora?

Kora is a deterministic authorization engine for autonomous AI agent spending. It's not a bank, not a wallet, not a payment processor. Agents ask Kora "can I spend this?" and get a cryptographically signed yes or no.

• Kora Repository
• API Reference
• Patent: PCT/EP2025/053553