Grove MCP Server

A comprehensive Model Context Protocol (MCP) server providing blockchain data access across 69+ networks via Grove's public endpoints for Pocket Network.

Requires an MCP client such as Claude Desktop, Claude Code CLI, or the MCP Inspector. This server cannot be used directly from a regular terminal - it implements the MCP protocol and must be connected to an MCP-compatible client.

Transform Claude into a powerful blockchain analysis tool with natural language queries, token analytics, transaction inspection, domain resolution, and multi-chain comparisons - all through Grove's free public RPC infrastructure.

💡 Free Public Access + Optional Rate Limit Bypass: Uses Grove's free public RPC endpoints by default — no API keys required (may be rate limited). See the list at https://grove.city/public-endpoints. For higher rate limits, optionally provide your Grove Portal appId from portal.grove.city.

Quick Start

1. Install dependencies:

   npm install npm run build

2. Public endpoints by default (rate limited) + optional appId

   • By default this server uses Grove's public endpoints (may be rate limited). See the list at https://grove.city/public-endpoints.

   • For higher rate limits across all chains, optionally set your Grove Portal appId (same appId works everywhere):

     export GROVE_APP_ID=your_app_id

3. Configure your MCP client:

   For Claude Desktop (edit ~/Library/Application Support/Claude/claude_desktop_config.json):

   { "mcpServers": { "grove": { "command": "node", "args": ["/absolute/path/to/mcp-grove/dist/index.js"] } } }

   For Claude Code CLI:

   claude mcp add grove node /absolute/path/to/mcp-grove/dist/index.js

   For MCP Inspector (testing/development):

   npx @modelcontextprotocol/inspector node dist/index.js

4. Restart Claude Desktop (if using Desktop) or reload your MCP client, then start querying blockchains:

   "Get the balance of vitalik.eth" "Compare balances for 0x... across all EVM chains" "What's the current gas price on Ethereum?"

Features

Core Blockchain Access

• 69+ Networks: Ethereum, Polygon, Arbitrum, Optimism, Base, Solana, NEAR, Sui, and 60+ more

• Natural Language Queries: "get the latest height for ethereum" → direct results

• Free Public Access: No API keys required — uses Grove's public RPC endpoints (may be rate limited; see https://grove.city/public-endpoints)

• Optional Rate Limit Bypass: Add Grove Portal appId for unlimited requests

• Live JSON-RPC: Execute any blockchain RPC method directly

Tip: Set GROVE_APP_ID once and it applies to all chains (EVM, Solana, Cosmos, Sui). You can also pass appId per-tool if you prefer.

Advanced Features

EVM Chains:

• 🔍 Domain Resolution: ENS (.eth) ↔ addresses, Unstoppable Domains (.crypto, .nft, etc.)

• 📊 Transaction Analysis: Full transaction details, receipts, gas estimates

• 💰 Token Operations: ERC-20 balances, metadata (name, symbol, decimals, supply)

• ⛓️ Multi-Chain Analysis: Compare balances across ALL EVM chains in one query

• 📦 Block Exploration: Detailed block data, event log searches

• 📜 Smart Contracts: Read-only contract calls

• ⏰ Historical Queries: Time-travel balance checks at any block height

• 🛠️ Utilities: Unit conversion (wei/gwei/eth), address validation, hex decoding

Solana:

• 🪙 SPL Tokens: Token balances and metadata for any SPL token

• 💸 Transactions: Full transaction details with compute units and fees

• 📊 Priority Fees: Real-time fee estimation for optimal transaction pricing

• 📜 Account Data: Program accounts, executable status, data owner

Sui:

• 🪙 Balances & Coins: SUI balance, all coin balances, coin pagination

• 📦 Objects: Object details, owned objects, type/content display

• 💸 Transactions: Transaction blocks, queries, events

• ⛽ Gas: Reference gas price, latest checkpoint, checkpoint details

Cosmos SDK:

