The Model Context Protocol (MCP) is the emerging standard for how AI agents discover and call tools. Agent402 supports MCP in three ways: a hosted HTTP endpoint, an npm package for local use, and direct integration with Claude Code.
Hosted MCP endpoint
Correction (2026-10-02): the connector's tools were renamed to dotted names (the old names still answer as aliases), and paid tools on the hosted connector are paid with an MPP credential in the call's _meta, not an x402 header. The list and the payment sentence below are updated.
The simplest way to connect: point your MCP client at https://agent402.tools/mcp. This endpoint exposes catalog tools plus a set of flagship tools:
- catalog.search - find tools by keyword or task description
- catalog.find - resolve a task to the best-matching tool
- catalog.call - execute any tool with input parameters
- server.describe - get platform info and capabilities
The hosted endpoint handles PoW challenges internally, so pure-CPU tools are effectively free through MCP. A wallet-only tool called on the connector answers with an MPP payment challenge (JSON-RPC error -32042); an MPP client pays it by sending the credential in the call's _meta["org.paymentauth/credential"].
Claude Code setup
To add Agent402 to Claude Code, add this to your MCP configuration:
{
"mcpServers": {
"agent402": {
"url": "https://agent402.tools/mcp"
}
}
}Once connected, Claude Code can search through all 500+ tools, find the right one for a task, and call it - all through the standard MCP protocol. The catalog.search and catalog.find tools help the agent discover relevant tools without needing to know the full catalog.
npm package (local / stdio)
For local development or air-gapped environments, install the agent402-mcp npm package:
npm install -g agent402-mcpThen configure it as a stdio MCP server in your client:
{
"mcpServers": {
"agent402": {
"command": "agent402-mcp",
"args": []
}
}
}The npm package bundles the same tool definitions and connects to the hosted API for execution. It works with any MCP client that supports stdio transport - Claude Code, Cline, Continue, and others.
Framework adapters
Beyond MCP, we publish framework-specific adapters for direct integration: OpenAI, Anthropic SDK, Vercel AI SDK, LangChain, LlamaIndex, Google ADK, OpenAI Agents, and AWS Strands. Each adapter wraps Agent402 tools in the framework's native tool format, so you can drop them into existing agent code without protocol translation.
All adapters and the MCP package are open source and published on npm. Check the GitHub repo for the latest versions.