pay-mcp

Name: pay-mcp
Author: vauban.tech

本地服务

@vauban.tech金融数据

关于 pay-mcp

为 MCP 客户端提供 x402 支付工具和 `buy` 命令：读取报价、同意并付款。Starknet、Base。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "tech-vauban-pay": {
      "command": "npx",
      "args": [
        "-y",
        "@vauban-pay/mcp"
      ],
      "env": {
        "STARKNET_RPC_URL": "<STARKNET_RPC_URL>",
        "PAY_MCP_SEPOLIA_ACCOUNT_ADDRESS": "<PAY_MCP_SEPOLIA_ACCOUNT_ADDRESS>",
        "PAY_MCP_SEPOLIA_PRIVATE_KEY": "<PAY_MCP_SEPOLIA_PRIVATE_KEY>",
        "PAY_MCP_STANDARD_X402_PAYEES": "<PAY_MCP_STANDARD_X402_PAYEES>",
        "PAY_MCP_STANDARD_X402_MAX_WEI": "<PAY_MCP_STANDARD_X402_MAX_WEI>",
        "PAY_MCP_STANDARD_X402_ACCOUNT_ADDRESS": "<PAY_MCP_STANDARD_X402_ACCOUNT_ADDRESS>",
        "PAY_MCP_STANDARD_X402_PRIVATE_KEY": "<PAY_MCP_STANDARD_X402_PRIVATE_KEY>",
        "PAY_MCP_EVM_KEYSTORE_PATH": "<PAY_MCP_EVM_KEYSTORE_PATH>",
        "PAY_MCP_EVM_PASSWORD_PATH": "<PAY_MCP_EVM_PASSWORD_PATH>",
        "PAY_MCP_EVM_NETWORKS": "<PAY_MCP_EVM_NETWORKS>",
        "PAY_MCP_EVM_PAYEES": "<PAY_MCP_EVM_PAYEES>",
        "PAY_MCP_EVM_MAX_PER_PAYMENT": "<PAY_MCP_EVM_MAX_PER_PAYMENT>",
        "PAY_MCP_EVM_MAX_PER_SESSION": "<PAY_MCP_EVM_MAX_PER_SESSION>",
        "PAY_MCP_EVM_I_ACCEPT_MAINNET_SPEND": "<PAY_MCP_EVM_I_ACCEPT_MAINNET_SPEND>",
        "PAY_MCP_EVM_ASSETS": "<PAY_MCP_EVM_ASSETS>"
      }
    }
  }
}

启动命令npx -y @vauban-pay/mcp

需要配置的环境变量

STARKNET_RPC_URLStarknet RPC endpoint. Optional. The buy command contacts no node unless you name one (a Starknet mainnet node; the chain it serves must then be the offer's). The chain-reading tools default to a public node not operated by Vauban.

PAY_MCP_SEPOLIA_ACCOUNT_ADDRESSStarknet Sepolia account address for make_payment signer mode. Optional; without it make_payment uses the sponsored mode, which calls the sponsor over the network and settles a real Sepolia transfer it funds.

PAY_MCP_SEPOLIA_PRIVATE_KEY密钥Private key for that account. Optional; never required to try the tools.

PAY_MCP_STANDARD_X402_PAYEESStandard x402 path (Starknet): comma-separated payTo addresses pay_for_resource may pay. Empty pays nobody (fail closed). * pays any payee: avoid it.

PAY_MCP_STANDARD_X402_MAX_WEIStandard x402 path: cap on one payment in atomic units (default 0.1 STRK).

PAY_MCP_STANDARD_X402_ACCOUNT_ADDRESSStandard x402 path: a signer of its own (falls back to PAY_MCP_SEPOLIA_*).

PAY_MCP_STANDARD_X402_PRIVATE_KEY密钥Private key for that account. Optional.

PAY_MCP_EVM_KEYSTORE_PATH密钥EVM path: path to your Web3 Secret Storage v3 keystore. Never a key in the environment.

PAY_MCP_EVM_PASSWORD_PATH密钥EVM path: path to the file holding that keystore's password.

PAY_MCP_EVM_NETWORKSEVM path: comma-separated CAIP-2 networks pay_for_resource may pay on, e.g. eip155:84532. Empty pays nothing (fail closed).

PAY_MCP_EVM_PAYEESEVM path: comma-separated payTo addresses pay_for_resource may pay. Empty pays nobody (fail closed). * pays any payee, up to the session cap: avoid it.

PAY_MCP_EVM_MAX_PER_PAYMENTEVM path: cap on one payment, in atomic units of the asset (1000000 = 1 USDC). No default: unset refuses.

PAY_MCP_EVM_MAX_PER_SESSIONEVM path: cap on the total value of the signed authorizations this process hands over, per network and asset, never credited back. No default: unset refuses.

PAY_MCP_EVM_I_ACCEPT_MAINNET_SPENDEVM path: comma-separated CAIP-2 value networks you consent to spend real money on, each named (e.g. eip155:8453). Required for any network other than Base Sepolia and Ethereum Sepolia.

PAY_MCP_EVM_ASSETSEVM path: comma-separated <CAIP-2>/<token address> entries payable. Default: the network's known USDC only.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@vauban-pay/mcp0.19.0stdio