⚠️ AI-Agent-Only Repository

This repo is planned, maintained, and managed exclusively by AI Agents. Slop issues, rough edges, and AI artifacts are expected and intentionally present as part of an HITL-less / minimized AI-DD metaproject focused on learning, refining, and brute-force training both the agents and the human operator. Bug reports and contributions are still welcome, but please expect AI-generated code, comments, and documentation throughout.

Work State

Progress: ████████░░ 80%

dispatch-mcp

MCP server for tier-based dispatch delegation via OmniRoute.

Related MCP server: SystemPrompt MCP TaskChecker

Tools

Per-tier dispatch tools

Each accepts a single message: str argument and dispatches it to the configured OmniRoute backend under the corresponding tier.

Custom dispatch

dispatch_custom(tier: str, message: str) — dispatch to any tier from VALID_TIERS above.

Health

• dispatch_health() — probe the OmniRoute backend health endpoint. Requires OMNIROUTE_URL to be set.

• dispatch_liveness() — returns server liveness status without contacting OmniRoute.

Health module (production)

dispatch_mcp.health exposes three pure-Python functions intended for production probes and observability:

Wire them into FastMCP tools, an HTTP wrapper, or invoke them directly from tests. Default readiness() is config-only to avoid stampeding the backend.

Configuration

Constraints

• message must not exceed 4096 bytes (UTF-8 encoded).

• tier must be one of the known tiers listed above.

• OMNIROUTE_URL must use http:// or https:// scheme. Other schemes (e.g. file://, javascript:) are rejected at startup with a ValueError.

• HTTP redirects are not followed — only direct requests to OMNIROUTE_URL are made.

Build

Install the package in editable mode with the dev extras (pulls in pytest, pytest-cov):

python -m pip install -e ".[dev]"

The runtime dependencies are fastmcp>=3.2.4 and httpx>=0.27.0. Requires Python 3.13+.

Test

# Run the full test suite with coverage (uses pyproject.toml addopts)
pytest

# Or with an explicit report
pytest --cov-report=term-missing

The default addopts (see [tool.pytest.ini_options]) enables branch coverage, missing-line reporting, and fails the run if coverage drops below 80%.

Lint & type check

# Format
ruff format .

# Lint
ruff check .

# Strict type check
mypy src/ --strict

The same checks run in CI (see .github/workflows/ci.yml).

Run

# Set the backend URL
export OMNIROUTE_URL=http://localhost:20128

# Via entry point
dispatch-mcp

# Or directly
python -m dispatch_mcp.server