Grip MCP
OfficialGrip MCP
Gib Claude (oder jedem anderen MCP-kompatiblen Agenten) ein nicht-verwahrtes USDC-Wallet auf Base — mit einer „Human-in-the-loop“-Freigabe für jede Zahlung.
Was ist das?
@grip-foundation/grip-mcp ist ein Model Context Protocol-Server, der vier Tools für jeden MCP-fähigen Client (Claude Desktop, Claude Code, Continue, etc.) bereitstellt:
Tool | Was es tut | Wer genehmigt |
| Gibt die Smart-Account-Adresse des Agenten + USDC-Guthaben auf Base zurück. | — |
| Bereitet eine Zahlung vor (off-chain). Gibt ein Freigabe-Token zurück. | — |
| Schließt eine vorbereitete Zahlung ab oder lehnt sie ab. Bei Genehmigung wird eine echte USDC-Überweisung auf dem Base-Mainnet ausgeführt. | Mensch, im Chat |
| Listet kürzliche Zahlungen der Sitzung auf. | — |
Der Agent bewegt niemals Geld ohne dich. Der Ablauf ist: Agent bereitet vor → du bestätigst im Chat → Agent schließt ab. Es gibt keine programmatische automatische Genehmigung.
Related MCP server: @arispay/payagent-mcp
Installation
Option 1 — via npx (nach der ersten Veröffentlichung)
In ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"grip": {
"command": "npx",
"args": ["-y", "@grip-foundation/grip-mcp"]
}
}
}Option 2 — lokaler Klon
git clone https://github.com/grip-foundation/grip-mcp.git
cd grip-mcp
pnpm install
pnpm run buildVerweise dann in Claude Desktop auf die erstellte Datei:
{
"mcpServers": {
"grip": {
"command": "node",
"args": ["/absolute/path/to/grip-mcp/dist/server/index.js"]
}
}
}Starte Claude Desktop nach dem Bearbeiten der Konfiguration neu.
Erster Start
Beim ersten Start des Servers wird ein brandneuer EOA-Private-Key generiert und unter ~/.grip-mcp/agent-key (Modus 0600) gespeichert. Dieser Schlüssel steuert das Smart-Account.
Frage in Claude:
Zeig mir mein Grip-Wallet
Claude ruft grip_wallet auf und antwortet mit deiner Smart-Account-Adresse, dem Guthaben und den Limits. Sende USDC auf Base an diese Adresse, um das Wallet aufzuladen.
Eine Zahlung tätigen
Sobald Guthaben vorhanden ist, frage Claude etwa so:
Sende 5 USDC an 0xba14744FfD57FA7d03b20D4c8BeDAaC301E865d1
Claude wird:
grip_create_paymentaufrufen, um die Zahlung off-chain vorzubereiten.Dir die Details (Betrag, Empfänger, Verwendungszweck) anzeigen und um Bestätigung bitten.
Auf deine Antwort warten.
Wenn du „genehmigen“ sagst →
grip_settle_payment(token, "approve")aufrufen → wird auf Base ausgeführt.Wenn du „nein“ sagst →
grip_settle_payment(token, "reject")aufrufen → keine On-Chain-Aktion.
Tx-Hash + Basescan-Link werden nach Abschluss zurückgegeben.
Konfiguration
Umgebungsvariable | Standard | Was sie tut |
| (automatisch generiert) | Überschreibt den Private-Key des Agenten-Signers. Nützlich, um ein Wallet auf verschiedenen Geräten wiederherzustellen. |
|
| Speicherort des automatisch generierten Schlüssels. |
|
| Maximales USDC pro einzelner Zahlung. |
|
| Maximales USDC über alle Zahlungen pro UTC-Tag. |
Sicherheitsmodell
Nicht-verwahrt (Non-custodial). Die Grip Foundation verwahrt weder deine Schlüssel, noch deine USDC, noch Aufzeichnungen deiner Zahlungen. Alles läuft auf deinem Rechner.
Verwalteter Paymaster, keine Registrierung. Gas wird in USDC über den Pimlico-Paymaster bezahlt, der über den gehosteten Proxy von Grip geleitet wird. Du benötigst kein Pimlico-Konto.
Human-in-the-loop wird durch das Protokoll erzwungen, nicht durch das Modell.
grip_create_paymentbereitet nur vor.grip_settle_paymentist ein separater Tool-Aufruf. Die meisten MCP-Clients (einschließlich Claude Desktop) fragen vor der Ausführung von Tool-Aufrufen nach einer menschlichen Bestätigung – das ist eine zweite Sicherheitsebene.Limits werden serverseitig erzwungen. Selbst wenn das Modell versucht, eine Zahlung über deinem Limit pro Transaktion oder Tageslimit zu tätigen, verweigert der Server die Vorbereitung.
Architektur
Claude Desktop
│ MCP (stdio)
▼
grip-mcp (this server)
│ @grip-labs/sdk
▼
Grip-managed paymaster proxy → Pimlico bundler → Base mainnet
▲
Coinbase Smart Wallet
(your smart account)Das Smart-Account ist ein Coinbase Smart Wallet (ERC-4337) auf Base. Die erste Zahlung von einem neuen Wallet führt ein einmaliges Bootstrap-UserOp aus, das das Konto bereitstellt und den Paymaster für die USDC-Rückerstattung genehmigt; nachfolgende UserOps werden in USDC bezahlt.
Bekannte Probleme
Die erste Zahlung erfordert möglicherweise einen erneuten Versuch. In @grip-labs/sdk@0.4 werden das Bootstrap-UserOp (Bereitstellung + Paymaster-Genehmigung) und das eigentliche Überweisungs-UserOp als zwei separate Vorgänge übermittelt. Es gibt ein kleines Zeitfenster, in dem viems internes getFactoryArgs() veraltetes getCode vom öffentlichen RPC liest, nachdem das Bootstrap beim Pimlico-Bundler abgeschlossen wurde – viem fügt dann initCode in das zweite UserOp ein und der Bundler lehnt es mit AA10 sender already constructed ab.
Wenn deine erste Zahlung mit diesem Fehler fehlschlägt, bitte den Agenten einfach um einen erneuten Versuch. Der erneute Versuch ist erfolgreich, da sich der On-Chain-Status bis dahin verbreitet hat. Nachfolgende Zahlungen vom selben Wallet sind sauber – das Bootstrap läuft höchstens einmal pro Wallet.
Ein Fix erscheint in @grip-labs/sdk@0.5, der Bootstrap + erste Überweisung in ein einzelnes gesponsertes UserOp mittels executeBatch zusammenfasst, wodurch die Race-Condition konstruktionsbedingt eliminiert wird und ca. 30 % Gas bei der ersten Zahlung gespart werden. grip-mcp wird dies in 0.1.1 übernehmen.
Lizenz
MIT
Entwickelt von
Grip Foundation · offene Identitäts- und Zahlungs-Rails für KI-Agenten.
Available Tools
4 toolsgrip_create_paymentCreate a pending payment (requires human approval)A
Stages a payment from the agent's Grip wallet to a recipient. DOES NOT execute on-chain. Returns an approval_token. You MUST then show the payment details (amount, recipient, memo) to the human in plain language and ASK FOR EXPLICIT CONFIRMATION before calling grip_settle_payment. Never auto-approve. The human must say 'approve' (or equivalent) before settling. If they say 'no', call grip_settle_payment with decision='reject'.
Inputs: recipient (required), amount_usdc (required), memo.
grip_list_paymentsList recent payments from this sessionARead-onlyIdempotent
Returns recent payments (pending, settled, rejected, failed) staged or executed in this MCP session. Read-only. Useful when the human asks 'what have I paid today' or 'what's pending'.
Inputs: limit.
grip_settle_paymentSettle (or reject) a pending paymentADestructiveIdempotent
Executes the on-chain transfer for a previously-staged payment, or marks it as rejected. ONLY call this after the human has explicitly confirmed (or declined) the payment in plain language. If the human has not confirmed, do not call this tool. On approve, this performs a real USDC transfer on Base mainnet via the Pimlico paymaster — it is irreversible.
Inputs: approval_token (required), decision (required).
grip_walletGet the agent's Grip wallet infoARead-onlyIdempotent
Returns this agent's Grip Pay wallet address (Base mainnet smart account) and current USDC balance. Use this when the human asks about the wallet, where to fund it, how much USDC the agent has, or before suggesting any payment.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clear, distinct purpose: creating staged payments, listing payments, settling/rejecting, and checking wallet info. No overlap or ambiguity.
All tools start with 'grip_' and most follow a verb_noun pattern (create_payment, list_payments, settle_payment). The exception is 'grip_wallet', which is a noun phrase, but the inconsistency is minor given the small set.
Four tools is well-scoped for a payment/wallet MCP server. It covers staging, settling, listing, and wallet info without being too few or excessive.
The tool surface covers the core payment workflow: create, settle/reject, list, and wallet info. A potential minor gap is lack of explicit cancellation for staged payments, but the reject option in settle effectively handles that.
Maintenance
Related MCP Connectors
Give AI agents a wallet with a spending limit. Non-custodial USDC on Base, server-enforced limits.
Self-custodial USDC wallet on Base for AI agents: on-chain caps, Face ID, one-tap pause.
Shared USDC wallets for agents and teams, with optional write access and human-signed payments.
Monetization and execution gateway for autonomous AI agents on Base Mainnet
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to manage USDC wallets on Solana, allowing them to send payments, create invoices, and access paid APIs within human-defined spending limits. It uses threshold signatures to provide agents with financial autonomy while ensuring secure oversight and transaction approval.3670 npm4Apache 2.0

@arispay/payagent-mcpofficial
AlicenseAqualityBmaintenanceEnables AI agents to call paid APIs and settle HTTP 402 payment challenges with USDC on Base, without private keys ever being involved.7265 npmMIT- AlicenseAqualityDmaintenanceProvides AI agents with a wallet and access to 900+ pay-per-call intelligence APIs across 74 verticals, with automatic USDC payments on Base and built-in spend guardrails.5110 npmMIT
- AlicenseAqualityBmaintenanceEnables AI agents to make non-custodial USDC payments on Base through an MCP endpoint, with server-enforced per-payment and daily caps, human approval bands, and recipient allowlists.739 npmMIT