Connect AI Assistants with MCP

Connect AI assistants like Claude to query your Warpmetrics data using natural language.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect to external tools and data sources. With the Warpmetrics MCP server, you can:

  • •Query runs, calls, and outcomes using natural language
  • •Check costs, latency, and success rates conversationally
  • •Get time series data and trend analysis
  • •Investigate individual call details and agent workflows

Setup

1. Get your API key

Create an API key from your account settings. This key allows the MCP server to access your Warpmetrics data.

Create API Key

2. Install the MCP server

Install the Warpmetrics MCP server globally using npm:

Terminal
npm install -g @warpmetrics/mcp

3. Configure Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/.claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

claude_desktop_config.json
{
  "mcpServers": {
    "warpmetrics": {
      "command": "warpmetrics-mcp",
      "env": {
        "WARPMETRICS_API_KEY": "wm_live_your_api_key_here"
      }
    }
  }
}

Replace wm_live_your_api_key_here with your actual API key.

4. Restart Claude Desktop

Quit and reopen Claude Desktop. The Warpmetrics tools will now be available. You can verify by asking Claude "What Warpmetrics tools do you have access to?"

Available Tools

Loading tools...

Example Prompts

Try asking Claude things like:

"How many runs did I have today?"
"What's my total LLM spend this week?"
"Show me the most expensive calls"
"What's the success rate for my Code review agent?"
"List recent failed runs"
"Show me time series data for the last 7 days"

Troubleshooting

"Warpmetrics tools not available"

Make sure you've restarted Claude Desktop after editing the config file. Check that the config JSON is valid and the API key is correct.

"Authentication failed"

Verify your API key is active in API keys settings. Keys can be revoked or may have expired.

"Command not found: warpmetrics-mcp"

Make sure the package is installed globally: npm install -g @warpmetrics/mcp

Open Source

The Warpmetrics MCP server is open source. View the code or report issues on npm.

View on npm