MCP Server

Overview#

Paladin exposes an MCP (Model Context Protocol) server that lets AI assistants like Claude Code, Claude Desktop, and Cursor access your workspace and documentation. Once connected, an assistant can list your agents, fetch agent definitions, and search Paladin docs on your behalf.

Prerequisites#

• A Paladin API key. Generate one in the Paladin app at https://app.paladin.northmanngrp.com/api-keys. See API Keys.
• Your Paladin MCP endpoint: https://app.paladin.northmanngrp.com/api/v1/mcp/

The endpoint is also shown in Platform Settings → MCP Server inside the Paladin UI.

Claude Code#

Register Paladin as an MCP server with the Claude Code CLI:

claude mcp add --transport http paladin https://app.paladin.northmanngrp.com/api/v1/mcp/ \
  --header "X-API-Key: YOUR_API_KEY"

Replace YOUR_API_KEY with the key you generated.

Verify the server is connected:

claude mcp list

Claude Desktop#

Open Claude Desktop's config file (claude_desktop_config.json) and add the paladin entry under mcpServers:

{
  "mcpServers": {
    "paladin": {
      "url": "https://app.paladin.northmanngrp.com/api/v1/mcp/",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop after saving. The Paladin tools should appear in the tool picker.

Cursor and other MCP clients#

Any MCP client that supports Streamable HTTP transport can connect with the same URL and header. Paste the configuration above into your client's MCP settings file and replace YOUR_API_KEY.

Example prompts#

Once the MCP server is connected, you can drive Paladin from your coding agent in plain English. A few prompts to try:

Explore your workspace

• "List my agents in Paladin."
• "Show me the definition of the agent called Lead Qualifier."
• "Which credentials and tools are configured in my Paladin workspace?"
• "List the recordings from my most recent agent."

Edit an agent

• "In my Lead Qualifier agent, add a new agent node after the greeting that asks the caller for their budget, then routes to the existing qualification node."
• "Add an end-call node to Support Bot that triggers when the user says they are done, with a polite goodbye prompt."
• "Rename the intro node in Lead Qualifier to greeting and update any edges that reference it."
• "Change the LLM model on all agent nodes in Support Bot to gpt-4o-mini."

Learn the platform

• "Search the Paladin docs for how to configure a TURN server."
• "What node types does Paladin support, and what fields does a knowledge_base node take?"
• "How do I configure Paladin for my workspace?"