X402 Payagent MCP
Pay x402 APIs in USDC on Base, Solana, and BNB Chain with spend mandates, receipts…
- Pricing
- Open source
- Runs
- Locally
- Version
- 4.1.0
- Listing updated
- today
About X402 Payagent MCP
X402 Payagent MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Pay x402 APIs in USDC on Base, Solana, and BNB Chain with spend mandates, receipts, idempotency.
Install
Run in a 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-mcpAdd to claude_desktop_config.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>"
}
}
}
}Add to ~/.cursor/mcp.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>"
}
}
}
}Add to .vscode/mcp.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>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.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>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"x402-payagent-mcp": {
"command": "npx",
"args": [
"-y",
"@arispay/payagent-mcp"
],
"env": {
"ARISPAY_API_KEY": "<ARISPAY_API_KEY>",
"PAYAGENT_PRIVATE_KEY": "<PAYAGENT_PRIVATE_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ARISPAY_API_KEYArisPay developer API key (ap_live_… / ap_test_…). Optional — the setup tool can self-provision one from just an email, or set PAYAGENT_PRIVATE_KEY to sign locally with no account.PAYAGENT_PRIVATE_KEYEVM private key for permissionless local signing (zero-signup mode): pay signs x402 payments with it directly — no ArisPay account needed. Generate one with `npx payagent wallet new`. Never sent to any server.
Pricing
Open source
Prices change. Check arispay.app before you buy.
X402 Payagent MCP 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.