Skip to main content

LinearB MCP

The LinearB Model Context Protocol (MCP) server gives AI assistants access to engineering metrics and delivery data. Connect it through Cequence AI Gateway to analyze cycle time, pull requests, releases, incidents, teams, repositories, AI tool adoption, and project-management activity from your AI client.

Overview​

LinearB MCP is a remote, vendor-hosted MCP server. LinearB hosts and maintains the server, so no local installation is required.

  • Server URL: https://mcp.linearb.io/mcp
  • Transport: HTTP
  • Hosted by: LinearB

Supported authentication types​

TypeSupportedNotes
OAuthYesRecommended. Sign in to LinearB and approve access in the browser when prompted.
API keyYesAlternative for clients that do not support OAuth. Generate a key under Settings > API Tokens in LinearB.

Use OAuth unless your client requires static credentials. API-key header names vary by client: LinearB documents API_KEY for Cursor and x-api-key for other configurations.

What can you do with this MCP server​

LinearB MCP provides tools for:

  • Engineering metrics — Analyze cycle time, pull request throughput, code activity, deployment frequency, mean time to recovery (MTTR), change failure rate, and AI tool adoption.
  • Benchmarks — Compare metrics against LinearB benchmark thresholds.
  • Pull requests and branches — Search pull requests and branches using repository, contributor, status, date, and other filters.
  • Releases and incidents — Review releases, deployment stages, and incidents shown in LinearB.
  • Teams and contributors — Find teams, groups, users, and contributors and use their IDs in filtered queries.
  • Repositories and services — Resolve repository IDs and inspect the services associated with repositories.
  • Issues and project-management data — Query issues, projects, boards, labels, epics, and custom fields, and calculate issue lead time.
  • Custom metrics — Discover externally reported metrics configured for your organization.

Some LinearB tools have strict input requirements. When a tool description instructs you to call get_tool_documentation first, do so before invoking that tool.

Prerequisites​

Before adding LinearB MCP in Cequence AI Gateway, ensure you have:

  • Access to Cequence AI Gateway at aigateway.cequence.ai
  • A LinearB account with access to the engineering data you want AI tools to use
  • Company Admin access in LinearB
  • Access to the correct LinearB workspace
  • For API-key authentication, a LinearB API key generated under Settings > API Tokens

Example workflows​

  • “Show me pull requests merged this week.”
  • “Which teams have the highest cycle time?”
  • “Compare our deployment frequency with LinearB benchmarks.”
  • “Summarize incidents from the last 30 days.”
  • “Show AI coding-assistant adoption by team.”
  • “Calculate lead time for issues completed this quarter.”

Connecting MCP server from Cequence AI Gateway​

  1. Log in to Cequence AI Gateway.
  2. Choose your tenant.
  3. Go to App catalogue.
  4. Filter by Remote MCP server.
  5. Search for LinearB and then select it.
  6. Select Create MCP server.
  7. Choose OAuth and complete the LinearB sign-in and approval flow.
  8. Complete the remaining setup, select tools, and deploy.

Use the generated MCP server URL in your client as described in the Client Configuration docs. For detailed gateway setup steps and screenshots, see Create a third-party MCP Server.

Additional information​

  • OAuth behavior: Depending on the client, you may see a Connect prompt, be redirected to a browser automatically, or need to start authentication from the client's MCP settings.
  • API-key alternative: Use an API key only when OAuth is unavailable or the client requires static credentials.
  • Verification: Confirm that the client reports the server as connected and can return LinearB metrics or pull request data without repeatedly requesting authentication.
  • Troubleshooting: Restart the client after configuration, confirm Company Admin access, and verify that you signed in to the intended LinearB workspace.
  • Beta status: Verify metrics in the LinearB UI before using them for critical decisions.
  • Official documentation: Connect to LinearB MCP Server.
Last updated on