@usevane/mcp

MCP server exposing the Vane API to Claude Desktop, Cursor, and any MCP client.

bun add -g @usevane/mcp

Setup

Set your API key:

VANE_API_KEY=proj_xxx

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "vane": {
      "command": "usevane-mcp",
      "env": {
        "VANE_API_KEY": "proj_xxx"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "vane": {
      "command": "usevane-mcp",
      "env": {
        "VANE_API_KEY": "proj_xxx"
      }
    }
  }
}

Available tools

Projects

| Tool | Description | |:-----|:------------| | list_projects | List accessible projects (account keys) | | switch_project | Set active project for subsequent calls |

Read

| Tool | Description | |:-----|:------------| | list_metrics | Project-level traffic metrics | | get_entity_metrics | Metrics for a specific entity | | list_signals | List captured signals | | query_signal_logs | Query signal logs | | get_signal_stats | Signal statistics | | list_rules | List scoring rules | | get_project_config | Current project configuration | | list_datapoints | Available fields for rule conditions | | list_entities | Known entities | | list_keys | API keys | | list_actions | List enforcement actions | | get_action_log | Recent action activations | | get_action_stats | 24h action enforcement summary | | list_webhooks | List webhooks | | test_webhook | Test webhook delivery |

Write

| Tool | Description | |:-----|:------------| | create_rule | Create a scoring rule | | update_rule | Update a scoring rule | | delete_rule | Delete a scoring rule | | create_action | Create an enforcement action | | update_action | Update an enforcement action | | delete_action | Delete an enforcement action | | create_webhook | Create a webhook | | update_webhook | Update a webhook | | delete_webhook | Delete a webhook |

Admin

| Tool | Description | |:-----|:------------| | create_key | Create an API key | | revoke_key | Revoke an API key |

Resources

• vane://config -- project configuration
• vane://rules -- scoring rules
• vane://datapoints -- available signal fields
• vane://entities/{name} -- entity details

Prompts

• investigate_entity -- deep-dive into a specific entity
• project_overview -- summarize project state
• audit_rules -- review scoring rules

Configuration

| Env var | Default | Description | |:--------|:--------|:------------| | VANE_API_KEY | (required) | API key starting with proj_ (project) or vane_ (account) | | VANE_API_URL | https://usevane.dev | API base URL |

Docs

https://vane.moe/docs

License

MIT