Skip to main content
Glama

Grip MCP

Предоставьте Claude (или любому другому агенту, совместимому с MCP) некастодиальный кошелек USDC в сети Base — с обязательным подтверждением каждого платежа человеком.

Что это такое

@grip-foundation/grip-mcp — это сервер Model Context Protocol, который предоставляет четыре инструмента любому клиенту с поддержкой MCP (Claude Desktop, Claude Code, Continue и т. д.):

Инструмент

Что он делает

Кто подтверждает

grip_wallet

Возвращает адрес смарт-аккаунта агента + баланс USDC в сети Base.

—

grip_create_payment

Подготавливает платеж (вне сети). Возвращает токен подтверждения.

—

grip_settle_payment

Проводит или отклоняет подготовленный платеж. При подтверждении выполняет реальный перевод USDC в основной сети Base.

Человек, в чате

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 и ответит, указав адрес вашего смарт-аккаунта, баланс и лимиты. Чтобы пополнить кошелек, отправьте USDC в сети Base на этот адрес.

Совершение платежа

После пополнения счета попросите 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

Максимальная сумма USDC за один платеж.

GRIP_MCP_DAILY_CAP

500

Максимальная сумма USDC для всех платежей в течение суток (UTC).

Модель безопасности

  • Некастодиальность. Grip Foundation не хранит ваши ключи, ваши USDC или какие-либо записи о ваших платежах. Все работает на вашем устройстве.

  • Управляемый пеймастер, без регистрации. Комиссия за газ оплачивается в USDC через пеймастер Pimlico, маршрутизируемый через прокси-сервер Grip. Вам не нужна учетная запись Pimlico.

  • Участие человека обеспечивается протоколом, а не моделью. grip_create_payment только подготавливает платеж. grip_settle_payment — это отдельный вызов инструмента. Большинство MCP-клиентов (включая Claude Desktop) запрашивают подтверждение человека перед выполнением вызовов инструментов — это второй уровень защиты.

  • Лимиты принудительно устанавливаются на стороне сервера. Даже если модель попытается совершить платеж, превышающий ваш лимит на транзакцию или дневной лимит, сервер откажется его подготавливать.

Архитектура

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)

Смарт-аккаунт — это Coinbase Smart Wallet (ERC-4337) в сети Base. Первый платеж с нового кошелька запускает однократную операцию UserOp для развертывания аккаунта и одобрения пеймастера для компенсации USDC; последующие UserOp оплачиваются в USDC.

Известные проблемы

Первый платеж может потребовать повторной попытки. В @grip-labs/sdk@0.4 начальная UserOp (развертывание + одобрение пеймастера) и фактическая UserOp перевода отправляются как две отдельные операции. Существует небольшое окно состояния гонки, когда внутренний метод viem getFactoryArgs() считывает устаревшие данные getCode из публичного RPC после того, как начальная операция была подтверждена в бандлере Pimlico — затем viem включает initCode во вторую UserOp, и бандлер отклоняет ее с ошибкой AA10 sender already constructed.

Если ваш первый платеж завершился с этой ошибкой, просто попросите агента повторить попытку. Повторная попытка будет успешной, так как состояние в сети к тому времени обновится. Последующие платежи с того же кошелька проходят без проблем — начальная настройка выполняется не более одного раза для каждого кошелька.

Исправление будет включено в @grip-labs/sdk@0.5, которое объединяет начальную настройку и первый перевод в одну спонсируемую UserOp с использованием executeBatch, что исключает состояние гонки по определению и экономит около 30% газа на первом платеже. grip-mcp получит это обновление в версии 0.1.1.

Лицензия

MIT

Разработчик

Grip Foundation · открытая инфраструктура идентификации и платежей для ИИ-агентов.

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