FIX MCP Server

A production-grade MCP server for FIX protocol trading operations. Exposes 15 tools, 4 resources, and 6 role-specific prompts over stdio. Backed by a full PostgreSQL + Redis stack for production deployment.

What it includes

15 MCP tools — order management, FIX session repair, ticker operations, algo execution, scenario loading
13 trading scenarios — 24-hour coverage from 02:05 ET pre-dawn through 16:32 ET after-hours
6 role prompts — specialized system prompts for trading-ops, session-engineer, order-desk, ticker-ops, risk-compliance, algo-trader
Algorithmic order engine — TWAP, VWAP, POV, IS, DARK_AGG, ICEBERG with schedule tracking and execution quality metrics
Production stack — PostgreSQL 16 + Redis 7 via Docker Compose, async FIX TCP connector

Quick Start (local)

# Install into local venv
XDG_CACHE_HOME=/tmp ./.venv/bin/python -m pip install -e . --no-build-isolation

# Start the MCP server (stdio)
SCENARIO=morning_triage ./.venv/bin/fix-mcp-server

Quick Start (Docker)

docker compose up -d
# MCP stdio:   docker compose run --rm mcp-server
# REST API:    http://localhost:8000
# Dashboard:   http://localhost:8787

MCP Client Configuration

{
  "mcpServers": {
    "fix-mcp": {
      "command": "/home/urbano-claw/FIX-MCP/fix-mcp-server/.venv/bin/fix-mcp-server",
      "args": [],
      "cwd": "/home/urbano-claw/FIX-MCP/fix-mcp-server"
    }
  }
}

Environment Variables

Variable	Default	Description
`SCENARIO`	`morning_triage`	Scenario to load on startup
`FIX_MCP_CONFIG_DIR`	auto-discovered	Config directory override
`DATABASE_URL`	—	PostgreSQL connection string (production)
`REDIS_URL`	—	Redis connection string (production)
`LOG_LEVEL`	`INFO`	Logging level

Tools (15)

Tool	Category	Description
`query_orders`	Orders	Query OMS with filters; returns notional and SLA countdowns
`check_fix_sessions`	Sessions	Session health, seq numbers, heartbeat age, latency
`send_order`	Orders	NewOrderSingle via FIX 35=D with auto-routing
`cancel_replace`	Orders	Cancel (35=F) or replace (35=G) an existing order
`check_ticker`	Reference	Symbol/CUSIP lookup with corporate actions and open order count
`update_ticker`	Reference	Rename symbol and bulk-update all open orders
`load_ticker`	Reference	Load new symbol and release pending IPO orders
`fix_session_issue`	Sessions	Resend request, sequence reset, or reconnect
`validate_orders`	Orders	Pre-flight validation against symbol, venue, and compliance rules
`run_premarket_check`	Ops	Full pre-market health check across all systems
`send_algo_order`	Algos	Submit TWAP/VWAP/POV/IS/DARK_AGG/ICEBERG parent order
`check_algo_status`	Algos	Schedule deviation, IS shortfall, execution quality
`modify_algo`	Algos	Pause, resume, or update POV participation rate
`cancel_algo`	Algos	Cancel algo and send cancel for all child slices
`list_scenarios`	Scenarios	List or load trading scenarios

See docs/tools.md for full parameter schemas.

Scenarios (13)

Name	Time	Key Problems
`morning_triage`	06:15 ET	ARCA down, BATS seq gap, ticker rename ACME→ACMX
`bats_startup_0200`	02:05 ET	BATS SequenceReset with unexpected NewSeqNo
`predawn_adrs_0430`	04:35 ET	Shell ADR rebrand RDSA→SHEL, ARCA latency 220ms
`preopen_auction_0900`	09:02 ET	MOO imbalance, IEX feed stale
`open_volatility_0930`	09:35 ET	GME LULD halt, BATS packet loss
`venue_degradation_1030`	10:32 ET	NYSE latency 180ms, Mahwah route flap
`ssr_and_split_1130`	11:34 ET	RIDE SSR trigger, AAPL 4:1 split in 26 min
`iex_recovery_1400`	14:03 ET	IEX recovered, D-Limit rerouting
`eod_moc_1530`	15:31 ET	MOC cutoff, GTC preservation
`afterhours_dark_1630`	16:32 ET	Dark pool offline, Liquidnet SessionStatus=8
`twap_slippage_1000`	10:05 ET	TWAP behind schedule, GME halted mid-algo
`vwap_vol_spike_1130`	11:35 ET	VWAP over-participation, BATS latency spike
`is_dark_failure_1415`	14:15 ET	IS high shortfall, dark aggregator no fills

See docs/scenarios.md for full scenario details.

Role Prompts (6)

Prompt Name	Scope
`trading-ops`	General — all domains, primary triage
`session-engineer`	FIX transport layer only
`order-desk`	Routing, execution, SLA management
`ticker-ops`	Reference data, corporate actions, splits
`risk-compliance`	SSR, LULD, large order review, EOD
`algo-trader`	TWAP, VWAP, POV, IS, dark aggregator

See docs/prompts.md for full prompt descriptions and tool assignments.

Tests

PYTHONPATH=src ./.venv/bin/python -m pytest

16 tests covering tools, scenarios, algo orders, and session repair.

CLI Smoke Test

cd /home/urbano-claw/FIX-MCP/fix-mcp-server && PYTHONPATH=src ./.venv/bin/python -c "import asyncio; from fix_mcp import server; print(asyncio.run(server.call_tool('run_premarket_check', {}))[0].text)"

Dashboard

PYTHONPATH=src ./.venv/bin/fix-mcp-dashboard
# Open: http://127.0.0.1:8787

The dashboard is self-contained — serves both the HTML and the API from one process. Features:

Per-scenario guided workflow steps (all 13 scenarios have specific steps)
Session health cards with latency and sequence gap indicators
Tabbed view: Output / Sessions / Orders / Algos
Inline algo Pause and Cancel buttons
Send Order and Session Repair forms in sidebar
Scenario dropdown reloads runtime and refreshes workflow steps

REST API

PYTHONPATH=src ./.venv/bin/fix-mcp-api
# Endpoints: http://localhost:8000

Standalone REST API for external integrations (OMS hooks, Claude.ai, monitoring):

GET /health — liveness probe
GET /api/status — full status: scenario, sessions, orders, algos
GET /api/scenarios — list all 13 scenarios with context strings
POST /api/tool — call any MCP tool: {"tool":"...", "arguments":{...}}
POST /api/reset — load a scenario: {"scenario":"morning_triage"}

Documentation

Architecture — component diagram, data flow, engine layer
Tools — all 15 tools with parameter schemas and examples
Scenarios — all 13 scenarios with time, problems, and flags
Prompts — all 6 role prompts with scope and escalation paths
Algo Suite — algo types, execution flags, quality thresholds
Production — Docker deploy, DB schema, FIX gateway, go-live checklist, next building blocks

FIX MCP Server

FIX MCP Server

What it includes

Quick Start (local)

Quick Start (Docker)

MCP Client Configuration

Environment Variables

Tools (15)

Scenarios (13)

Role Prompts (6)

Tests

CLI Smoke Test

Dashboard

REST API

Documentation

Reviews