Skip to main content

pay

❖ Communityv0.1.0

Tools · by solana-foundation · added

Discover priced APIs and pay per request (HTTP 402, x402, MPP) in stablecoins through the official hosted Pay MCP server (Streamable HTTP at https://connect.pay.sh/mcp, OAuth sign-in, no keys or local wallet), with the pay workflow skill bundled. Portable Agent Plugins v1 package (mcp.json + skills/), no Python or executables.

Open in Hermes Desktop
hermes plugins install pay
Repository ↗Reviewed source @ d76d57d ↗Documentation ↗

README

From the reviewed commit d76d57d ↗; it updates when the author re-pins.

Pay agent plugin

The official Pay plugin for AI agents. Discover priced APIs and pay per request (HTTP 402, x402, MPP) with stablecoins, without API keys. Every payment is confirmed by you before funds move.

This is a portable Agent Plugins v1 package. It contains:

  • mcp.json: the hosted Pay MCP server (https://connect.pay.sh/mcp, Streamable HTTP, OAuth sign-in). No local binary, wallet file or API key.
  • skills/pay: an Agent Skill that teaches the agent how to pick a provider, plan spend, make the smallest useful paid call, and stop on a declined payment.

There is no executable code and nothing that downloads or updates itself.

Install in Hermes Agent

From the Hermes plugin catalog:

hermes plugins install pay
hermes plugins enable pay

Or directly from this repository:

hermes plugins install solana-foundation/pay/agent-plugins/pay --no-enable
hermes plugins enable pay

Then connect your Pay account. Hermes signs in only to MCP servers you add yourself, so add the Pay server once:

hermes mcp add pay --url https://connect.pay.sh/mcp --auth oauth --connect-timeout 300

Your browser opens the Pay sign-in page. Approve access; the command waits up to five minutes. Hermes then lists the Pay tools. They load in your next session (or after /reload-mcp). To sign in again later, run hermes mcp login pay. Over SSH, follow Hermes's redirect-paste or port-forwarding instructions.

Keep the name pay: your entry then takes the place of the plugin's server entry, and the plugin keeps providing the pay skill.

In Hermes Desktop, open Capabilities → Connectors, choose Add your own, enter name pay, type Streamable HTTP, URL https://connect.pay.sh/mcp, auth OAuth, then choose Authenticate.

You can browse the catalog before funding the account. When a call needs a wallet, Pay replies with a setup link.

Local wallet instead

To keep the wallet on your machine, install the pay-cli plugin instead. It runs the local pay mcp server. Both plugins can be installed side by side.

What to know before installing

  • Spends money. The curl tool pays HTTP 402 challenges from your Pay balance in stablecoins. Pay asks for confirmation of each payment through MCP elicitation; Hermes shows the request to you and declines it when nobody can answer (cron, unattended runs). Hosted Pay also enforces its own spending policy. Hosted confirmations do not use local Touch ID.
  • Network calls. Tool calls go to connect.pay.sh, and paid requests reach the catalog provider you choose through the Pay gateway.
  • Remote tool set. The tools are served by the hosted MCP server at runtime and are not covered by the pinned commit. The plugin marks the server untrusted, so Hermes asks before each write-capable call while the plugin's own server entry is in use.
  • Shared account. Chats that share a Hermes profile share its Pay account. Use a personal profile.
  • Credentials. OAuth tokens are stored by Hermes's MCP client in your Hermes home. The plugin reads no credential files.
  • No telemetry is sent by the plugin.

License

MIT

More by solana-foundation

All 2 plugins by solana-foundation →
pay-cli❖ Community

Discover priced APIs and pay per request (HTTP 402, x402, MPP) in stablecoins from a wallet on this machine, through the local `pay mcp` stdio server of the official Pay CLI, with the pay workflow skill bundled. Portable Agent Plugins v1 package (mcp.json + skills/), no Python or executables; the user installs the `pay` CLI (brew or npm) and runs `pay setup` first, and the server is offered only while `pay` is on PATH. Disclosure — payments plugin for pay.sh: Hermes starts `pay mcp` as a long-running local process; the curl tool spends the local wallet's stablecoin balance; each payment is confirmed by the user through MCP elicitation (PAY_FORCE_ELICITATION=1, declined when nobody can answer) and the server is marked untrusted; every profile using the plugin shares the same local wallet.

Tools

← Back to the catalog · catalog built Oct 17, 2026