# Vybe Pay MCP

> Vybe Pay MCP is a freemium MCP server for finance and payments. Lets Claude or Cursor pay in USDC under spend caps, with Approve or Decline per payment. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API
- **Website:** https://www.vybe.finance/pay-mcp
- **MCP Registry name:** finance.vybe/pay
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Vybe Pay MCP is built around a spend key called a VAPT (vapt_...). In the wallet settings you set a maximum per payment and a daily cap, optionally allowlist sellers and set an expiry, then connect Cursor with the key as a Bearer header or Claude through a Sign in flow where you never paste the secret.

When the agent calls pay_offering or pay_invoice you get a card showing who, what and how much. Approve moves USDC; Decline cancels, or frees an invoice for another payer. The site says nothing is spent silently. create_invoice returns a link another agent can pay, so agents can invoice each other. Today it settles Vybe Collect offerings only, and the site suggests having the agent read the Collect JSON, including its agentTrust section, before paying an unfamiliar listing.

Companies can issue an Org VAPT tied to the business balance, allowlist trusted Collect sellers, and have their backend call the seller's API pay link; the first payment may still need one approval, and an optional auto-settle pool lets trusted payments go through without a tap. Revoking the key stops new payments.

## Features

- **Spend caps:** Set a per-payment maximum and a daily cap on each key.
- **Approve or decline:** Every payment waits for your decision before USDC moves.
- **Revocable keys:** Expire or revoke a spend key at any time.
- **Agent invoices:** create_invoice returns a link another agent can pay with pay_invoice.
- **Org keys for apps:** Business accounts can issue keys for trusted sellers and settle from an auto-settle pool.

## Good for

