Linea Docs

MCP Servers

Connect Model Context Protocol servers as tools in your workflows.

MCP Servers

Linea supports the Model Context Protocol (MCP) — an open standard for connecting AI models to external tools and data sources. Register an MCP server in your workspace and its tools become available to any workflow.

What is MCP?

MCP lets you expose a set of callable tools via a standard protocol. Once a server is registered, Linea's execution engine connects to it during workflow runs and makes its tools available to Agent nodes — the same way built-in tools like HTTP or Slack work.

This means you can connect workflows to internal services, databases, custom scripts, or any third-party system that implements the MCP spec.

Transport types

TransportWhen to use
ssePersistent HTTP streams — most common for hosted servers
streamable-httpHTTP with streaming (MCP 2025 spec)
stdioLocal process-based servers

Authentication

MCP servers support four auth modes:

ModeDescription
noneNo authentication
bearerBearer token in the Authorization header
basicHTTP Basic authentication
customCustom headers or auth scheme

Credentials are encrypted at rest.

API Endpoints

MethodPathDescription
GET/workspaces/:wId/mcp-serversList registered servers
POST/workspaces/:wId/mcp-serversRegister a new server
GET/workspaces/:wId/mcp-servers/:idGet server details
PATCH/workspaces/:wId/mcp-servers/:idUpdate server config
DELETE/workspaces/:wId/mcp-servers/:idRemove server
POST/workspaces/:wId/mcp-servers/:id/syncDiscover and sync tools from the server
GET/workspaces/:wId/mcp-servers/:id/toolsList synced tools
POST/workspaces/:wId/mcp-servers/searchSearch tools by description

Syncing tools

After registering a server, call /sync to discover its tools. Linea connects to the server, fetches the tool list, and stores them for use in workflows.

Re-sync any time the server's tools change.

Using MCP in workflows

Add an MCP node to your workflow and select the server and tool you want to call. Tool inputs map to workflow variables.

MCP tools are also available inside Agent nodes — the agent can call them automatically when it determines they're needed.

MCP servers are registered at the workspace level and available to all workflows within that workspace.

On this page