• 🏦 Multi-Denom Balances: Native tokens and IBC assets

• 🔒 Staking: Delegations, validators, rewards across all chains

• 🗳️ Governance: Proposals, votes, and on-chain governance

• 🔗 IBC Support: Cross-chain balance queries via REST API

Detailed Installation

For detailed setup instructions, see CLAUDE_DESKTOP_SETUP.md.

Manual Setup

Available Tools

40+ specialized tools for comprehensive blockchain analysis across EVM, Solana, and Cosmos chains:

Core Blockchain Tools (5 tools)

• query_blockchain - Natural language queries (e.g., "get the latest height for ethereum")

• list_blockchain_services - List all 69+ available networks

• get_blockchain_service - Get details about a specific blockchain including supported methods

• call_rpc_method - Call any JSON-RPC method directly on any blockchain

• get_supported_methods - Get all available RPC methods for a blockchain

Domain Resolution (3 tools)

• resolve_domain - Resolve ENS (.eth) or Unstoppable Domains (.crypto, .nft, etc.) to addresses

• reverse_resolve_domain - Reverse resolve Ethereum address to ENS domain name

• get_domain_records - Get ENS text records (avatar, email, url, twitter, github, etc.)

Transaction & Block Tools (5 tools)

• get_transaction - Get transaction details by hash across any chain

• get_transaction_receipt - Get receipt with status, gas used, logs, and events

• estimate_gas - Estimate gas required for a transaction before sending

• get_block_details - Get detailed block information with optional full transaction list

• search_logs - Search and filter event logs by address, topics, and block range

Token Tools (2 tools)

• get_token_balance - Get ERC-20 token balance for any address

• get_token_metadata - Get token name, symbol, decimals, and total supply

Multi-Chain & Historical Analysis (3 tools)

• compare_balances - Compare native token balance across ALL EVM chains simultaneously

• get_historical_balance - Get balance at a specific block height (time-travel queries)

• get_gas_price - Get current gas price with automatic gwei/eth conversion

Smart Contract Tools (1 tool)

• call_contract_view - Execute read-only contract functions with encoded calldata

Utility Tools (3 tools)

• convert_units - Convert between wei, gwei, and eth with exact precision

• validate_address - Validate address format for specific blockchain (EVM/Solana/Cosmos)

• decode_hex - Decode hex strings to UTF-8, ASCII, and byte arrays

Endpoint Management (5 tools)

• list_endpoints - List all available endpoints (filter by category)

• get_endpoint_details - Get detailed info about a specific endpoint

• call_endpoint - Execute an endpoint with custom parameters

• list_categories - List all available endpoint categories

• add_endpoint - Dynamically add new endpoints at runtime

Solana Tools (11 tools)

SPL Tokens:

• get_solana_token_balance - Get SPL token balance(s) for a Solana wallet

• get_solana_token_metadata - Get token decimals, supply, mint/freeze authorities

Accounts & Balances:

• get_solana_balance - Get SOL balance with lamports and SOL conversion

• get_solana_account_info - Get account data, owner, and executable status

Blocks & Transactions:

• get_solana_block - Get block information with optional full transaction list

• get_solana_transaction - Get transaction details by signature with full metadata

• get_solana_signatures - Get transaction history for an address

Fees:

• get_solana_prioritization_fees - Get recent priority fees for transaction optimization

• get_solana_fee_for_message - Estimate fee for a serialized message (base64)

Network & Programs:

• get_solana_block_height - Get current block height

• get_solana_program_accounts - List accounts owned by a program (with filters)

Sui Tools (11 tools)

Balances & Coins:

• get_sui_balance - Get SUI balance with SUI conversion

• get_sui_all_balances - Get all coin balances for an address

• get_sui_coins - Paginate coins by coinType with cursor/limit

Objects:

• get_sui_object - Get object details with display/content options

• get_sui_owned_objects - List objects owned by an address with filters

Transactions:

