x402store-mcp

MCP server for storing files permanently on IPFS via x402.storage.

Installation

npm install -g x402store-mcp

Or clone and build locally:

git clone https://github.com/anthropics/x402store-mcp
cd x402store-mcp
npm install
npm run build

Configuration

1. Set up your wallet

Export your Base wallet private key:

export X402_PRIVATE_KEY=0x...

Need a wallet? Create one at x402.storage.

2. Configure Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "x402store": {
      "command": "node",
      "args": ["/path/to/x402store-mcp/dist/index.js"],
      "env": {
        "X402_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "x402store": {
      "command": "x402store-mcp",
      "env": {
        "X402_PRIVATE_KEY": "0x..."
      }
    }
  }
}

3. Restart Claude Desktop

Fully quit and restart Claude Desktop for the configuration to take effect.

Usage

Once configured, you can ask Claude to store files:

"Store the file /path/to/document.pdf permanently"

Claude will use the store_file tool to upload the file and return the permanent IPFS URL.

Tool

store_file

Store a file permanently on IPFS.

Input:

• file_path (string): Absolute or relative path to the file

Output:

• Permanent IPFS gateway URL (e.g., https://x402.storage/bafybeig...)

Errors:

• File not found
• Insufficient balance (fund wallet at x402.storage)
• Network error

Cost

Each upload costs $0.01 USDC on Base. Files are stored permanently.

License

MIT