Grip MCP
OfficialGrip MCP
Предоставьте Claude (или любому другому агенту, совместимому с MCP) некастодиальный кошелек USDC в сети Base — с обязательным подтверждением каждого платежа человеком.
Что это такое
@grip-foundation/grip-mcp — это сервер Model Context Protocol, который предоставляет четыре инструмента любому клиенту с поддержкой MCP (Claude Desktop, Claude Code, Continue и т. д.):
Инструмент | Что он делает | Кто подтверждает |
| Возвращает адрес смарт-аккаунта агента + баланс USDC в сети Base. | — |
| Подготавливает платеж (вне сети). Возвращает токен подтверждения. | — |
| Проводит или отклоняет подготовленный платеж. При подтверждении выполняет реальный перевод USDC в основной сети Base. | Человек, в чате |
| Выводит список недавних платежей за сессию. | — |
Агент никогда не переводит деньги без вашего участия. Процесс выглядит так: агент подготавливает платеж → вы подтверждаете его в чате → агент завершает транзакцию. Программного автоматического подтверждения не существует.
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 сделает следующее:
Вызовет
grip_create_paymentдля подготовки платежа вне сети.Покажет вам детали (сумма, получатель, примечание) и попросит подтверждения.
Будет ждать вашего ответа.
Если вы скажете "approve" → вызовет
grip_settle_payment(token, "approve")→ выполнит транзакцию в сети Base.Если вы скажете "no" → вызовет
grip_settle_payment(token, "reject")→ никаких действий в сети не будет.
Хэш транзакции и ссылка на Basescan будут возвращены после завершения платежа.
Конфигурация
Переменная окружения | По умолчанию | Что она делает |
| (автогенерация) | Переопределяет закрытый ключ подписи агента. Полезно для восстановления кошелька на разных устройствах. |
|
| Путь, где хранится автоматически сгенерированный ключ. |
|
| Максимальная сумма USDC за один платеж. |
|
| Максимальная сумма 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 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