Feature - MCP Server

The MCP server authenticates each request from Claude using your LinearB API key. All calls are scoped to your organization and respect your existing data access and permissions.

The server exposes a set of tools that map directly to LinearB data domains, such as metrics, repositories, contributors, incidents, and more. Claude uses these tools behind the scenes to answer your prompts.

Once connected, you can ask Claude questions like:

• “Show me cycle time trends for the frontend repo over the last six months.”
• “List incidents resolved by Team Alpha this week.”
• “Generate a merge rate report for all backend teams for the previous quarter.”

Claude translates your prompt into MCP tool calls, runs them against the LinearB MCP server, and presents the result.

The MCP server is a Beta feature and uses generative AI to interpret your prompts. As a result:

• Some responses may be incomplete or partially inaccurate.
• Always verify important numbers (e.g. DORA metrics, team benchmarks) directly in the LinearB Dashboard before using them for official reporting.

Step 1 – Install Node.js

Check if Node.js is installed:

node --version

• If you see a version (e.g. v18.x.x), you’re good to continue.
• If not, install Node.js for your OS (e.g. from nodejs.org or via your package manager).

Step 2 – Install mcp-remote

npm install -g mcp-remote

This installs the mcp-remote CLI globally.

Step 3 – Locate Node and mcp-remote paths

On macOS/Linux, run:

which node
          which mcp-remote

On Windows (Command Prompt or PowerShell), run:

where node
          where mcp-remote

Save both paths — you will need them in the config file.

Step 4 – Edit the Claude Desktop MCP config

1. Open Claude Desktop.
2. Go to Settings → Developer → Edit Config.
3. Add (or merge) the following JSON into your config:

{
            "mcpServers": {
              "linearb": {
                "command": "FULL_PATH_TO_NODE",
                "args": [
                  "FULL_PATH_TO_MCP_REMOTE",
                  "https://mcp.linearb.io/mcp",
                  "--header",
                  "x-api-key: YOUR-API-KEY"
                ]
              }
            }
          }

Replace:

• FULL_PATH_TO_NODE – the value returned by which node or where node.
• FULL_PATH_TO_MCP_REMOTE – the value returned by which mcp-remote or where mcp-remote.
• YOUR-API-KEY – your actual LinearB API key.

Step 5 – Save and restart Claude Desktop

Save the config file and restart Claude Desktop. After restart, Claude will list linearb as an available MCP server.

If you use Claude Code, you can register the LinearB MCP server with a single CLI command (no manual JSON edits).

Step 1 – Run the add command

claude mcp add --transport http linearb https://mcp.linearb.io/mcp --header "x-api-key: LINEARB_API_TOKEN"

Replace: LINEARB_API_TOKEN with your actual LinearB API key.

Step 2 – Confirm registration

After running the command, Claude Code registers the linearb MCP server and makes it available for use in your coding environment.

1. Open Claude Desktop.
2. From the welcome screen or main interface, open the Prompts panel.
3. Click + and select Add from LinearB Metrics.
4. LinearB-specific prompts will appear, including merge rate, lead time, urgent PR, and release reports.

Once enabled, you can run these prompts directly from Claude using your connected LinearB data.

Engineering leaders

• Benchmark delivery, quality, and throughput metrics across teams.
• Identify best practices from high-performing teams and contributors.
• Spot systematic inefficiencies (repos, workflows, or teams that lag consistently).
• Align internal performance metrics with industry benchmarks.

Team leads & managers

• Surface contributor-level patterns in productivity, quality, and collaboration.
• Understand review participation and balance of new code vs. rework.
• Break down coding, reviewing, and deployment times.
• Use precise data to support coaching conversations and 1:1s.

Executives & cross-functional partners

• Generate tailored reports from natural-language questions (no dashboard navigation required).
• Answer ad-hoc questions such as cycle time trends, merge rates, and release outcomes.
• Filter by teams, contributors, repositories, and date ranges as needed.

The following tools are available to Claude through the LinearB MCP server:

You can use these tools through Claude by asking natural-language questions such as: “Show me the top repositories by merge rate last month” or “List incidents resolved by Team Alpha this week.”

LinearB provides a Prompt Library with ready-made MCP prompts, including:

• Merge rate report – Track code delivery velocity and bottlenecks.
• Lead time report – Measure time from work start to completion.
• Urgent PR report – Identify and resolve high-priority PRs.
• Release report – Fetch PRs tied to specific releases.

For a reference of ready-to-use queries, see the LinearB MCP Server Prompt Library (PDF) .

• Confirm you saved the MCP JSON config (Claude Desktop) or ran the claude mcp add command (Claude Code).
• Check that FULL_PATH_TO_NODE and FULL_PATH_TO_MCP_REMOTE are correct and executable.
• Restart Claude after making configuration changes.

• Verify that the x-api-key header uses a valid LinearB API key.
• Check that the key belongs to the correct LinearB organization.
• If a key was rotated or revoked, update your MCP configuration accordingly.

• Re-run the same query directly in the LinearB UI (or via official APIs) to compare results.
• Adjust your prompt to be more specific about teams, repos, and date ranges.
• For persistent discrepancies, capture the prompt and response and contact LinearB support.