Kyonis MCP Server

The first MCP server for KYC/AML compliance. Give your AI agents native access to identity verification, sanctions screening, due diligence, and beneficial ownership resolution — conformant with EU LCB-FT and GDPR.

5 production-ready tools: kyc_verify, aml_screen, due_diligence, entity_risk, ubo_resolve. Sub-500ms screening (Jaro-Winkler, trigram, Levenshtein, phonetic). Live OFAC/EU/UN/HMT sanctions data. Sandbox tier with 500 free verifications/month.

Quick start

1. Get a free API key

Sign up at dashboard.kyonis.com — sandbox tier includes 500 verifications/month, no credit card.

2. Add to your MCP client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "kyonis": {
      "command": "npx",
      "args": ["-y", "@getkyonis/mcp-server"],
      "env": {
        "KYONIS_API_KEY": "ky_sandbox_..."
      }
    }
  }
}

Restart Claude Desktop. Try:

"Screen 'Vladimir Putin' against sanctions lists."

"Run KYC for Marie Dupont, born 1990-04-12, French passport 14AB12345."

"Resolve UBOs for SIREN 552120222."

Cursor / Cline / Continue

Same config format. Add the kyonis entry to your client's MCP servers config.

Programmatic (Node)

npx -y @getkyonis/mcp-server

The server speaks MCP over stdio by default. Use --http (or MCP_TRANSPORT=http) to expose an HTTP/SSE endpoint on port 3000.

3. LangChain

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

client = MultiServerMCPClient({
    "kyonis": {
        "command": "npx",
        "args": ["-y", "@getkyonis/mcp-server"],
        "env": {"KYONIS_API_KEY": "ky_sandbox_..."},
        "transport": "stdio",
    }
})

tools = await client.get_tools()
agent = create_react_agent("anthropic:claude-sonnet-4-6", tools)
await agent.ainvoke({"messages": [{"role": "user", "content": "Screen 'Acme Corp' for AML risks"}]})

4. CrewAI

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter

with MCPServerAdapter({
    "command": "npx",
    "args": ["-y", "@getkyonis/mcp-server"],
    "env": {"KYONIS_API_KEY": "ky_sandbox_..."},
}) as kyonis_tools:
    compliance_agent = Agent(
        role="Compliance Analyst",
        goal="Run thorough AML/KYC checks on entities",
        tools=kyonis_tools,
    )
    Crew(agents=[compliance_agent], tasks=[Task(
        description="Run due diligence on Acme Corp registered in the UK",
        agent=compliance_agent,
    )]).kickoff()

Tools

| Tool | Purpose | p95 latency | Required params | |---|---|---|---| | kyc_verify | Full KYC: sanctions + PEP + adverse media + document checks. Decision: approved / review / rejected. | < 3s | first_name, last_name | | aml_screen | Screen against OFAC, EU, UN, HMT with multi-algorithm fuzzy matching. | < 500ms | name | | due_diligence | Enhanced due diligence: jurisdiction risk + adverse media + corporate structure. | < 10s | entity | | entity_risk | Real-time risk score for a registered entity (cached). | < 200ms | entity_id | | ubo_resolve | Resolve Ultimate Beneficial Owners via INSEE Sirene + OpenOwnership. | < 5s | entity |

Every response includes an explainable reasoning field — required for audit trail under LCB-FT (FR), 5AMLD (EU) and equivalents.

Configuration

| Env var | Default | Description | |---|---|---| | KYONIS_API_KEY | (required) | API key from dashboard.kyonis.com | | KYONIS_API_BASE_URL | https://api.kyonis.com | Override for self-hosted or staging | | MCP_TRANSPORT | stdio | Set to http for HTTP/SSE transport | | PORT | 3000 | HTTP server port (when MCP_TRANSPORT=http) | | TIMEOUT | 30000 | Request timeout (ms) |

Pricing

| Tier | Price | Verifications | |---|---|---| | Sandbox | Free | 500/month | | Starter | €199/mo | 5 000/month | | Growth | €1 499/mo | 50 000/month | | Enterprise | Custom | Unlimited + SLA |

See full pricing →

Compliance

• GDPR — data residency in EU (Scaleway, Paris). Right-to-erasure endpoints exposed via API.
• LCB-FT (FR) — 7-year audit trail (Art. L561-12 CMF). Every call logged with reasoning and source attribution.
• 5AMLD / 6AMLD — sanctions screening from official primary sources, refreshed daily.
• Data sources — OFAC SDN, EU Consolidated Sanctions, UN SC List, HMT/OFSI, DFAT, INSEE Sirene, OpenOwnership.

Full data sources documentation: docs.kyonis.com/data-sources.

Documentation

• API reference
• MCP integration guide
• Compliance & data sources

Support

• Issues: github.com/contactkyonis-droid/kyonis/issues
• Email: [email protected]
• Sales / enterprise: [email protected]

License

MIT