Install MCP

Quick start

npx @melis-ai/x402-tools-mcp

Run this once to verify the server starts. Then configure your agent tool to use it.

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "x402-tools": {
      "command": "npx",
      "args": ["@melis-ai/x402-tools-mcp"],
      "env": {
        "X402_INTERNAL_KEY": "your-issued-key-if-applicable"
      }
    }
  }
}

Restart Claude Desktop. The 16 tools will appear in the tool list.

Cursor

Open Cursor Settings → MCP → Add server:

{
  "mcpServers": {
    "x402-tools": {
      "command": "npx",
      "args": ["@melis-ai/x402-tools-mcp"]
    }
  }
}

Save and reload Cursor. Tools will appear in the Cursor agent tool list.

Claude Code (CLI)

claude mcp add x402-tools -- npx @melis-ai/x402-tools-mcp

Or add the JSON above to ~/.claude/mcp.json (global) or .claude/mcp.json in your project root.

Continue (VS Code / JetBrains)

Add to your ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "x402-tools",
      "command": "npx",
      "args": ["@melis-ai/x402-tools-mcp"]
    }
  ]
}

Available tools

After install, these tool names are callable in your agent:

list_services         — free, returns the full catalogue
cacheserve            — $0.001
docconvert_text       — $0.001
schemagate            — $0.001
notifyrelay_webhook   — $0.001
promptguard           — $0.002
notifyrelay_telegram  — $0.002
structextract         — $0.002
docconvert_pdf        — $0.005
linkrisk              — $0.005
markdownopt           — $0.005
notifyrelay_email     — $0.005
linksafe              — $0.010
scrapepay             — $0.010
screenshot            — $0.020
web_synthesise        — $0.050
pdf_render            — $0.490

Environment variables