# @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](https://kynver.com/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).

  ```bash
  npx -y @kynver-app/mcp-server
  ```

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

  ```bash
  node dist/index.js
  ```

## IDE configuration

Add the server to your MCP client config.

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

```jsonc
{
  "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):

```jsonc
{
  "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:

```jsonc
{
  "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:

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

To test with the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):

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