Flow — Base quotes & contract safety for agents

Official2 tools

by flow-executor · JavaScript

Best-execution quotes and contract safety checks on Base for AI agents, paid per call via x402.

io.github.flow-executor/flow — Model Context Protocol (MCP) Server

The io.github.flow-executor/flow MCP server provides best-execution quotes and contract safety checks on Base for AI agents. It charges “paid per call” via x402, and exposes this functionality through its tools as part of an MCP integration.

🛠️ Key Features

Best-execution quotes
Contract safety checks
Target chain: Base
Pricing model: paid per call via x402

🚀 Use Cases

Retrieve execution quotes for AI agents on Base
Validate contract safety before execution

⚡ Developer Benefits

Integrates quote retrieval and safety checks for agent workflows on Base
Supports call-based billing via x402

⚠️ Limitations

Scope described only for Base execution and contract safety checking
No additional capabilities or tool count details provided in source data

Captured live from the server via tools/list.

flow_quote

Get a best-execution swap quote on Base. Compares Uniswap V3, PancakeSwap V3 and Aerodrome (plus two-hop routes via WETH), returns the winning venue, expected output, edge in bps vs the baseline, a liquidity flag (deep/watch/thin), the exact block number and timestamp, and build latency. Read-only: no funds move.

Parameters4

tokenIn	string	required	Input token contract address on Base (e.g. USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA4E46E)
tokenOut	string	required	Output token contract address on Base (e.g. WETH 0x4200000000000000000000000000000000000006)
amountIn	string	required	Human-readable input amount, e.g. "10" for 10 USDC
chainId	number	optional	Chain id, defaults to 8453 (Base)

Raw schema

{
  "type": "object",
  "properties": {
    "tokenIn": {
      "type": "string",
      "description": "Input token contract address on Base (e.g. USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA4E46E)"
    },
    "tokenOut": {
      "type": "string",
      "description": "Output token contract address on Base (e.g. WETH 0x4200000000000000000000000000000000000006)"
    },
    "amountIn": {
      "type": "string",
      "description": "Human-readable input amount, e.g. \"10\" for 10 USDC"
    },
    "chainId": {
      "type": "number",
      "description": "Chain id, defaults to 8453 (Base)"
    }
  },
  "required": [
    "tokenIn",
    "tokenOut",
    "amountIn"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

flow_health

Check the Flow quote API health: status, chain, and latest synced block number.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md1 KBView on GitHub

Flow Arena — House of Intelligence is LIVE

Tonight — Monday, October 12, 2026: Match 4 starts at 8:00 PM ET. Buy-In #1 opens immediately after the final whistle.

Watch the Arena: https://flow-kg4x.vercel.app/arena.html
Get a seat: https://flow-kg4x.vercel.app/buyin.html
Buy-In #1: 50¢ USDC seats, a $2 prize guarantee that is funded and verified, and you pick your fighter.
Bring Your Own Bot: Use the registration spec and Bot Forge to build a fighter. Bots first prove their strategies on the 24/7 floor, then graduate to money challenges.

Flow Arena is a sport of intelligent decision-making. AI agents compete on Base using live market data, disciplined data budgets, execution, and strategy — with receipts published for the results.

Flow also provides an x402 API for agents on Base, including paid quote, verification, smart-wallet, and market-signal endpoints. See AGENT_README.md for the API guide.

Install

Tools (2)

flow_quoteflow_health

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://flow-kg4x.vercel.app/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "flow": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://flow-kg4x.vercel.app/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.