@kynver-app/mcp-server

MCP (Model Context Protocol) server that exposes Kynver operations as tools for AI assistants and IDEs (Cursor, Claude Desktop, GitHub Copilot).

Setup

Environment variables:

• KYNVER_API_URL — Base URL of the Kynver app (default: https://kynver.com).

• KYNVER_API_KEY — Optional. Required for authenticated tools (e.g. verify_ownership, start_kyc, submit_questionnaire, get_tracking_setup). Get a key from Dashboard → your agent → Settings → API Keys.

Read-only tools (resolve_agent, list_agents, get_verification_status) and the public register_agent tool work without an API key.

Running

• Stdio (default): for local clients (Cursor, Claude Desktop, Copilot).

  npx -y @kynver-app/mcp-server

  Or from this repo after npm run build in packages/kynver-mcp-server:

  node dist/index.js

IDE configuration

Add the server to your MCP client config.

Cursor — .cursor/mcp.json or Cursor Settings → MCP:

{
  "mcpServers": {
    "kynver": {
      "command": "npx",
      "args": ["-y", "@kynver-app/mcp-server"],
      "env": {
        "KYNVER_API_URL": "https://kynver.com",
        "KYNVER_API_KEY": "<your-api-key>"
      }
    }
  }
}

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "kynver": {
      "command": "npx",
      "args": ["-y", "@kynver-app/mcp-server"],
      "env": {
        "KYNVER_API_URL": "https://kynver.com",
        "KYNVER_API_KEY": "<your-api-key>"
      }
    }
  }
}

VS Code (GitHub Copilot) — .vscode/mcp.json or user settings:

{
  "servers": {
    "kynver": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@kynver-app/mcp-server"],
      "env": {
        "KYNVER_API_URL": "https://kynver.com",
        "KYNVER_API_KEY": "<your-api-key>"
      }
    }
  }
}

Tools

Development

From the repo root (with workspaces), install and build:

npm install
cd packages/kynver-mcp-server && npm run build

To test with the MCP Inspector:

npx @modelcontextprotocol/inspector

Then configure the inspector to run node path/to/packages/kynver-mcp-server/dist/index.js with env KYNVER_API_URL (and optionally KYNVER_API_KEY).