Skip to main content
The Langdock MCP Server exposes your Langdock agents as MCP tools, allowing any MCP-compatible AI client to interact with your workspace agents.
What’s this for?This lets external AI tools (like Claude Desktop, Cursor, or other MCP clients) call your Langdock agents directly. Your agents become tools that any MCP-compatible application can use.

​
MCP Base URL

The Langdock MCP server is available at https://api.langdock.com/mcp. If your organization uses a dedicated Langdock deployment (custom domain), use your deployment’s endpoint instead: https://<your-domain>/api/public/mcp. Replace https://api.langdock.com/mcp with this URL throughout this guide.

​
Authentication

The MCP endpoint requires a valid Langdock API key with the Agent API scope.
Make sure your API key has the Agent API scope enabled. Workspace-admins can create or manage API keys in your workspace settings.

​
Supported Authentication Methods

Header TypeHeader Format
BearerAuthorization: Bearer <api-key>
X-API-Keyx-api-key: <api-key>

​
Available Tools

The Langdock MCP Server exposes three tools:
ToolDescription
find_agentSearch for an agent ID by name
ask_agentSend a prompt to an agent specified by its ID
ask_custom_agentConfigure and query a custom agent on-the-fly

​
find_agent

Use this to look up an agent’s ID when you only know its name. This is helpful when you want to call ask_agent but need to find the correct agent ID first.

​
ask_agent

Send a prompt to a specific agent using its ID. The agent processes your request using its configured model, instructions, and connected integrations. For multi-turn conversations, pass previous turns through the optional messageHistory parameter. Each entry has a role of user or assistant and a content string. Order entries from oldest to newest; the current prompt is appended as the latest user turn. 
{
  "agentId": "agent_123",
  "prompt": "And what about Berlin?",
  "messageHistory": [
    { "role": "user", "content": "What's the weather in Munich?" },
    { "role": "assistant", "content": "Munich is currently 18°C and sunny." }
  ]
}

​
ask_custom_agent

Create a temporary agent with custom settings for a single query. Useful when you need specific behavior without creating a permanent agent in Langdock.

​
Connecting from Langdock

If you want to add this MCP server as an integration within Langdock itself:
1

Navigate to Integrations

Go to Integrations in your workspace settings.
2

Add MCP Integration

Click Add Integration and select MCP as the integration type.
3

Enter Server Details

  • URL: https://api.langdock.com/mcp
  • Authentication method API Key
4

Save & Test

  • Click Create and connect
  • Add a connection using a valid Langdock API key (must have AGENT_API scope)
  • Set the API Key Header Type to Authorization: Bearer
  • Click Test connection to verify access to the available tools

​
FAQ

Use the Langdock Agent MCP Server when an external MCP-compatible client should access Langdock agents as tools. It is useful when teams want to reuse Langdock agents outside the Langdock interface.
Check the MCP client configuration, authentication, agent sharing, available tools, and whether the target agent is published and accessible. Also verify that the external client supports the required MCP behavior.