Skip to content

MCP Integration (Claude & Cursor)

Vantmetry ships an MCP server (vantmetry-mcp) that lets Claude Code, Claude Desktop, and Cursor query your frontend error logs directly. Instead of switching to the dashboard, you can ask your AI editor:

"Show me the most recent frontend errors"
"How many errors happened in the last 24 hours?"
"What are the top error messages this week?"

Prerequisites

  1. Install the CLI. See Setup & Configuration if you have not done that yet.
  2. Authenticate: vant auth (see CLI Authentication)

Setup

Run the install command for your editor:

bash
# Standard project config (.mcp.json in current directory), picked up by Claude Code and other MCP clients
vant mcp --project

# Claude Desktop app
vant mcp --claude

# Cursor IDE
vant mcp --cursor

You can combine flags to configure multiple editors at once:

bash
vant mcp --project --cursor

What this command does

It writes an entry into the editor's MCP config file:

FlagConfig file
--project./.mcp.json in current directory (Claude Code, and other MCP clients)
--claude~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
--cursor~/.cursor/mcp.json

The entry added:

json
{
  "mcpServers": {
    "vantmetry": {
      "command": "vantmetry-mcp",
      "args": []
    }
  }
}

Existing entries in the config file are preserved.

Available tools

Once connected, Claude and Cursor can use these tools:

ToolWhat it does
get_recent_logsFetch the latest frontend errors and logs
query_logsRun a custom SQL query against vantmetry_logs
get_schemaShow available columns and their types
list_projectsList configured projects
switch_projectSwitch to a different project

Security

The MCP server reads credentials from ~/.vantmetry/config.json on your local machine. Your secret keys stay local. Only the query results are shared with Claude or Cursor.

Reloading the server

After running vant mcp, restart your editor or reload MCP servers:

  • Claude Code: run /mcp in a conversation, or restart the app
  • Claude Desktop: quit and reopen the app
  • Cursor: go to Settings and reload MCP servers