- Let Claude buy a research listing while you approve each purchase
- Limit what an agent can spend per day
- Have one agent invoice another
- Pay trusted Collect sellers from a company backend

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http pay https://www.vybe.finance/api/mcp/pay
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.vybe.finance/api/mcp/pay
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pay": {
      "url": "https://www.vybe.finance/api/mcp/pay"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pay": {
      "type": "http",
      "url": "https://www.vybe.finance/api/mcp/pay"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pay": {
      "serverUrl": "https://www.vybe.finance/api/mcp/pay"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pay": {
      "type": "http",
      "url": "https://www.vybe.finance/api/mcp/pay"
    }
  }
}
```

## Tools

- `create_invoice`: Create a get-paid invoice for the spend-key owner. Returns a /r/{publicId} URL. Another agent can call pay_invoice with that URL; a human opening the link sees Vybe crypto checkout. Does not move money and does not require Approve. After sharing, call get_invoice with the publicId to check if it was paid before taking a follow-up action. Related: get_invoice, list_invoices, pay_invoice.
- `get_invoice`: Check whether an invoice you created is still pending or already paid. Pass the publicId or /r/ url from create_invoice. Use this before taking a follow-up action that should only run after payment. Only works for invoices owned by this spend key’s owner. Related: create_invoice, list_invoices.
- `list_invoices`: List invoices the spend-key owner created (open, paid, etc.). Use to find a publicId, then get_invoice for details. Related: create_invoice, get_invoice.
- `pay_invoice`: Pay a Vybe invoice by /r/ URL or publicId under the owner’s spend key. Creates awaiting_approval — money does not move until Approve in Vybe. Only vybe.finance/r/… links are allowed (not arbitrary URLs). Friendship is not required. Related: create_invoice, get_invoice, get_limits, get_spend_balance, list_recent_pays.
- `send_to_user`: Send USDC/USDT to a mutual friend. Pass username (@handle) when known, or name (first, last, or full name). Lookup is limited to mutual friends — never invent wallet addresses. If several friends match the name, the tool returns candidates; ask the owner which @username, then retry. Creates a pending pay — money does not move until Approve in Vybe. Trusted mutual friends still Approve once but not
- `search_tools`: Search the Vybe Marketplace for MCP tools the user can use: free tools (run with run_free_tool, no sign-in) and paid tools (pay per use with pay_offering). Use this when the user asks for a capability you do not have, e.g. reading a PDF, looking up a postcode or checking a crypto transaction. Returns name, one-line summary, price, actions and offeringUrl. Never invent tools; if nothing fits, say s
- `get_tool`: Full details for one marketplace tool: actions with their inputs, an example, price, seller and health, plus the exact next step. For a paid tool the next step is pay_offering with its offeringUrl, then use_paid_offering with toolName and toolArguments. For a free tool it is run_free_tool, which needs no sign-in. Pass slug or the tool page URL. Related: search_tools, run_free_tool, pay_offering, u
- `run_free_tool`: Run a free tool from the Vybe Marketplace and get its answer. No sign-in or spend key needed, and nothing is charged. Get the slug, action names and inputs from search_tools or get_tool first. Free tools have fair-use limits per caller; if you hit one, tell the user when it resets. Paid tools can't run here: use pay_offering and use_paid_offering. Related: search_tools, get_tool.
- `pay_offering`: Start a Vybe Collect payment under the owner's connected spend key (OAuth Sign in or Bearer VAPT). Creates a pending pay and returns awaiting_approval — money does not move until the wallet owner taps Approve in Vybe (web or mobile). After paid (or trial), call use_paid_offering with the returned publicId — that unlocks research files, lists/runs seller MCP tools, or proxies paid API calls. Do not
- `get_spend_balance`: Return the bound spend key’s policy headroom for the last 24 hours: daily remaining, pending, and paid. This is not the on-chain USDC wallet balance — use get_wallet_balance for that. Call this before pay_offering to check whether a pay would hit the daily cap. Related: get_wallet_balance, get_limits.
- `get_wallet_balance`: Read-only on-chain USDC/USDT balances for the spend key owner’s Vybe wallet (Base, Ethereum, BNB). Use this to tell the user how much they can spend. Separate from get_spend_balance (VAPT caps). Does not move funds. Related: get_spend_balance, get_limits, pay_offering.
- `get_limits`: Return the bound spend key’s hard limits: label, per-transaction max in USD, daily cap, optional seller allowlist, expiry, and authMode (oauth or vapt). Use this to tell the user what the agent is allowed to request before calling pay_offering. Related: get_spend_balance, get_wallet_balance.
- `list_recent_pays`: List recent Collect pays, friend sends, and invoice pays started by the bound spend key, newest first. Filter by status: pending (waiting on Approve), paid (settled), or all. For paid Collect rows, call use_paid_offering with publicId. Related: pay_offering, pay_invoice, send_to_user, use_paid_offering.
- `use_paid_offering`: After a Collect pay is settled (status paid or trial), use this tool with the publicId from pay_offering. It branches by offering type: research/asset returns the file; MCP lists seller tools (omit toolName) or runs one (pass toolName + toolArguments); API proxies method+path(+body) through Vybe. Prefer this over inventing HTTP calls or scraping marketplace HTML. Related: pay_offering, list_recent
- `fetch_paid_content`: Unlock research/file offerings only. For MCP or API offerings, call use_paid_offering with the same publicId instead. Related: use_paid_offering, pay_offering.

## FAQ

### Can the AI spend without my approval?

Not today. Every payment waits for Approve, except trusted merchants paid from an auto-settle pool you fund.

### What is a VAPT?

A scoped agent spend key with caps, an optional seller allowlist and an expiry.

### What can it pay?

Today it settles Vybe Collect offerings only.

### What does it cost?

Opening a wallet is free; the page lists 1.5% on payment requests.

### Is Vybe Pay MCP free?

Vybe Pay MCP has a free plan, with paid plans for more usage or features.

### How do I add Vybe Pay MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http pay https://www.vybe.finance/api/mcp/pay

### What are the best alternatives to Vybe Pay MCP?

The closest alternatives to Vybe Pay MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/vybe-pay-mcp
