# X402 Payagent MCP

> X402 Payagent MCP is an open-source MCP server. Pay x402 APIs in USDC on Base, Solana, and BNB Chain with spend mandates, receipts, idempotency. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Website:** https://arispay.app
- **Repository:** https://github.com/arispay-inc/payagent-mcp
- **MCP Registry name:** io.github.stevemilton/x402-payagent-mcp
- **Listing updated:** 2026-11-18

## About

Pay x402 APIs in USDC on Base, Solana, and BNB Chain with spend mandates, receipts, idempotency.

## Install

### Claude Code (Terminal)

```sh
claude mcp add x402-payagent-mcp --env ARISPAY_API_KEY='<ARISPAY_API_KEY>' --env PAYAGENT_PRIVATE_KEY='<PAYAGENT_PRIVATE_KEY>' -- npx -y @arispay/payagent-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "x402-payagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@arispay/payagent-mcp"
      ],
      "env": {
        "ARISPAY_API_KEY": "<ARISPAY_API_KEY>",
        "PAYAGENT_PRIVATE_KEY": "<PAYAGENT_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "x402-payagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@arispay/payagent-mcp"
      ],
      "env": {
        "ARISPAY_API_KEY": "<ARISPAY_API_KEY>",
        "PAYAGENT_PRIVATE_KEY": "<PAYAGENT_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "x402-payagent-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@arispay/payagent-mcp"
      ],
      "env": {
        "ARISPAY_API_KEY": "<ARISPAY_API_KEY>",
        "PAYAGENT_PRIVATE_KEY": "<PAYAGENT_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "x402-payagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@arispay/payagent-mcp"
      ],
      "env": {
        "ARISPAY_API_KEY": "<ARISPAY_API_KEY>",
        "PAYAGENT_PRIVATE_KEY": "<PAYAGENT_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "x402-payagent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@arispay/payagent-mcp"
      ],
      "env": {
        "ARISPAY_API_KEY": "<ARISPAY_API_KEY>",
        "PAYAGENT_PRIVATE_KEY": "<PAYAGENT_PRIVATE_KEY>"
      }
    }
  }
}
```

## FAQ

### Is X402 Payagent MCP free?

Yes. X402 Payagent MCP is open source, so you can use and self-host it for free.

### How do I add X402 Payagent MCP to Claude Code?

Run this command in your terminal: claude mcp add x402-payagent-mcp --env ARISPAY_API_KEY='<ARISPAY_API_KEY>' --env PAYAGENT_PRIVATE_KEY='<PAYAGENT_PRIVATE_KEY>' -- npx -y @arispay/payagent-mcp

## Where this comes from

- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.

---
Source: https://ai-powered.com/mcp/x402-payagent-mcp
