mcp-growi
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-growi deposit 100 USDC into the Growi vault"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_PATHorPRIVATE_KEYin 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-growiand 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_transactiononly signs calls to four(contract, selector)pairs —USDC.approve,GWHF.approve,vault.deposit,vault.withdraw. A prompt-injection payload callingUSDC.transfer(attacker, balance)is rejected before signing.Decoded validation.
approvecalls are accepted only when the spender is the GrowiHFVault address.depositandwithdrawamounts 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 |
|
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.tsSetup — 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 justmcp-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 startTech stack
TypeScript + Node.js
@modelcontextprotocol/sdk — MCP server implementation
viem — Ethereum/Arbitrum RPC interactions
Available Tools
11 toolsget_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
Scored across 11 tools
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).
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.
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.
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
Related MCP Connectors
Agentic AI runtime: persistent memory, vault, autonomous agents, deep research, DeFi execution.
Verified EVM, Aptos and finance tools for AI agents; gas for 14 chains. Pay per call (x402).
Underwritten DeFi yield discovery & goal planning for AI agents on Base & EVM.
Non-custodial DeFi for AI agents: swaps, concentrated liquidity (V3/V4) zaps + ranges, 5 EVM chains
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides 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

@arcis/mcpofficial
AlicenseBqualityDmaintenanceConnect any AI agent to Arcis Protocol DeFi vaults through natural language, enabling deposit, withdrawal, and status queries without SDK or code.721 npmMIT- FlicenseBqualityDmaintenanceEnables AI assistants to discover, evaluate, and execute DeFi yield strategies across EVM and Solana chains through natural conversation, with transactions signed locally.151-
- AlicenseCqualityDmaintenanceConnects AI agents to Rodev DeFi vaults, enabling deposits, withdrawals, and status queries via 9 MCP tools.10MIT