mcpField
B
buyforme-mcp

buyforme-mcp

Local
github.com/arispay-incFinance0Updated 13w ago
Repository

About buyforme-mcp

buyforme-mcp is an alias for `@arispay/payagent-mcp`, giving an MCP-capable client a tool to pay x402-priced URLs through ArisPay delegated custody. It forwards requests to the upstream server without inspecting or modifying the JSON-RPC stream.

Key features

  1. 01Pay x402-priced URLs
  2. 02Use ArisPay delegated custody
  3. 03Check wallets and balances
  4. 04Create, fund, and list agents
  5. 05Apply transaction and domain limits

Use cases

  1. 01Pay an x402-priced URL from an MCP client
  2. 02Check an agent wallet balance
  3. 03Create and fund a payment agent
  4. 04Limit payments by amount or domain

MCP support

This MCP server alias spawns `@arispay/payagent-mcp` and forwards its tools, including `pay_api`, `check_wallet`, and agent management tools. The upstream service handles delegated custody and payment authorization.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "stevemilton-buyforme": {
      "command": "npx",
      "args": [
        "-y",
        "buyforme-mcp"
      ],
      "env": {
        "ARISPAY_API_KEY": "<ARISPAY_API_KEY>",
        "PAYAGENT_PRIVATE_KEY": "<PAYAGENT_PRIVATE_KEY>"
      }
    }
  }
}
Run commandnpx -y buyforme-mcp
Environment variables to set
ARISPAY_API_KEYSecretOptional. ArisPay developer API key (ap_live_… / ap_test_…). The create_user tool can self-provision one from just an email.
PAYAGENT_PRIVATE_KEYSecretEVM 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.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmbuyforme-mcp1.0.2

Tools

19

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
namestringNoHuman name. Falls back to the email local-part.
emailstringYesEmail for the new ArisPay account.

Details

From the project README

buyforme-mcp

MCP server alias for @arispay/payagent-mcp.

Configure your MCP-capable client (Claude Desktop, Cursor, Windsurf, …) to spawn buyforme-mcp and the model gets a "buy for me" tool that pays any x402-priced URL via ArisPay delegated custody — no private keys in your process.

Claude Desktop / Cursor / Windsurf config

{
  "mcpServers": {
    "buyforme": {
      "command": "npx",
      "args": ["-y", "buyforme-mcp"]
    }
  }
}

That's identical to using @arispay/payagent-mcp directly — the proxy spawns the upstream server with stdio inherited, so the JSON-RPC stream flows through without inspection or modification.

What you get inside the model

The same MCP tools the upstream server exposes — pay_api, check_wallet, create_agent, fund_agent, get_balance, list_agents — backed by ArisPay's delegated-custody wallets: Coinbase CDP holds the signing key, ArisPay enforces per-tx, daily, monthly, and allowed-domain limits server-side, and signs on the agent's behalf when it hits an HTTP 402.

For the full tool surface, see the @arispay/payagent-mcp README.

Related

  • buyforme — the matching CLI alias (npx buyforme <url>)
  • payagent — the underlying SDK + CLI

License

MIT © Polar Industries Ltd

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.