Payagent MCP Server
by arispay-incio.github.stevemilton/payagent-mcpv4.0.0
Pay x402 APIs in USDC on Base, Solana, and BNB Chain with spend mandates, receipts, idempotency.
context tax
queued
security
queued
cold start
queued
freshness
Maintained44d ago
Install Payagent MCP server
Install in Claude Code
claude mcp add payagent -e ARISPAY_API_KEY='<arispay-api-key>' -e PAYAGENT_PRIVATE_KEY='<payagent-private-key>' -- npx -y @arispay/payagent-mcpInstall in Cursor
{
"mcpServers": {
"payagent": {
"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 (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"payagent": {
"command": "npx",
"args": [
"-y",
"@arispay/payagent-mcp"
],
"env": {
"ARISPAY_API_KEY": "<arispay-api-key>",
"PAYAGENT_PRIVATE_KEY": "<payagent-private-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"payagent": {
"type": "stdio",
"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 in your workspace.
Install in Windsurf
{
"mcpServers": {
"payagent": {
"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.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ARISPAY_API_KEY | — | yes | ArisPay developer API key (ap_live_… / ap_test_…). Optional — the create_user tool can self-provision one from just an email, or set PAYAGENT_PRIVATE_KEY to sign locally with no account. |
| PAYAGENT_PRIVATE_KEY | — | yes | EVM private key for permissionless local signing (zero-signup mode): pay_api signs x402 payments with it directly — no ArisPay account needed. Generate one with `npx payagent wallet new`. Never sent to any server. |
Freshness
Maintained — last maintenance signal 44d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-27 · 44d ago · GitHub
Latest release
2026-08-27 · 44d ago · GitHub · v4.1.0
Package published
no data · npm/PyPI
Registry entry updated
2026-08-25 · 46d ago · official registry · v4.0.0
FAQ
›How do I install the Payagent MCP server in Claude Code?
Run: claude mcp add payagent -e ARISPAY_API_KEY='<arispay-api-key>' -e PAYAGENT_PRIVATE_KEY='<payagent-private-key>' -- npx -y @arispay/payagent-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Payagent require an API key?
Yes. It expects ARISPAY_API_KEY, PAYAGENT_PRIVATE_KEY, of which 2 are secrets.
›Can I use Payagent as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Payagent in the official MCP registry?
Yes, as io.github.stevemilton/payagent-mcp.