Skip to main content
Glama
mcp-growi

mcp-growi

by Growi-DeFi

mcp-growi

MCP (Model Context Protocol) server for Growi Finance — enables AI agents and autonomous bots to interact programmatically with the GrowiHFVault smart contract on Arbitrum.

Security

Read this before configuring a keystore or private key.

mcp-growi exposes execute_transaction, which signs and broadcasts Arbitrum transactions with the locally configured wallet. Inside any MCP client (Claude Desktop, Claude Code, etc.) the LLM has full authority over what gets signed — every tool call is initiated by the model in response to your prompts and anything else it has access to.

This makes the MCP a "confused deputy": if untrusted content reaches the model — a web page fetched by another tool, a document opened in the session, a sibling MCP server controlled by an attacker — a prompt-injection payload inside that content can instruct the model to drain the configured wallet.

Recommendations

  • Do not configure KEYSTORE_PATH or PRIVATE_KEY in a session that has access to untrusted content. If the same client has browsing tools, document-readers, or any other MCP server, treat the session as compromised by default.

  • Use a dedicated "bot" wallet. Create a fresh Ethereum address solely for mcp-growi and fund it only with the amount you intend to deposit. Never reuse your main custody wallet.

  • Keep ETH for gas low. A few dollars' worth is enough — there is no upside to holding more on the bot wallet than the next operation needs.

  • Run mcp-growi@latest. When a security release is published, the built-in version check blocks all operations until you upgrade. Pinning to an older version defeats this.

What this server does enforce

The server has its own defenses against the most direct drain paths, but they cannot prevent every form of misuse:

  • Allowlist. execute_transaction only signs calls to four (contract, selector) pairs — USDC.approve, GWHF.approve, vault.deposit, vault.withdraw. A prompt-injection payload calling USDC.transfer(attacker, balance) is rejected before signing.

  • Decoded validation. approve calls are accepted only when the spender is the GrowiHFVault address. deposit and withdraw amounts must be greater than zero.

  • Version gate. All read and write tools refuse to operate when the local MCP version cannot be verified against the npm registry, or does not match the latest published version.

These guards close the easy attacks but do not make the keystore safe in arbitrary sessions. Treat it as a hot wallet, not custody.

Related MCP server: @arcis/mcp

Contract details

Field

Value

Network

Arbitrum One

Contract

0x928ed672e6eabb7a565c5eb9aac15e3cf6a18388

Vault token

GWHF

Deposit token

USDC

The contract is verified on Arbiscan — you can check the source code and ABI at: https://arbiscan.io/address/0x928ed672e6eabb7a565c5eb9aac15e3cf6a18388#code

The ABI is included in this package (src/contract/abi.ts) so no external calls are needed at runtime.

Project structure

src/
├── index.ts               # Server entrypoint + npm version check
├── contract/              # On-chain interaction layer (viem)
│   ├── abi.ts             # GrowiHFVault + ERC20 ABIs
│   ├── client.ts          # Arbitrum public client + contract/token/HL addresses
│   └── index.ts
├── locks/
│   └── lock-period.ts     # Arbitrum deposit lock + Hyperliquid 24h withdraw lockup
└── tools/                 # MCP tool definitions
    ├── read.ts            # Read-only on-chain queries
    ├── write.ts           # Transaction prep + signing (keystore/privkey)
    └── index.ts

Setup — Claude Desktop / Claude Code

Add the following to your Claude MCP config (claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "growi": {
      "command": "npx",
      "args": ["-y", "mcp-growi@latest"],
      "env": {
        "KEYSTORE_PATH": "/path/to/your/wallet.json",
        "KEYSTORE_PASSPHRASE": "your_passphrase"
      }
    }
  }
}

Important: use mcp-growi@latest (not just mcp-growi) to ensure the MCP auto-updates every time Claude starts. If your version is outdated, or the npm registry is unreachable, all tools (read and write) will be blocked until verification succeeds.

Alternative — plain private key (less secure):

"env": { "PRIVATE_KEY": "0x..." }

Optional — custom RPC endpoint:

"env": { "RPC_URL": "https://arb-mainnet.g.alchemy.com/v2/YOUR_KEY" }

Restart Claude Desktop/Code after saving. The tools will be available once the version check passes — if calls return a version-block error, see the Security section above.

Setup — development (from source)

npm install
npm run build
npm start

Tech stack

  • TypeScript + Node.js

  • @modelcontextprotocol/sdk — MCP server implementation

  • viem — Ethereum/Arbitrum RPC interactions

Available Tools

11 tools
get_eth_balanceA

Get the ETH balance of a wallet on Arbitrum. ETH is needed to pay gas fees for transactions.

Inputs: wallet (required).

get_gwhf_balanceA

Get the GWHF (Growi vault shares) balance of a wallet on Arbitrum.

Inputs: wallet (required).

get_gwhf_priceA

Calculate the current GWHF token price. Derives it from the leader's equity in the Hyperliquid vault divided by GWHF total supply.

Inputs: no named parameters.

get_lock_statusA

Check the current status of both lock periods: the weekly Arbitrum deposit lock and the 24h Hyperliquid withdrawal lock. Use this when a user asks why they cannot deposit or withdraw right now.

Inputs: no named parameters.

get_pending_depositB

Check if a wallet has a pending deposit in the GrowiHFVault queue.

Inputs: wallet (required).

get_pending_withdrawalB

Check if a wallet has a pending withdrawal in the GrowiHFVault queue.

Inputs: wallet (required).

get_usdc_allowanceA

Check how much USDC a wallet has approved for the GrowiHFVault to spend.

Inputs: wallet (required).

get_usdc_balanceB

Get the USDC balance of a wallet on Arbitrum.

Inputs: wallet (required).

get_vault_statusA

Check if GrowiHFVault deposits are currently locked or open. Includes context about the weekly lock/unlock cycle.

Inputs: no named parameters.

prepare_depositA

Prepare unsigned transactions to deposit USDC into the GrowiHFVault. Returns approve + deposit calldata ready to sign externally. The server does NOT handle private keys.

Inputs: wallet (required), amount_usdc (required).

prepare_withdrawA

Prepare unsigned transactions to withdraw GWHF from the GrowiHFVault. Returns approve + withdraw calldata ready to sign externally. The server does NOT handle private keys.

Inputs: wallet (required), amount_gwhf (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: vault lock status, pending deposits/withdrawals, three token balances, allowance, price, combined lock status, and deposit/withdraw preparation. Even the two lock-related tools are differentiated by scope (one for deposit lock only, one for both).

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with snake_case: 'get_' for queries and 'prepare_' for transaction preparation. No mixed conventions or confusing abbreviations.

    Tool Count5/5

    11 tools is well-scoped for a DeFi vault interaction server. It covers all essential operations (status checks, balances, allowance, price, and transaction preparation) without unnecessary tools.

    Completeness5/5

    The tool surface covers the full lifecycle for interacting with the GrowiHFVault: checking locks, balances, allowances, price, pending actions, and preparing deposit/withdraw transactions. There are no obvious gaps for the intended use case.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI-native access to Aarna's tokenized yield vaults on Ethereum and Base, with tools for vault discovery, performance metrics, transaction building, and portfolio tracking.
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Connects AI agents to Rodev DeFi vaults, enabling deposits, withdrawals, and status queries via 9 MCP tools.
      10
      MIT