English Français العربية

io.github.nqzai/kakunin

Registre officiel Sécurité

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @kakunin/mcp
Claude Code 
claude mcp add kakunin -e 'KAKUNIN_API_KEY=<your kakunin_api_key>' -e 'KAKUNIN_AGENT_ID=<KAKUNIN_AGENT_ID>' -- npx -y @kakunin/mcp@0.2.3
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "kakunin": {
            "command": "npx",
            "args": [
                "-y",
                "@kakunin/mcp@0.2.3"
            ],
            "env": {
                "KAKUNIN_API_KEY": "<your kakunin_api_key>",
                "KAKUNIN_AGENT_ID": "<KAKUNIN_AGENT_ID>"
            }
        }
    }
}

Variables d'environnement

  • KAKUNIN_API_KEY secret Kakunin API key (kak_live_... or kak_test_...). Obtain at https://kakunin.ai/dashboard.
  • KAKUNIN_AGENT_ID ID of the agent this MCP server acts on behalf of (agt_...).

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. @kakunin/mcp — MCP server for AI agent identity & compliance
  2. Tools
  3. Setup
  4. Sandbox mode
  5. Contributors

@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.

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_KEY✅API key (kak_live_... or kak_test_...)
KAKUNIN_AGENT_ID✅Agent 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.

Questions fréquentes

Qu'est-ce que io.github.nqzai/kakunin ?

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

Comment installer io.github.nqzai/kakunin ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add kakunin -e 'KAKUNIN_API_KEY=<your kakunin_api_key>' -e 'KAKUNIN_AGENT_ID=<KAKUNIN_AGENT_ID>' -- npx -y @kakunin/mcp@0.2.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.nqzai/kakunin ?

Oui. Il attend KAKUNIN_API_KEY, à renseigner dans sa configuration.

io.github.nqzai/kakunin est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient io.github.nqzai/kakunin ?

Il est publié par nqzai. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.