Uses dotenv for environment variable management to configure Geth node connections and server settings
Provides comprehensive access to Ethereum blockchain data and operations through Geth node integration, including querying blocks, transactions, balances, admin functions, debug tools, and transaction pool management
Built on Express.js web framework to provide HTTP endpoints for MCP tool calls and REST API access
Implemented as a Node.js application that serves as a proxy server between Ethereum Geth nodes and MCP-enabled applications
Utilizes Zod for input validation and schema definition of all MCP tool parameters to ensure type safety
This project is a Node.js-based proxy server that bridges Ethereum JSON-RPC queries from a Geth (Go Ethereum) node to the Model Context Protocol (MCP) ecosystem. It exposes a wide range of Ethereum RPC methods as MCP-compatible "tools," allowing seamless integration with MCP-enabled applications, such as AI models or decentralized systems that require controlled access to blockchain data.
The proxy acts as an intermediary, handling requests to a Geth endpoint specified via environment variables. It registers tools for common Ethereum operations (e.g., querying block numbers, balances, transactions) as well as advanced admin and debug functions. Responses are formatted with both hexadecimal and decimal values where applicable for easier consumption. A generic passthrough tool (ethCallRaw) allows calling any unsupported RPC method.
Key features include:
This setup ensures secure, rate-limited, and schema-validated access to Ethereum data, making it ideal for applications that need to interact with the blockchain without direct exposure to the Geth RPC.
eth_blockNumber, eth_getBalance), aliases, admin tools (e.g., chain export/import, peer management), and debug tools (e.g., tracing, profiling).ALLOW_SEND_RAW_TX=1./mcp routes for initialization, tool listing, and health checks.ethCallRaw for any JSON-RPC method not explicitly registered..env file for Geth URL and port.dotenv: For environment variable management.express: Web server framework.@modelcontextprotocol/sdk: MCP SDK for tool registration and transport.zod: Input validation schemas.fs: Built-in file system utilities.Create a .env file in the root directory with the following variables:
--rpc.allow-unprotected-txs or equivalent flags if needed.http://localhost:3000 (or your specified port) and log:GET /mcp or GET /mcp/ – Returns server status and registered tools.POST /mcp with JSON-RPC payload { "method": "initialize" }.POST /mcp with { "method": "tools/list" } – Returns a list of available tools with descriptions and schemas.POST /mcp with { "method": "tools/call", "params": { "name": "toolName", "arguments": {} } }.GET /blockNumber: Returns the current block number in hex and decimal.mcp.json params to your .vscode/ settings.json or mcp.jsonThe proxy registers the following MCP tools, grouped by category. Each tool includes a description, input schema (Zod-based), and handler that queries Geth.
| Tool Name | Description | Input Schema |
|---|---|---|
getBlockNumber / eth_getBlockNumber | Retrieve the current block number (hex + decimal). | {} |
getBalance / eth_getBalance | Get balance of an address (hex + decimal). | { address: string, block?: string } |
eth_chainId / chainId | Get current chain ID (hex + decimal). | {} |
eth_gasPrice / gasPrice | Get current gas price (hex + wei decimal). | {} |
eth_isSyncing / isSyncing | Check if the node is syncing. | {} |
eth_getBlockByNumber / getBlockByNumber | Fetch block by number/tag. | { block: string, full?: boolean } |
eth_getTransactionByHash / getTransactionByHash | Fetch a transaction by hash. | { hash: string } |
eth_call / call | Execute a call without a transaction. | { to: string, data: string, block?: string } |
eth_estimateGas / estimateGas | Estimate gas for a transaction. | { to?: string, from?: string, data?: string, value?: string } |
eth_sendRawTransaction / sendRawTransaction | Broadcast a signed raw transaction (requires ALLOW_SEND_RAW_TX=1). | { rawTx: string } |
ethCallRaw | Call any Ethereum JSON-RPC method with params array. | { method: string, params?: any[] } |
eth_simulateV1 | Simulate multiple blocks and transactions. | { payload: any, block: any } |
eth_createAccessList | Create an EIP2930 access list based on a transaction. | { transaction: any, blockNumberOrTag?: any } |
eth_getHeaderByNumber | Returns a block header by number. | { blockNumber: any } |
eth_getHeaderByHash | Returns a block header by hash. | { blockHash: string } |
| Tool Name | Description | Input Schema |
|---|---|---|
admin_exportChain | Exports the blockchain to a file (optional range). | { file: string, first?: number, last?: number } |
admin_importChain | Imports blocks from a file. | { file: string } |
admin_nodeInfo | Retrieves node information. | {} |
admin_peers | Retrieves connected peers information. | {} |
admin_removePeer | Disconnects from a remote node. | { url: string } |
admin_removeTrustedPeer | Removes a remote node from trusted peers. | { url: string } |
admin_startHTTP | Starts an HTTP JSON-RPC server. | { host?: string, port?: number, cors?: string, apis?: string } |
admin_startWS | Starts a WebSocket JSON-RPC server. | { host?: string, port?: number, cors?: string, apis?: string } |
admin_stopHTTP | Stops the HTTP RPC endpoint. | {} |
admin_stopWS | Stops the WebSocket RPC endpoint. | {} |
| Tool Name | Description | Input Schema |
|---|---|---|
debug_accountRange | Retrieves account range at a given block. | { blockNrOrHash: any, start: string, maxResults: number, nocode: boolean, nostorage: boolean, incompletes: boolean } |
debug_backtraceAt | Sets logging backtrace location. | { location: string } |
debug_blockProfile | Turns on block profiling. | { file: string, seconds: number } |
debug_chaindbCompact | Flattens the key-value database. | {} |
debug_chaindbProperty | Returns leveldb properties. | { property: string } |
debug_cpuProfile | Turns on CPU profiling. | { file: string, seconds: number } |
debug_dbAncient | Retrieves ancient binary blob. | { kind: string, number: number } |
debug_dbAncients | Returns number of ancient items. | {} |
debug_dbGet | Returns raw value of a key. | { key: string } |
debug_dumpBlock | Retrieves state for a block. | { number: number } |
debug_freeOSMemory | Forces garbage collection. | {} |
debug_freezeClient | Forces a temporary client freeze. | { node: string } |
debug_gcStats | Returns GC statistics. | {} |
debug_getAccessibleState | Returns first accessible state. | { from: any, to: any } |
debug_getBadBlocks | Returns last bad blocks. | {} |
debug_getRawBlock | Retrieves RLP-encoded block. | { blockNrOrHash: any } |
debug_getRawHeader | Returns RLP-encoded header. | { blockNrOrHash: any } |
debug_getRawTransaction | Returns transaction bytes. | { hash: string } |
debug_getModifiedAccountsByHash | Returns modified accounts by hash. | { startHash: string, endHash?: string } |
debug_getModifiedAccountsByNumber | Returns modified accounts by number. | { startNum: number, endNum?: number } |
debug_getRawReceipts | Returns consensus-encoded receipts. | { blockNrOrHash: any } |
debug_goTrace | Turns on Go runtime tracing. | { file: string, seconds: number } |
debug_intermediateRoots | Executes block and returns intermediate roots. | { blockHash: string, options?: any } |
debug_memStats | Returns memory statistics. | {} |
debug_mutexProfile | Turns on mutex profiling. | { file: string, nsec: number } |
debug_preimage | Returns preimage for sha3 hash. | { hash: string } |
debug_printBlock | Prints a block. | { number: number } |
debug_setBlockProfileRate | Sets block profile rate. | { rate: number } |
debug_setGCPercent | Sets GC target percentage. | { v: number } |
debug_setHead | Sets chain head by number. | { number: number } |
debug_setMutexProfileFraction | Sets mutex profile rate. | { rate: number } |
debug_setTrieFlushInterval | Sets trie flush interval. | { interval: string } |
debug_stacks | Returns goroutine stacks. | { filter?: string } |
debug_standardTraceBlockToFile | Traces block to file (standard JSON). | { blockHash: string, config?: any } |
debug_standardTraceBadBlockToFile | Traces bad block to file. | { blockHash: string, config?: any } |
debug_startCPUProfile | Starts CPU profiling. | { file: string } |
debug_startGoTrace | Starts Go trace. | { file: string } |
debug_stopCPUProfile | Stops CPU profiling. | {} |
debug_stopGoTrace | Stops Go trace. | {} |
debug_storageRangeAt | Returns storage at block height and tx index. | { blockHash: string, txIdx: number, contractAddress: string, keyStart: string, maxResult: number } |
debug_traceBadBlock | Traces bad block execution. | { blockHash: string, options?: any } |
debug_traceBlock | Traces block by RLP. | { blockRlp: string, options?: any } |
debug_traceBlockByNumber | Traces block by number. | { number: any, options?: any } |
debug_traceBlockByHash | Traces block by hash. | { hash: string, options?: any } |
debug_traceBlockFromFile | Traces block from file. | { fileName: string, options?: any } |
debug_traceCall | Traces an eth_call. | { args: any, blockNrOrHash: any, config?: any } |
debug_traceTransaction | Traces a transaction. | { txHash: string, options?: any } |
debug_verbosity | Sets logging verbosity. | { level: number } |
debug_vmodule | Sets logging verbosity pattern. | { pattern: string } |
debug_writeBlockProfile | Writes block profile. | { file: string } |
debug_writeMemProfile | Writes allocation profile. | { file: string } |
debug_writeMutexProfile | Writes mutex profile. | { file: string } |
| Tool Name | Description | Input Schema |
|---|---|---|
txpool_content | Retrieves all transactions in txpool. | {} |
txpool_contentFrom | Retrieves transactions for an address. | { address: string } |
txpool_inspect | Lists textual summary of txpool. | {} |
txpool_status | Returns txpool transaction counts. | {} |
Contributions are welcome! Please open an issue or submit a pull request for bug fixes, new tools, or improvements.
MIT
This project is licensed under the MIT License. See the LICENSE file for details.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Bridges Ethereum JSON-RPC queries from Geth nodes to the Model Context Protocol ecosystem, exposing blockchain operations as MCP tools. Enables AI models and applications to securely interact with Ethereum data including blocks, transactions, balances, and advanced debug functions through schema-validated access.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/John0n1/Geth-MCP-Proxy'
If you have feedback or need assistance with the MCP directory API, please join our Discord server