Bearing Core

Route AI tasks across local and cloud models from one MCP cockpit.

Bearing Core is an MCP server + CLI that helps AI assistants escalate work to the best-fit model based on policy and runtime availability. Run guided setup, validate local and cloud model wiring, inspect available tools, and simulate routing decisions before execution. Published as an open-source Python package with reproducible release artifacts.

What's included

Guided setup with `bearing init`
Environment diagnostics via `bearing doctor`
Dynamic tool inventory with `bearing list-tools`
Route simulation with `bearing test-route`
Runtime MCP tools for escalation and health checks
Works in Cursor and VSCode MCP workflows

Requirements

Python 3.12+
Any MCP-compatible AI client (Cursor, VSCode, Claude Code, Windsurf)
Optional: local model runtime (Ollama) and/or cloud model CLIs