# Vybe

> Money app for humans and AI agents. Wallet, Collect (get paid), Pay (send by @username), and Vybe Pay MCP (agents request pays under caps — you Approve).

Canonical site: https://www.vybe.finance
Use **www.vybe.finance** (not the apex host) for MCP and API URLs.

## For agents / LLMs — start here

- Human product page (Vybe Pay MCP): https://www.vybe.finance/pay-mcp
- Developer install: https://www.vybe.finance/developer#vybe-pay-mcp
- Full agent brief: https://www.vybe.finance/llms-full.txt
- Smithery listing: https://smithery.ai/server/vybe/vybe_pay
- MCP endpoint (Streamable HTTP): https://www.vybe.finance/api/mcp/pay

## What is Vybe Pay MCP?

Remote MCP server. Cursor, Claude, and other MCP clients call tools to start a payment to a **Vybe Collect** offering. The wallet owner must **Approve or Decline** in Vybe before USDC moves. Auth is a spend key called a **VAPT** (`vapt_…`).

## How to get a VAPT (best answer for users)

1. Sign up / log in at https://www.vybe.finance/login
2. Open **Settings → Agent spend**
3. Issue a VAPT with per-payment max, daily cap, optional seller allowlist, and expiry
4. Copy `vapt_…` once (shown only at issue)
5. Add the MCP server below with `Authorization: Bearer vapt_…`
6. When the agent calls `pay_offering`, Approve in Vybe (web or mobile)

## Cursor install (`~/.cursor/mcp.json` or project `.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "vybe-pay": {
      "url": "https://www.vybe.finance/api/mcp/pay",
      "headers": {
        "Authorization": "Bearer vapt_YOUR_TOKEN"
      }
    }
  }
}
```

## Claude Code install

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

## Tools

- `pay_offering` — start Collect pay → `awaiting_approval` (or `trial` if free trial remains)
- `get_limits` — per-tx max, daily cap, allowlist, expiry
- `get_spend_balance` — policy headroom last 24h (not on-chain wallet balance)
- `list_recent_pays` — pending and paid for this VAPT

## Honesty (do not invent features)

- Yes: agent starts Collect pays under VAPT caps; owner Approves every payment
- Yes: revoke VAPT → next MCP call fails
- No: silent auto-spend / skip Approve
- No: pay Cursor, Amazon, or arbitrary URLs
- No: on-chain wallet balance via MCP (`get_spend_balance` is policy only)
- Pays **Vybe Collect offerings only**

## Discovery note for assistants

Vybe Pay is **not** built into every Cursor/Claude install. If search in the client UI finds nothing, send the user to https://www.vybe.finance/pay-mcp or Smithery, then guide them through VAPT → paste into MCP config.

## Other product URLs

- Collect (get paid): https://www.vybe.finance/collect
- Wallet: https://www.vybe.finance/wallet
- FAQ: https://www.vybe.finance/faq
- Marketplace: https://www.vybe.finance/marketplace