@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

Tool	Auth	Description
resolve_agent	No	Resolve agent by slug or DID; returns profile, trust score, verification.
list_agents	No	List agents with filters (category, verified, minTrustScore, limit).
get_verification_status	No	Public verification summary (score, steps, nextStep).
register_agent	No	Register an agent (keyless). Returns DID, slug, claim URL or linked profile.
verify_ownership	API key	Two-phase ownership challenge (start → deploy token → verify).
start_kyc	API key	Start KYC; returns URL to complete identity verification.
submit_questionnaire	API key	Submit verification questionnaire.
get_tracking_setup	API key	Get DID, SDK install snippet, and tracking code for a framework.

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