Kakunin

Name: Kakunin
Author: kakunin-ai

@kakunin-aiMCP server · External

X.509 identity, risk scoring, and audit logging for AI agents. MiCA + EU AI Act compliant.

AI agent governancev0.2.4Apache-2.0TypeScript

Freeno charge per call

How to install

Runs on your machine from its package; the steps are below.

What it does

Reads
Writes
High impact

At most: only reads or looks up information.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

npm@kakunin/mcpv0.2.4

Run

npx -y @kakunin/mcp

MCP client config

{
  "mcpServers": {
    "kakunin": {
      "command": "npx",
      "args": [
        "-y",
        "@kakunin/mcp"
      ]
    }
  }
}

README2 min readView on GitHub

@kakunin/mcp — MCP server for AI agent identity & compliance

Model Context Protocol server for the Kakunin AI agent compliance API. Lets AI agents self-verify scope, check their own risk score, and log behavioral events — all from within Claude, Cursor, or any MCP-compatible runtime.

bash

npx @kakunin/mcp

Tools

`verify_agent_scope`

Check whether this agent is authorised to perform an action before executing it. Verifies the active X.509 certificate, permitted_actions scope, financial limits, and revocation status.

json

{
  "action": "initiate EUR/USD trade on euronext for 50000 USD",
  "venue": "euronext",
  "amount_usd": 50000
}

Returns { allowed: true|false, reason, certificate_status, permitted_actions }.

`check_risk_score`

Retrieve the agent's rolling 30-day risk score, band (low/medium/high), drift trend, and actionable guidance. No input required.

`audit_log_append`

Append a behavioral event to the agent's immutable audit log. Returns risk score + transaction ID. Events scoring ≥ 0.85 auto-trigger a certificate revocation check.

json

{
  "action_type": "transaction_initiated",
  "details": { "amount_usd": 50000, "venue": "NYSE" }
}

Setup

Prerequisites: Node ≥ 18, Kakunin API key + Agent ID from kakunin.ai/dashboard.

Claude Desktop

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

json

{
  "mcpServers": {
    "kakunin": {
      "command": "npx",
      "args": ["-y", "@kakunin/mcp"],
      "env": {
        "KAKUNIN_API_KEY": "kak_live_...",
        "KAKUNIN_AGENT_ID": "agt_..."
      }
    }
  }
}

Environment variables

Variable	Required	Description
`KAKUNIN_API_KEY`	✅	API key (`kak_live_...` or `kak_test_...`)
`KAKUNIN_AGENT_ID`	✅	Agent ID the server acts on behalf of
`KAKUNIN_BASE_URL`	optional	Override API base (default: `https://kakunin.ai`)