mcpField
F
Flow MCP Server

Flow MCP Server

Local
github.com/lmcmzFinance1Updated 84w ago
Repository

About Flow MCP Server

Flow MCP Server connects AI assistants to Flow blockchain data and operations through direct RPC communication. It covers account and token queries as well as script execution and transactions.

Key features

  1. 01Flow and fungible-token balances
  2. 02Account information lookup
  3. 03.find and .fn domain resolution
  4. 04Cadence script execution
  5. 05Transaction submission and monitoring
  6. 06Environment-based Flow configuration

Use cases

  1. 01Check a Flow address or token balance
  2. 02Resolve a .find or .fn domain
  3. 03Read chain data with a Cadence script
  4. 04Submit a transaction and check its status

MCP support

Exposes Flow blockchain tools to MCP clients, including balance and account queries, domain resolution, Cadence script execution, and transaction operations. It supports stdio and HTTP modes.

#flow#mcp#blockchain#rpc#server#flow-mcp-server#ai-assistant

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "flow": {
      "command": "npx",
      "args": [
        "-y",
        "@outblock/flow-mcp-server"
      ]
    }
  }
}
Run commandnpx -y @outblock/flow-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@outblock/flow-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Flow MCP Server

A Model Context Protocol (MCP) server for interacting with the Flow blockchain. This server enables AI assistants to access Flow blockchain data and perform operations through a standardized interface.

Features

  • Balance checking for Flow and fungible tokens
  • Domain resolution for .find and .fn domains
  • Script execution for reading blockchain data
  • Transaction submission and monitoring
  • Account information retrieval
  • Flow configuration based on environment variables

Installation

Using npx (Recommended)
npx -y @outblock/flow-mcp-server --stdio

Or specify HTTP mode with a port:

npx -y @outblock/flow-mcp-server --port 3000
Local Installation (For Development)
git clone https://github.com/lmcmz/flow-mcp-server.git
cd flow-mcp-server
npm install
npm run build
npm start

Usage

Running with npx
# Run in stdio mode (for AI assistant integration)
npx -y @outblock/flow-mcp-server --stdio

# Run as HTTP server on port 3000
npx -y @outblock/flow-mcp-server --port 3000

# Specify Flow network
npx -y @outblock/flow-mcp-server --port 3000 --network testnet
Running Local Development Server
# Run in stdio mode
npm run build
npm start

# Run as HTTP server on port 3000
npm run build
PORT=3000 npm start

# For development with auto-reload
npm run dev

Configuration

The server can be configured using environment variables:

  • PORT - HTTP port to listen on (if not set, defaults to stdio mode)
  • FLOW_NETWORK - Flow network to connect to (mainnet, testnet, emulator)
  • FLOW_ACCESS_NODE - Custom Flow access node URL
  • LOG_LEVEL - Logging level (debug, info, warn, error)

Using with AI Assistants

When integrating with AI assistants like Claude, you can start the MCP server in stdio mode and connect it to your assistant's tool configuration.

Example Claude tool configuration:

{
  "tools": [
    {
      "name": "flow-mcp-server",
      "command": "npx -y @outblock/flow-mcp-server --stdio"
    }
  ]
}

HTTP API Endpoints

When running in HTTP mode, the following endpoints are available:

  • /sse - Server-Sent Events endpoint for real-time updates
  • /messages - POST endpoint for sending tool requests
  • /health - Health check endpoint
  • / - Server information

Example HTTP API call:

curl -X POST http://localhost:3000/messages \
  -H "Content-Type: application/json" \
  -d '{
    "tool_request": {
      "name": "get_balance",
      "parameters": {
        "address": "0x2d4c3caffbeab845",
        "network": "mainnet"
      }
    }
  }'

Available Tools

  • get_balance - Get Flow balance for an address
  • get_token_balance - Get fungible token balance
  • get_account - Get account information
  • resolve_domain - Resolve a .find or .fn domain to an address
  • execute_script - Execute a Cadence script
  • send_transaction - Send a transaction to the blockchain
  • get_transaction - Get transaction details by ID

Version History

  • v0.1.1 - Bug fix for formatArguments import issue in transaction service
  • v0.1.0 - Initial release with basic Flow blockchain integration

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.