@kanoniv/mcp

Connect your AI assistant to the Kanoniv identity resolution platform via the Model Context Protocol.

Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Quick Start

Add to your MCP client config:

{
  "mcpServers": {
    "kanoniv": {
      "command": "npx",
      "args": ["-y", "@kanoniv/mcp"],
      "env": {
        "KANONIV_API_KEY": "kn_..."
      }
    }
  }
}

Get your API key from your Kanoniv dashboard under Settings > API Keys.

What You Get

15 Category Tools (114 actions) with action-based dispatch:

| Tool | Actions | |------|---------| | manage_specs | list, get, create, summary, sensitivity | | manage_sources | list, get, preview, create, update, delete, sync, stats, quality, entities | | manage_ingest | file, csv, batch, create_mapping | | manage_jobs | list, get, run, cancel, summary, telemetry, diff, dry_run, simulate, stats | | manage_entities | search, get, get_linked, history, lock, revert, resolve_realtime, resolve_bulk, bulk_linked, attrs, candidates, diff | | manage_matching | pending_reviews, explain, list_feedback, list_overrides, quick_resolve, batch_resolve, create/delete feedback, create/delete override, candidates, cluster, test | | manage_rules | list, history, audit_events, entity_audit, create | | manage_crm | dashboard, duplicates, compare, search, graph, paths, merge_history, connection, connect, disconnect, trigger_sync, merge, dismiss, split, autotune, update_settings | | manage_graph | stats, events, merges, export, export_csv, export_memberships, refresh, orphans, conflicts, density, export_graph, export_matches | | manage_memory | create, update, append, archive, link_entities | | manage_detect | profile, bootstrap | | manage_agents | list/get/update/delete configs, list/get/rollback runs, list/approve/reject actions | | analyze_entities | group_by, filter, field_stats | | manage_rows | show, resolve, lookup, memberships, trace | | manage_system | reindex, recompute |

70 Resources (lazy-loaded, zero context cost):

Browse specs, sources, jobs, entities, match explanations, CRM duplicates, graph intelligence, memory entries, agent configs, audit trails, and more via kanoniv:// URIs loaded on demand.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | KANONIV_API_KEY | Yes | - | API key (kn_...) | | KANONIV_API_URL | No | https://api.kanoniv.com | API base URL | | KANONIV_MCP_TOOLS | No | all | Tool profile filter | | KANONIV_MCP_MODE | No | hybrid | hybrid (recommended) or legacy |

Tool Profiles

| Profile | Use case | |---------|----------| | all | Full platform access (default) | | architect | Spec authoring and data modeling | | operator | Running and monitoring jobs | | forensic | Entity investigation, analytics, and match auditing | | prism | CRM deduplication and graph intelligence | | setup | End-to-end setup workflow |

Supported Platforms

• Linux x64
• macOS ARM64 (Apple Silicon)
• macOS x64 (Intel)
• Windows x64

Links

• Full Documentation
• Getting Started
• GitHub