MCP Integration

Applies to SDK 0.16+ · Last updated: 2026-06-12

The Model Context Protocol (MCP) is an open standard for connecting AI models to external tools and data sources. The AgentNode MCP adapter lets you search, resolve, and browse the AgentNode registry directly from MCP-compatible editors like Claude Code and Cursor.

Installation

terminal

$ pip install agentnode-mcp

Two modes of operation

The MCP adapter runs in two modes:

Pack server -- exposes a single installed pack as MCP tools. Use when you want to give an editor access to one specific pack.
Platform server -- exposes the full AgentNode platform API as MCP tools. Use when you want to search, resolve, and browse the registry from your editor.

Pack server

terminal

# Expose a single pack as MCP tools
$ agentnode-mcp --pack pdf-reader-pack

Platform server

terminal

# Expose the full AgentNode platform API
$ agentnode-mcp-platform --api-url https://api.agentnode.net

Available MCP tools (platform server)

Tool	Description
agentnode_search	Search the registry for packages by query, framework, and trust level
agentnode_resolve	Resolve capability IDs to ranked package recommendations
agentnode_explain	Get a detailed explanation of a package's capabilities and permissions
agentnode_capabilities	List all available capability IDs in the taxonomy

Claude Code configuration

Add the following to your Claude Code MCP configuration file (typically claude_desktop_config.json or your project .mcp.json):

claude_desktop_config.jsonjson

{
  "mcpServers": {
    "agentnode": {
      "command": "agentnode-mcp-platform",
      "args": ["--api-url", "https://api.agentnode.net"],
      "env": {
        "AGENTNODE_API_KEY": "ank_live_abc123def456"
      }
    }
  }
}

Cursor configuration

Add the same server block to your Cursor MCP settings. The exact file location depends on your OS:

cursor mcp configjson

{
  "mcpServers": {
    "agentnode": {
      "command": "agentnode-mcp-platform",
      "args": ["--api-url", "https://api.agentnode.net"],
      "env": {
        "AGENTNODE_API_KEY": "ank_live_abc123def456"
      }
    }
  }
}

Using a specific pack in your editor

To expose a specific installed pack as an MCP tool (so your editor can use it directly):

claude_desktop_config.jsonjson

{
  "mcpServers": {
    "pdf-reader": {
      "command": "agentnode-mcp",
      "args": ["--pack", "pdf-reader-pack"]
    }
  }
}