Back to Browse

Kakunin MCP Server

by Nqzai
Developer ToolsModerate5.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

5.2
Moderate5.2Moderate Risk

Well-architected MCP server for compliance and risk management. Authentication is properly enforced through environment variables with lazy initialization. Code is clean, input validation is present via Zod schemas, and permissions are appropriate for the stated purpose. Minor code quality observations noted, but no security vulnerabilities identified. Supply chain analysis found 4 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

7 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Kakunin API key (kak_live_... or kak_test_...). Obtain at https://kakunin.ai/dashboard.Required

Environment variable: KAKUNIN_API_KEY

ID of the agent this MCP server acts on behalf of (agt_...).Optional

Environment variable: KAKUNIN_AGENT_ID

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-nqzai-kakunin": {
      "env": {
        "KAKUNIN_API_KEY": "your-kakunin-api-key-here",
        "KAKUNIN_AGENT_ID": "your-kakunin-agent-id-here"
      },
      "args": [
        "-y",
        "@kakunin/mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

OpenSSF Scorecard kakunin-mcp MCP server

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.

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.

{
  "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.

{
  "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:

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

Environment variables

VariableRequiredDescription
KAKUNIN_API_KEYAPI key (kak_live_... or kak_test_...)
KAKUNIN_AGENT_IDAgent ID the server acts on behalf of
KAKUNIN_BASE_URLoptionalOverride API base (default: https://kakunin.ai)

Sandbox mode

Use a kak_test_... key for development — hits the sandbox CA, no cost, 100 free certs/day.

Full docs at docs.kakunin.ai.

Contributors

Thanks to everyone who contributes (emoji key) — code and non-code alike:

Contributions of any kind are welcome — this project follows the all-contributors spec.

Reviews

No reviews yet

Be the first to review this server!