npm package: @kanoniv/mcp
Description: Kanoniv MCP server - connect AI assistants to the Kanoniv identity resolution platform
Latest version: 0.3.7

# @kanoniv/mcp

Connect your AI assistant to the [Kanoniv](https://kanoniv.com) identity resolution platform via the [Model Context Protocol](https://modelcontextprotocol.io).

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

## Quick Start

Add to your MCP client config:

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

Get your API key from your [Kanoniv dashboard](https://app.kanoniv.com) 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](https://kanoniv.com/docs/ai/mcp-server)
- [Getting Started](https://kanoniv.com/docs/getting-started/)
- [GitHub](https://github.com/kanoniv/kanoniv)