Skip to main content
Linear is a project management tool for tracking issues, projects, cycles, and product development. TrueFoundry ships it as a fully managed MCP server, so your agents can read and manage Linear work items without any infrastructure setup on your end. You add it from the TrueFoundry catalog, authorize once via OAuth2, and the endpoint is immediately available to every MCP-compatible client you use.

​
How TrueFoundry Manages the MCP Server

TrueFoundry’s MCP Gateway acts as a reverse proxy between your agents and MCP servers like Linear. When you add Linear as a managed MCP, TrueFoundry handles:
  • Authentication — Agents authenticate once to the TrueFoundry MCP Gateway. The gateway handles outbound auth to Linear. Authorization happens directly between your account and your Linear workspace through the OAuth2 flow; TrueFoundry does not receive your Linear credentials.
  • Tool-level access control — You can selectively enable or disable individual Linear tools per team from the TrueFoundry UI.
  • Audit trail — Every tool invocation is traced with the calling user, tool name, input payload, and latency. Traces export via OpenTelemetry to your observability stack.
  • Guardrails — TrueFoundry’s guardrail hooks apply at mcp_pre_tool (before a tool is invoked) and mcp_post_tool (after the tool returns), letting you enforce content policies on Linear requests and results in real time.

​
Adding Linear to TrueFoundry

1

Open the MCP Server catalog

Navigate to MCP Servers in the TrueFoundry sidebar and click Add new MCP Server. On the next screen, select Connect TrueFoundry Managed MCPs — this opens the catalog of pre-vetted, fully configured MCP servers managed by TrueFoundry.
Add new MCP Server picker with the Connect TrueFoundry Managed MCPs option highlighted
2

Add Linear

Find linear in the catalog (described as “Linear is a project management tool”) and click + Add. TrueFoundry registers the server and takes you to the Linear MCP server detail page.
TrueFoundry managed MCP catalog with the linear card highlighted
3

Authenticate

The Tools tab shows that you’re not connected yet. Click Connect Now. An authorization popup appears showing the MCP client name, the TrueFoundry website, and the redirect URI (https://auth.truefoundry.com/mcp/oauth2/callback). Review the details and click Approve — you’ll then be redirected to authenticate with your Linear workspace and grant access.
TrueFoundry does not receive your Linear credentials — the authorization is between your account and Linear directly.
OAuth authorization popup requesting access, showing the redirect URI and an Approve button before redirecting to the Linear workspace
4

Verify tools

After approving, the Tools tab populates with Linear’s available tools — working with issues, comments, attachments, cycles, documents, and more. Each tool shows its description and a Try button so you can test it before wiring it into an agent. Tools are labeled Read-only or Destructive so you can see at a glance which ones modify data.
Linear Tools tab populated with the available tools after a successful OAuth2 connection, each labeled Read-only or Destructive

​
Connecting to an MCP Client

TrueFoundry exposes the Linear MCP server over HTTP transport. The endpoint is specific to your TrueFoundry tenant, so don’t construct it by hand — copy the exact URL and ready-to-paste connection commands from the How To Use tab on the Linear server detail page. The How To Use tab generates connection instructions for every major client, including Cursor, VS Code, Claude Code, Claude Web, Claude Desktop, Windsurf, Codex, and the Python and TypeScript MCP SDKs. Pick your client, copy the snippet, and paste it in. Click Show API Key on that tab to retrieve the API key if your client requires it as a header.
Linear How To Use tab showing connection commands for multiple MCP clients

​
Using the Tool Playground

Before deploying an agent, you can test any Linear tool directly in TrueFoundry:
1

Open a tool

On the Linear MCP server detail page, click Try next to any tool — for example get_issue.
2

Fill in the inputs

Provide the tool’s inputs. For get_issue, enter the issue Id and optionally toggle Include Relations, Include Customer Needs, or Include Releases.
3

Execute and inspect

Click Execute Tool and inspect the JSON output in the right panel.
Linear tool playground showing the get_issue inputs and the JSON output panel

​
Tool Metrics

The Tool Metrics tab on the Linear server detail page shows per-tool usage data: invocation count, latency distribution, and error rates. Use this to monitor which tools your agents are using and whether any tool is producing errors in production.

​
Disabling Individual Tools

If your use case only needs a subset of Linear’s tools, you can disable the rest from the Tools tab. Each tool has a toggle to enable or disable it. Disabled tools are not callable by agents — they will not appear in the tool list returned to the MCP client. This reduces the tool surface exposed to the agent and avoids unnecessary calls — for example, disabling Destructive tools to keep an agent read-only.

​
Next Steps

TrueFoundry Managed MCPs

Provision pre-vetted MCP servers like Linear from the TrueFoundry catalogue with just a name.

MCP Gateway Getting Started

Add MCP servers and use them in the AI Gateway playground and IDEs.

Linear documentation

Reference for Linear’s concepts — issues, projects, cycles, and workflows.

MCP Gateway Security

Configure authentication and guardrails on your MCP servers.