npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@arispay/payagent-mcp

v6.0.0

Published

Let AI agents pay for APIs through ArisPay: fiat payments (EUR, GBP, USD) with spend mandates, receipts, and idempotency. Four tools: setup, discover, pay, history. Use with Claude, Cursor, or any MCP client.

Readme

@arispay/payagent-mcp

Let AI agents pay for APIs through ArisPay. An MCP server for Claude Desktop, Cursor, Windsurf, or any MCP client. It is a thin wrapper around the payagent SDK.

pay settles an HTTP 402 from your ArisPay funding account in EUR, GBP or USD. ArisPay enforces the agent's mandate (per transaction, per day, per month, allowed domains) before it authorizes a payment.

Tools

Four core tools (the default surface):

| Tool | What it does | Money | |------|--------------|-------| | setup | Create or recover an account and a payer agent in one call | moves none | | discover | Search the ArisPay marketplace by intent and budget | read-only | | pay | Request → 402 → authorize at ArisPay → retry → structured receipt. Requires an idempotencyKey; a repeated key returns the cached receipt and does not pay again | spends real money | | history | Recent payments | read-only |

Agent administration (create_agent, list_agents, rename_agent) loads only when the host config sets PAYAGENT_MCP_PROFILE=admin.

Every tool declares MCP safety annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint). pay is the only destructive tool.

Setup

Add the server to your MCP client config. No environment variables are required.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "arispay": {
      "command": "npx",
      "args": ["-y", "@arispay/payagent-mcp"]
    }
  }
}

Cursor

Same server block in .cursor/mcp.json. Windsurf: same pattern in ~/.codeium/windsurf/mcp_config.json.

Cold start

  1. Ask the agent to run setup({ email: "[email protected]" }). It returns the agent and its mandate.
  2. Add money to your funding account in the ArisPay dashboard.
  3. Ask the agent to pay.

Credentials persist to ~/.payagent/config.json. The payagent CLI uses the same file.

Environment variables (all optional)

| Variable | Description | |----------|-------------| | ARISPAY_API_KEY | Developer key. Usually not necessary: setup makes one. | | ARISPAY_URL | ArisPay API base URL. Default https://api.arispay.app. | | PAYAGENT_MCP_PROFILE | admin additionally loads the three agent-administration tools. Default: core (four tools). |

Receipts and idempotency

pay requires a caller-chosen idempotencyKey (min 8 chars; use a UUID). Every completed payment writes a machine-readable receipt (amount in cents, currency, payment id, remaining mandate) to ~/.payagent/mcp-receipts.json. A second pay with a key that already paid returns the stored receipt and does not pay again.

One exception: the seller took the payment and then failed to deliver. A retry with the same key inside 9 minutes sends the same payment again, and the seller serves it without a new charge.

How it works

  1. The agent calls pay with a URL and an idempotencyKey. The seller answers HTTP 402 with an arispay-fiat offer.
  2. payagent asks ArisPay to authorize the payment. ArisPay checks the mandate and the balance.
  3. payagent retries the request with the authorization. The seller settles it at ArisPay.
  4. The tool returns the response and a structured receipt.

A 402 that has no arispay-fiat offer is not paid. The tool returns an error.

Migrating from v5

v6 is a breaking release. The server pays in fiat only.

| v5 tool | v6 | |---------|----| | setup, discover, pay, history | kept | | create_agent, list_agents, rename_agent | kept, behind PAYAGENT_MCP_PROFILE=admin | | inspect, balance, check_payment_signal, fund_agent | removed |

The variables PAYAGENT_PRIVATE_KEY, ARISPAY_AGENT_KEY and PAYAGENT_WALLET are no longer read.

Install

npm install @arispay/payagent-mcp

Or run it with npx @arispay/payagent-mcp from an MCP client config. npx buyforme-mcp is the same server under the consumer brand.

Related

License

MIT