2 min read
MCP Server

The mindpass mcp command starts a Model Context Protocol server over stdio, letting AI agents make paid requests and probe origins directly.

Tools

ToolDescription
fetch_with_paymentFetch a URL, automatically handling HTTP 402 payment challenges
probe_originProbe an HTTP origin to discover its payment protocol requirements

Setup with Claude Code

1. Install mindpass globally:

brew tap remyjkim/mindpass
brew install mindpass

2. Set your private key:

export MINDPASS_PRIVATE_KEY=0x_YOUR_PRIVATE_KEY_HERE

3. Add to your Claude Code MCP config:

Add the following to your ~/.claude/claude_desktop_config.json (or your project’s .mcp.json):

{
  "mcpServers": {
    "mindpass": {
      "command": "mindpass",
      "args": ["mcp"],
      "env": {
        "MINDPASS_PRIVATE_KEY": "0x_YOUR_PRIVATE_KEY_HERE"
      }
    }
  }
}

That’s it. Claude Code will now have access to fetch_with_payment and probe_origin tools, enabling it to call paid APIs and discover payment requirements on your behalf.

Usage Examples

Once connected, Claude Code can: