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.

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 tools (balances, price, lock status)
    ├── 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, write operations (deposits, withdrawals) will be blocked until you update.

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. You should see get_vault_status and other tools available.

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