flow-evm-connector-service
Provides a standardized Model Context Protocol (MCP) interface for AI agents to seamlessly query and interact with the Flow EVM layer using conventional JSON-RPC methodologies, abstracting network specifics.
Author

diegofornalha
Quick Info
Actions
Tags
Flow EVM Bridging Server (MCP)
This Model Context Protocol (MCP) server acts as an intermediary, establishing communication between large language models and the Flow EVM blockchain infrastructure. It simplifies complex blockchain operations into accessible function calls.
Understanding Flow EVM
Flow EVM represents an implementation of the Ethereum Virtual Machine residing atop the Flow network. This integration ensures compatibility with established Ethereum smart contracts, tooling, and libraries, while benefiting from Flow's inherent scalability and performance optimizations.
Available Operations (Methods)
Key functionalities exposed by this interface include:
flow_getNetworkInfo: Retrieves configuration details for the active Flow EVM environment.flow_getCode: Fetches the bytecode associated with a given Flow EVM address.flow_chainId: Returns the unique network identifier for the current chain.flow_gasPrice: Queries the prevailing transaction fee rate.flow_getBalance: Checks the native asset balance for a specified account.flow_call: Executes a read-only contract function invocation without state alteration.flow_getLogs: Fetches historical event logs matching defined filtering criteria.flow_sendRawTransaction: Submits a pre-signed, serialized transaction to the network for inclusion.flow_blockNumber: Fetches the index of the latest confirmed block.flow_checkCOA: Determines if an account address corresponds to a Cadence-Controlled Account (COA).
Technical Implementation Details
This service layer abstracts standard Ethereum RPC calls (eth_*) and remaps them to a Flow-centric naming convention (flow_*). This ensures user clarity by aligning the interface naming with the Flow ecosystem, even though the underlying transport mechanisms mirror familiar Ethereum RPC standards.
The Flow EVM environment maintains compatibility with the vast majority of standard Ethereum RPC methods, allowing familiarity for developers accustomed to the broader Ethereum tooling ecosystem.
Supported Environments
- Flow EVM Main Network (Operational Chain ID: 747)
- Flow EVM Test Network (Operational Chain ID: 545)
Deployment Steps
- Install required packages:
npm install - Compile TypeScript sources:
npx tsc - Initiate the server process:
npm start
Example Query Scenario
Determine the current asset holding for the address 0x76A56657d20f572872A81b75530c905fD9F845e5 on the Flow EVM.
An integrated AI agent would map this request directly to the flow_getBalance tool to retrieve the required data.
