Skip to main content
Glama

Grip 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

grip_wallet

Gibt die Smart-Account-Adresse des Agenten + USDC-Guthaben auf Base zurück.

—

grip_create_payment

Bereitet eine Zahlung vor (off-chain). Gibt ein Freigabe-Token zurück.

—

grip_settle_payment

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

grip_list_payments

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 build

Verweise 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:

  1. grip_create_payment aufrufen, um die Zahlung off-chain vorzubereiten.

  2. Dir die Details (Betrag, Empfänger, Verwendungszweck) anzeigen und um Bestätigung bitten.

  3. Auf deine Antwort warten.

  4. Wenn du „genehmigen“ sagst → grip_settle_payment(token, "approve") aufrufen → wird auf Base ausgeführt.

  5. 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

GRIP_MCP_PRIVATE_KEY

(automatisch generiert)

Überschreibt den Private-Key des Agenten-Signers. Nützlich, um ein Wallet auf verschiedenen Geräten wiederherzustellen.

GRIP_MCP_KEY_PATH

~/.grip-mcp/agent-key

Speicherort des automatisch generierten Schlüssels.

GRIP_MCP_PER_TX_CAP

100

Maximales USDC pro einzelner Zahlung.

GRIP_MCP_DAILY_CAP

500

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_payment bereitet nur vor. grip_settle_payment ist 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 tools
grip_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 sessionA
Read-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 paymentA
DestructiveIdempotent

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 infoA
Read-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

    A4.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: creating staged payments, listing payments, settling/rejecting, and checking wallet info. No overlap or ambiguity.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      36
      70 npm
      4
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      5
      110 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      7
      39 npm
      MIT

    Appeared in Searches