Vybe Pay MCP

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.

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.

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.

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.

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.

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, use_paid_offering.

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.

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.

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.

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.

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 scrape the marketplace page. Pass username plus offeringId, or a Collect / marketplace offeringUrl. Related: use_paid_offering, fetch_paid_content, get_limits, get_spend_balance, list_recent_pays.

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.

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 so. Related: get_tool, pay_offering.

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 notify quietly. Related: get_limits, get_spend_balance, get_wallet_balance, list_recent_pays.

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_pays, fetch_paid_content.