• get_sui_transaction - Get transaction block details by digest

• query_sui_transactions - Query transactions with filters and pagination

Events & Chain:

• query_sui_events - Query events with filters and sort order

• get_sui_latest_checkpoint - Get the latest checkpoint sequence number

• get_sui_checkpoint - Get checkpoint details by ID

Cosmos SDK Tools

Accounts & Balances:

• get_cosmos_balance - Get balance for specific denom or all balances

• get_cosmos_all_balances - Get all token balances for an address

• get_cosmos_account - Get account information (sequence, account number)

Staking:

• get_cosmos_delegations - Get all delegations (staked tokens) for an address

• get_cosmos_validators - List validators (bonded, unbonded, unbonding, or all)

• get_cosmos_validator - Get specific validator details

• get_cosmos_rewards - Get staking rewards for a delegator

Transactions:

• get_cosmos_transaction - Get transaction by hash

• search_cosmos_transactions - Search transactions by events

Governance:

• get_cosmos_proposals - Get governance proposals (filter by status)

• get_cosmos_proposal - Get specific proposal details

• get_cosmos_proposal_votes - Get all votes for a proposal

Blocks:

• get_cosmos_latest_block - Get latest block information

• get_cosmos_block - Get block at specific height

Chain Info:

• get_cosmos_params - Get chain parameters (staking, slashing, distribution, gov, mint)

Documentation (3 tools)

• get_doc_page - Retrieve specific documentation pages from docs.grove.city

• get_endpoint_docs - Get documentation for a specific endpoint

• search_docs - Full-text search across Grove documentation

Extending with New Blockchains

To add support for a new blockchain network:

1. Edit src/config/blockchain-services.json

2. Add a new service entry:

3. Rebuild: npm run build

4. Restart Claude Desktop

For more details, see EXTENDING.md.

Architecture

Development

Watch mode for development:

Smoke Test

Run a quick end-to-end test across multiple chain types using public endpoints:

Tests EVM (Ethereum, Polygon, Base), Solana, Sui, Cosmos (Osmosis, Persistence), and Radix chains.

Supported Blockchains

69 blockchain networks available via Grove's public endpoints:

EVM Chains: Ethereum, Polygon, BSC, Avalanche, Gnosis, Celo, Fantom, Harmony, Moonbeam, Moonriver, Fuse, IoTeX, Oasys, Kaia, Berachain, Sonic, Ink, XRPL EVM

Layer 2 Solutions: Arbitrum, Optimism, Base, zkSync Era, zkLink Nova, Scroll, Linea, Mantle, Blast, Boba, Metis, Taiko, Unichain, opBNB, Fraxtal, Polygon zkEVM

Cosmos Ecosystem: ✅ (many chains supported) Osmosis, Juno, Akash, Kava, Persistence, Stargaze, AtomOne, Cheqd, Chihuahua, Fetch.ai, Hyperliquid, Jackal, Pocket Network, Seda, Sei, Shentu

Non-EVM: Solana ✅ (full support), NEAR, Sui, Tron, Radix

Plus testnets for Ethereum, Polygon, Arbitrum, Optimism, Base, Taiko, XRPL EVM, Giwa

Most chains use public endpoint ID 01fdb492. Some chains have foundation-sponsored endpoints with better performance (Kaia, XRPL EVM, Radix) - these are automatically preferred.

Example Usage

Once configured in Claude Desktop, you can:

Blockchain Queries

Domain Resolution

Transaction Analysis

Token Operations

Multi-Chain Analysis

Utilities

Solana Operations

Cosmos Ecosystem (Osmosis, Juno, Kava, Akash, etc.)

Using Custom AppId (For Higher Rate Limits)

If you encounter rate limits with public endpoints, you can provide your Grove Portal appId:

Get your free appId from portal.grove.city

General Endpoint & Documentation

For detailed blockchain usage examples, see BLOCKCHAIN_USAGE.md.

License

MIT