MCP server

​

What you can do

• Query metrics — Get aggregated metrics like code output, PR cycle time, review turnaround, and more
• Drill down into data — See the actual PRs, tasks, and reviews behind each metric
• Explore teams and accounts — List team structures and individual contributors
• Analyze AI skill usage — See which agent skills (reusable workflows like graphite-pr) your team runs, trends over time, and per-engineer breakdowns
• Filter and group — Slice data by team, repository, time period, PR type, and AI coding tool
• Query in your timezone — Interpret date boundaries and sub-day time windows (for example, PRs merged between 4pm and 10pm Pacific) in a named IANA timezone

​

Setup instructions

​

Headless jobs

mutation CreateMCPServiceClient($name: String!) {
  create_mcp_service_client(name: $name) {
    client {
      client_id
      name
      created_at
    }
    client_secret
  }
}

{
  "data": {
    "create_mcp_service_client": {
      "client": {
        "client_id": "mcp_3LKQhvGUcADgqoEM3bh6pslE",
        "name": "weekly-output-watch",
        "created_at": "2026-09-21T18:00:00Z"
      },
      "client_secret": "mcpsec_..."
    }
  }
}

token_response=$(curl --fail-with-body -sS \
  -u "$WEAVE_MCP_CLIENT_ID:$WEAVE_MCP_CLIENT_SECRET" \
  -d grant_type=client_credentials \
  -d scope=mcp:tools \
  https://app.workweave.ai/public/token)
export WEAVE_MCP_ACCESS_TOKEN="$(jq -r .access_token <<<"$token_response")"

curl --fail-with-body -sS \
  -H "Authorization: Bearer $WEAVE_MCP_ACCESS_TOKEN" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' \
  https://app.workweave.ai/public/mcp

curl --fail-with-body -sS \
  -H "X-API-Key: $WEAVE_API_KEY" \
  -d grant_type=client_credentials \
  -d scope=mcp:tools \
  https://app.workweave.ai/public/token

mutation DeleteMCPServiceClient($clientId: ID!) {
  delete_mcp_service_client(client_id: $clientId)
}

​

Cursor

{
  "mcpServers": {
    "weave": {
      "type": "http",
      "url": "https://app.workweave.ai/public/mcp"
    }
  }
}

​

Claude Code

claude mcp add --transport http weave https://app.workweave.ai/public/mcp

• .mcp.json at the root of your project — project scope; shared with your team via git
• ~/.claude.json — local scope (what claude mcp add uses by default) and user scope (claude mcp add --scope user; available across all projects). This is separate from other Claude Code settings under ~/.claude/settings.json.

{
  "mcpServers": {
    "weave": {
      "type": "http",
      "url": "https://app.workweave.ai/public/mcp"
    }
  }
}

​

Claude Desktop

1. Go to Settings > Connectors (in claude.ai, this is also accessible as Customize > Connectors).
2. Click the + button next to Connectors, then select “Add custom connector”.
3. Set the name to Weave and the remote MCP server URL to https://app.workweave.ai/public/mcp, then click Add.
4. Find Weave in your list of connectors and click Connect.
5. In the browser window that pops up, sign in to Weave and click Authorize.

1. Go to Organization settings > Connectors.
2. Click the Add button.
3. Hover over Custom, then select Web.
4. Enter the name Weave and the remote MCP server URL https://app.workweave.ai/public/mcp.
5. Click Add.

1. Go to Settings > Connectors (or Customize > Connectors).
2. Find Weave in the list (it will have a “Custom” label) and click Connect.
3. In the browser window that pops up, sign in to Weave and click Authorize.

​

Visual Studio Code

1. Press CTRL/CMD + SHIFT + P and search for MCP: Add Server
2. Select HTTP and enter the URL: https://app.workweave.ai/public/mcp
3. Enter the name Weave and hit enter
4. A browser window will open for Weave login on first connection

​

Windsurf

1. Press CTRL/CMD + , to open Windsurf settings
2. Scroll to Cascade > MCP servers
3. Select Add Server > Add custom server
4. Add the following:

{
  "mcpServers": {
    "weave": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.workweave.ai/public/mcp"
      ]
    }
  }
}

​

Other clients

• URL: https://app.workweave.ai/public/mcp
• Authentication: OAuth 2.1 (automatic)

​

Available tools

​

Example queries

• “What was our team’s code output last week?”
• “Show me the PRs with the longest cycle time this month”
• “Compare AI-assisted vs manual code output for the backend team”
• “Show code output grouped by Linear initiative last month”
• “Who has the fastest code review turnaround?”
• “List all PRs merged to main this quarter, grouped by type”
• “Which agent skills did the team use most last month?”
• “Show me who ran the graphite-pr skill and how often”
• “Which PRs merged between 4:22pm and 10:43pm Pacific on June 11?”
• “Read the full API documentation at /api-reference/metrics/get-metrics.md”

​

Timezone and time-of-day filtering

• PR metrics — primary timestamp is merge time (Merged at), not when the PR was opened or committed
• Date-only requests (no clock time) keep standard calendar-day behavior

​

Authentication

​

OAuth 2.1

• No long-lived secrets to paste into config files
• Works with clients that don’t support environment variable substitution
• Tokens are scoped to your account and organization

​

FAQ