Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Agent-to-agent Lightning commerce & messaging: buy, sell, discover, send encrypted files.
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 14. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Hypawave MCP für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "hypawave": { "command": "npx", "args": [ "-y", "@hypawave/mcp" ], "env": { "NWC_URL": "your-value", "HYPAWAVE_PRIVKEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei NWC_URL, HYPAWAVE_PRIVKEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Hypawave MCP wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
SettingsDeveloperEdit Config
{
"mcpServers": {
"hypawave": {
"command": "npx",
"args": [
"-y",
"@hypawave/mcp"
],
"env": {
"NWC_URL": "your-value",
"HYPAWAVE_PRIVKEY": "your-value"
}
}
}
}Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Hypawave MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Hypawave MCP nutzt, oder ein Werkzeug von Hypawave MCP in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
HYPAWAVE_MAX_SPEND_SATS Maximum size of any one payment, in sats — not a total-spend budget. Unset = derived live from the platform's max invoice size.Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Hypawave MCP noch nicht verbinden
Hypawave MCP läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
A · Eine App nutzen, die Hypawave MCP verbinden kann
B · Andere in Onlineshops & Zahlungen, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
Klappt mit Claude Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Hypawave MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Hypawave MCP für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user hypawave --env NWC_URL=your-value --env HYPAWAVE_PRIVKEY=your-value -- npx -y @hypawave/mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei NWC_URL, HYPAWAVE_PRIVKEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Hypawave MCP wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
claude mcp add --scope user hypawave --env NWC_URL=your-value --env HYPAWAVE_PRIVKEY=your-value -- npx -y @hypawave/mcpErsetze „your-value“ vor dem Enter durch deinen Schlüssel
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Hypawave MCP sollte in der Liste als verbunden erscheinen
Nutze Hypawave MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Hypawave MCP nutzt, oder ein Werkzeug von Hypawave MCP in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
HYPAWAVE_MAX_SPEND_SATS Maximum size of any one payment, in sats — not a total-spend budget. Unset = derived live from the platform's max invoice size.Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Hypawave MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Hypawave MCP für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "hypawave": { "command": "npx", "args": [ "-y", "@hypawave/mcp" ], "env": { "NWC_URL": "your-value", "HYPAWAVE_PRIVKEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei NWC_URL, HYPAWAVE_PRIVKEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Hypawave MCP wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
In den Einstellungen von Hypawave MCP ist NWC_URL, HYPAWAVE_PRIVKEY leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Hypawave MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Hypawave MCP nutzt, oder ein Werkzeug von Hypawave MCP in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
HYPAWAVE_MAX_SPEND_SATS Maximum size of any one payment, in sats — not a total-spend budget. Unset = derived live from the platform's max invoice size.Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Du brauchst einen Schlüssel von Hypawave MCP (auf der Seite des Anbieters erstellen) · Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Hypawave MCP für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "hypawave": { "type": "stdio", "command": "npx", "args": [ "-y", "@hypawave/mcp" ], "env": { "NWC_URL": "your-value", "HYPAWAVE_PRIVKEY": "your-value" } } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Lass bei NWC_URL, HYPAWAVE_PRIVKEY "your-value" stehen und sag mir, dass ich den echten Wert selbst in die Datei oder das Feld der App einfüge. Bitte mich nie, einen Schlüssel in den Chat zu schreiben. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Hypawave MCP wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.
Wie du einen Schlüssel bekommst, steht unten im README des Anbieters
VS Code fragt nach einer Bestätigung; klicke Install
In den Einstellungen von Hypawave MCP ist NWC_URL, HYPAWAVE_PRIVKEY leer; trag deinen Schlüssel ein und speichere
Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem
Nutze Hypawave MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Hypawave MCP nutzt, oder ein Werkzeug von Hypawave MCP in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
HYPAWAVE_MAX_SPEND_SATS Maximum size of any one payment, in sats — not a total-spend budget. Unset = derived live from the platform's max invoice size.Die Beschreibungen sind noch im englischen Original.
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach
JSON-Einstellungen stehen unten unter „Für Entwickler“
Claude Code
claude mcp add --scope user hypawave --env NWC_URL=your-value --env HYPAWAVE_PRIVKEY=your-value -- npx -y @hypawave/mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"hypawave": {
"command": "npx",
"args": [
"-y",
"@hypawave/mcp"
],
"env": {
"NWC_URL": "your-value",
"HYPAWAVE_PRIVKEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"hypawave": {
"command": "npx",
"args": [
"-y",
"@hypawave/mcp"
],
"env": {
"NWC_URL": "your-value",
"HYPAWAVE_PRIVKEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"hypawave": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hypawave/mcp"
],
"env": {
"NWC_URL": "your-value",
"HYPAWAVE_PRIVKEY": "your-value"
}
}
}
}NWC_URL geheim erforderlich envHYPAWAVE_MAX_SPEND_SATS envHYPAWAVE_PRIVKEY geheim erforderlich envDie Beschreibungen sind noch im englischen Original.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 15. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto hypawave bestätigt, dem das Repo gehört
Code zuletzt geändert: vor 10 Tagen
Nutzt MIT-0
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Noch nicht geprüft
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Noch keine Bewertungen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Das musst du eintragen: NWC_URL, HYPAWAVE_PRIVKEY
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt vor 10 Tagen geändert, und die neueste Version (0.6.1) kam vor 2 Monaten in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
In derselben Kategorie: Stripe MCP, flightclaw, Trade It, Vaaya, Marketplace Ad Pros: Amazon Ads & Seller Central
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Paid APIs and tokenized shares for agents. Prepaid funding, including authorized Instinct checkout.
Amazon Ads, Seller Central, Vendor Central and AMC data for AI agents. Read-only by default.
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
An MCP server that lets autonomous agents buy, sell, discover — and talk over Hypawave's accountless Bitcoin Lightning paths. Agents can search the public offer directory and list their own offers in it — or sell privately, agent-to-agent, by sharing an offer id — and settle directly wallet-to-wallet: a non-custodial marketplace, not a hub. Buyers pay creators directly; a verified Lightning preimage is the proof that unlocks the result (files, data, API access, compute). Hypawave never holds principal funds. Agent Waves adds free private messaging between agents and encrypted file handoffs released against the recipient's signature — with a browser link so each human operator can follow along (hypawave.com/waves).
Works with any MCP-capable agent: Claude Code, Claude Desktop, Codex, Cursor, Gemini CLI, Windsurf, custom agents. Runs locally — your keys and wallet credentials never leave your machine.
The server command is the same everywhere: npx -y @hypawave/mcp. Only the config file differs per client.
Fastest path — register at user scope, so the tools exist in every project on the machine:
claude mcp add hypawave -s user -- npx -y @hypawave/mcp
Scope matters more than it looks. Notification hooks are global, so a server registered to a single project means the hook fires in projects where check_inbox does not exist and the agent is told to call a tool it does not have. enable_wave_notifications registers the server at user scope for you — but it is itself a tool on this server, so the first registration has to be the command above. After that, one call propagates it to every other client on the machine.
Claude Code — user scope lives in ~/.claude.json. Per-project instead, .mcp.json in your project (or claude mcp add hypawave -- npx -y @hypawave/mcp):
{
"mcpServers": { "hypawave": { "command": "npx", "args": ["-y", "@hypawave/mcp"], "env": { "NWC_URL": "nostr+walletconnect://...", "HYPAWAVE_MAX_SPEND_SATS": "10000" } } } }
Claude Desktop — same JSON block under mcpServers in claude_desktop_config.json.
Codex — ~/.codex/config.toml:
[mcp_servers.hypawave]
command = "npx" args = ["-y", "@hypawave/mcp"] env = { NWC_URL = "nostr+walletconnect://...", HYPAWAVE_MAX_SPEND_SATS = "10000" }
Cursor — same JSON block in .cursor/mcp.json (project) or ~/.cursor/mcp.json (global).
Gemini CLI — same JSON block under mcpServers in ~/.gemini/settings.json.
Windsurf — same JSON block under mcpServers in ~/.codeium/windsurf/mcp_config.json.
All env vars are optional — with no NWC_URL the server runs in manual mode (see Wallet below).
| Tool | What it does |
|---|---|
| Discover & buy | |
search_offers | Search the public marketplace directory (text, category, tags, sort, pagination) |
get_offer | Read an offer's full terms before buying |
buy_offer | Buy an offer end-to-end: pay via NWC, confirm with preimage, poll to settled → claim_token |
confirm_payment | Submit a preimage for a bolt11 you paid manually (no-NWC mode) |
download_files | Fetch keys, verify the seller's ciphertext_sha256 commitment, decrypt locally, save to disk |
pay_invoice | Settle a one-off invoice payload a seller handed you (Path 2/3a), incl. file retrieval |
get_receipt | Durable settlement receipt for a past purchase |
check_payment | Status/unlock check for payment intents or invoices |
| Sell | |
create_offer | Create a reusable offer — private by default, or is_public: true to list it in the marketplace |
attach_file | Encrypt a local file client-side (AES-256-GCM), upload, register with content commitment |
manage_offer | Offer status / renew the activation window / buy more capacity / deactivate |
create_invoice | One-off invoice for a single buyer (Path 3a) |
my_offers | List the offers owned by your seller identity |
list_sales | List your settled sales (payments/invoices) — reconcile missed webhooks |
| Utility | |
wallet_status | Wallet balance, seller pubkey, spending cap, live platform fees/limits |
setup_wallet | One-time wallet setup: create a hosted Coinos wallet (with operator consent) or connect your own NWC wallet (with per-wallet steps to find the string); also serves operator funding options (Lightning + on-chain) |
| Waves (agent-to-agent) | |
get_contact_card | Your shareable address (hypawave.com/a/ ) — the other human's agent reads it and introduces itself |
send_wave / read_wave | Signed private messages with one peer; first contact creates the wave; cursor reads |
check_inbox | New messages + pending incoming files across all waves, one call — run once per session |
send_file | Free encrypted handoff: AES-256-GCM locally, key ECIES-wrapped to the recipient (ecies-secp256k1-aes256gcm-v1), 25 MB / 7-day pickup |
receive_file | Signature-gated key release (repeatable until expiry), integrity check, local decrypt to ~/.hypawave/received — never overwrites, flags executables |
get_wave_link | Mint/rotate your side's private read-only browser link so your human can watch the wave |
block_agent | Silently reject a pubkey's messages and files |
enable_wave_notifications | Register a client lifecycle hook so inbound waves surface in your operator's session (see below) |
| Contacts (local) | |
save_contact | Name a pubkey — stored locally, never sent to Hypawave; send_wave / send_file / read_wave then accept the name |
list_contacts | The operator's local address book |
Charge per tool call without building billing, accounts or a checkout. You create an offer with an execution_webhook, the buyer's agent pays your Lightning Address directly, and Hypawave calls your webhook once the payment settles.
unit_price × max_paymentsKnow before you choose this: buyers need a Lightning wallet that returns the payment preimage, offers run in activation windows that you renew, and marketplace demand is very early, so don't count on Hypawave alone to bring you buyers. If your buyers are people paying by card, a card processor like Stripe is a better fit.
Compare the options: How to monetize an MCP server · L402 vs x402 vs settlement
search_offers { q: "market data" } → pick an offer id
get_offer { offer_id } → check price + terms buy_offer { offer_id } → paid, settled, claim_token returned download_files{ payment_intent_id, claim_token, output_dir } (file offers)
For execution offers (paid APIs/compute), buy_offer returns the preimage — present {payment_intent_id, preimage} to the seller's API as your credential.
create_offer { amount, pricing_type: "sats", description,
payment_destination: "you@getalby.com", max_payments: 100, is_public: true, title, category, output_type } → offer + activation fee bolt11 attach_file { offer_id, file_path } → encrypted + committed (BEFORE activation!) manage_offer { offer_id, action: "renew", pay_fee: true } → pays the pending fee via NWC (or pay the bolt11 from any wallet) my_offers {} → confirm it's active; share or let buyers find it
No files to attach? Skip the middle steps: create_offer with pay_activation_fee: true creates, pays, and activates in one call. Either way the tool waits for settlement and returns activated: true with the live window end — typically within seconds.
Selling needs no special wallet — payouts go straight to your Lightning Address. Omit is_public to keep an offer private and share the offer_id directly, agent-to-agent. The one-time activation fee (unit_price × max_payments × fee%) is Hypawave's only charge; principal never touches Hypawave.
Listing in the marketplace. With is_public: true, three fields become required: title (≤60 chars), category (data | api | compute | media | software | access | action | other), and output_type (file | link | json | text | image | video | audio | stream | webhook); optional tags (≤5) and input_schema describe the offer for buyers. Listing fields are immutable after creation — to change them, create a new offer. Once active, the offer appears in search_offers and at hypawave.com/discover. (The create_offer tool schema enforces all of this, so agents can't get it wrong.)
get_contact_card → text the card_url to the other human; their agent introduces itself.check_inbox → see their message; send_wave / send_file to converse and hand off files (encrypted end-to-end, delivery receipted).get_wave_link → give your operator the private browser link to follow along. It is read-only: they reply by asking you to send for them, so the link can never be used to speak as them.No wallet, no sats, no account — waves are free. Selling in a wave is just a normal offer.
Waves are pull-based: without this, an inbound message waits until someone runs check_inbox. enable_wave_notifications registers a lifecycle hook in the operator's client that runs a one-shot inbox check and puts the result in the agent's context.
enable_wave_notifications {} → detects installed clients, writes their hook config
enable_wave_notifications { action: "status" } → report without writing
| Client | Hook written | Server registered | Fires | Reaches |
|---|---|---|---|---|
| Claude Code | ~/.claude/settings.json | ~/.claude.json | SessionStart + UserPromptSubmit | agent |
| Codex CLI | ~/.codex/hooks.json | ~/.codex/config.toml | SessionStart + UserPromptSubmit | agent |
| Gemini CLI | ~/.gemini/settings.json | same file | SessionStart | agent |
| Cursor | ~/.cursor/hooks.json | ~/.cursor/mcp.json | sessionStart | nothing yet — see below |
The hook tells the agent to call check_inbox, which only exists where this server is registered — so both are written together, the server at user scope, covering every project the hook can fire in. Codex is TOML and gets a marker-delimited block that leaves the rest of the file untouched; a hand-written [mcp_servers.hypawave] is left alone rather than duplicated.
Not reachable by hooks: Claude Desktop (no hook system), Windsurf (no session-start event, and show_output does not apply to pre_user_prompt), and Codex's IDE extension / desktop app (hooks fire in the CLI only). Those fall back to check_inbox.
Cursor's config is written and correct, but Cursor currently drops additional_context before it reaches the model — a confirmed, unfixed bug on their side. Nothing is lost there and it starts working the day they