Skip to main content
Glama

Grip MCP

Claude(またはMCP互換エージェント)にBase上のノンカストディアルUSDCウォレットを持たせましょう。すべての支払いに人間による承認プロセスが組み込まれています。

概要

@grip-foundation/grip-mcp は、Model Context Protocol サーバーであり、MCP対応クライアント(Claude Desktop、Claude Code、Continueなど)に対して4つのツールを提供します。

ツール

機能

承認者

grip_wallet

エージェントのスマートアカウントアドレスとBase上のUSDC残高を返します。

—

grip_create_payment

支払いをステージング(オフチェーン)します。承認トークンを返します。

—

grip_settle_payment

ステージングされた支払いを決済または拒否します。承認すると、Baseメインネット上で実際のUSDC送金を実行します。

人間(チャット内)

grip_list_payments

セッション内の最近の支払いリストを表示します。

—

エージェントは、あなたの承認なしに資金を動かすことはありません。フローは「エージェントがステージング」→「あなたがチャットで確認」→「エージェントが決済」となります。プログラムによる自動承認は一切ありません。

Related MCP server: @arispay/payagent-mcp

インストール

オプション1 — npx を使用(初回公開後)

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows) に以下を記述します:

{
  "mcpServers": {
    "grip": {
      "command": "npx",
      "args": ["-y", "@grip-foundation/grip-mcp"]
    }
  }
}

オプション2 — ローカルクローン

git clone https://github.com/grip-foundation/grip-mcp.git
cd grip-mcp
pnpm install
pnpm run build

次に、Claude Desktopでビルド済みファイルを指定します:

{
  "mcpServers": {
    "grip": {
      "command": "node",
      "args": ["/absolute/path/to/grip-mcp/dist/server/index.js"]
    }
  }
}

設定を編集した後、Claude Desktopを再起動してください。

初回実行

サーバーが初めて起動すると、新しいEOA秘密鍵が生成され、~/.grip-mcp/agent-key(モード0600)に保存されます。この鍵がスマートアカウントを制御します。

Claudeで以下のように尋ねてください:

Show me my Grip wallet

Claudeが grip_wallet を呼び出し、スマートアカウントのアドレス、残高、制限を表示します。そのアドレスにBase上のUSDCを送金して資金をチャージしてください。

支払いの実行

資金がチャージされたら、Claudeに以下のように依頼します:

Send 5 USDC to 0xba14744FfD57FA7d03b20D4c8BeDAaC301E865d1

Claudeは以下の手順を実行します:

  1. grip_create_payment を呼び出し、オフチェーンで支払いをステージングします。

  2. 詳細(金額、受取人、メモ)を表示し、確認を求めます。

  3. あなたの返信を待ちます。

  4. 「approve(承認)」と答えると → grip_settle_payment(token, "approve") を呼び出し → Base上で実行します。

  5. 「no(拒否)」と答えると → grip_settle_payment(token, "reject") を呼び出し → オンチェーンでのアクションは行われません。

決済完了時にトランザクションハッシュとBasescanへのリンクが返されます。

設定

環境変数

デフォルト

機能

GRIP_MCP_PRIVATE_KEY

(自動生成)

エージェントの署名用秘密鍵を上書きします。複数のマシン間でウォレットを復元する際に便利です。

GRIP_MCP_KEY_PATH

~/.grip-mcp/agent-key

自動生成された鍵の保存先です。

GRIP_MCP_PER_TX_CAP

100

1回の支払いあたりの最大USDC額です。

GRIP_MCP_DAILY_CAP

500

UTCの1日あたりの全支払い合計最大USDC額です。

セキュリティモデル

  • ノンカストディアル。 Grip Foundationは、あなたの秘密鍵、USDC、支払い記録を一切保持しません。すべてあなたのマシン上で動作します。

  • マネージド・ペイマスター、登録不要。 ガス代は、Gripのホスト型プロキシを経由してPimlicoペイマスターによりUSDCで支払われます。Pimlicoアカウントは不要です。

  • 人間による承認はモデルではなくプロトコルで強制されます。 grip_create_payment はステージングのみを行います。grip_settle_payment は別のツール呼び出しです。ほとんどのMCPクライアント(Claude Desktopを含む)は、ツール呼び出しを実行する前に人間による確認を求めるため、これが二重のゲートとなります。

  • 上限はサーバー側で強制されます。 モデルが1回あたりの上限や1日あたりの上限を超える支払いを試みても、サーバーはステージングを拒否します。

アーキテクチャ

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)

スマートアカウントは、Base上のCoinbase Smart Wallet (ERC-4337) です。新しいウォレットからの最初の支払いは、アカウントをデプロイし、USDC償還のためにペイマスターを承認する一度限りのブートストラップUserOpを実行します。それ以降のUserOpはUSDCで支払われます。

既知の問題

最初の支払いで再試行が必要になる場合があります。 @grip-labs/sdk@0.4 では、ブートストラップUserOp(デプロイ + ペイマスター承認)と実際の送金UserOpが2つの別々の操作として送信されます。ブートストラップがPimlicoバンドラーで確定した後、viemの内部 getFactoryArgs() がパブリックRPCから古い getCode を読み取ってしまうという小さな競合ウィンドウが存在します。その結果、viemが2番目のUserOpに initCode を含めてしまい、バンドラーが AA10 sender already constructed エラーで拒否します。

最初の支払いがこのエラーで失敗した場合は、エージェントに再試行を依頼してください。オンチェーンの状態が反映されているため、再試行は成功します。同じウォレットからの以降の支払いはクリーンです(ブートストラップはウォレットごとに最大1回しか実行されません)。

@grip-labs/sdk@0.5 では、ブートストラップと最初の送金を executeBatch を使用して単一のスポンサー付きUserOpに統合する修正が行われており、競合を根本的に排除し、最初の支払いのガス代を約30%削減します。grip-mcp は 0.1.1 でこれに対応予定です。

ライセンス

MIT

開発元

Grip Foundation · AIエージェントのためのオープンなアイデンティティおよび決済レール。

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