Skip to content

v1.0.0

Choose a tag to compare

@wshobson wshobson released this 20 Jul 08:35
· 49 commits to main since this release

maverick-mcp-server v1.0.0

This release completes a from-scratch modernization: the legacy maverick_mcp/
package (~145k lines) is fully replaced by a clean maverick/ package built on
a shared platform seam (config, database, cache, HTTP, LLM) plus six focused
domains — market data, screening, portfolio, technical, backtesting, and
research — assembled into a single FastMCP server. The core install is now a
slim, dependency-light server (no TA-Lib, no plotting stack, no five-vendor
LLM auto-detection); [backtesting] and [research] ship as opt-in extras,
and LLM access is bring-your-own-key (BYOK) via explicit LLM_* env vars.

Breaking changes

  • Package renamed: maverick_mcpmaverick-mcp-server (PyPI name);
    the importable package is now maverick.
  • SSE transport removed. Supported transports are stdio (default) and
    streamable HTTP only.
  • Tool surface retired: the signal engine/alerts, health/system
    monitoring, introspection (discover_capabilities, etc.), decision-log/
    registry-status tools, news sentiment (Tiingo) and Adanos sentiment, cache
    introspection, and the economic calendar stub are all gone. The 9 legacy
    prompts and the 3 legacy stock://* resources are replaced by 3 curated
    prompts and one portfolio://my-holdings resource.
  • LLM auto-detection removed. The old five-vendor auto-detect
    (OPENROUTER_API_KEY/ANTHROPIC_API_KEY/etc.) is replaced by explicit BYOK
    config: LLM_PROVIDER / LLM_API_KEY / LLM_MODEL / LLM_BASE_URL.
  • Entrypoint changed. The server now starts via python -m maverick.server
    or the maverick-mcp console script (a maverick-mcp-server alias is also
    provided for uvx resolution). The old maverick_mcp.api.server module no
    longer exists.
  • Risk dashboard, watchlist, and trade journal tools survive the cutover —
    they moved into maverick/portfolio/ and keep their legacy table names/
    schemas so existing SQLite/Postgres data carries over untouched.

Migration

See docs/runbooks/migrating-to-v1.md
for the full env-var mapping table, the list of dead variables, and notes on
inert legacy tables.

Install

Once published to PyPI:

uvx --from maverick-mcp-server maverick-mcp
# or
pip install "maverick-mcp-server[backtesting,research]"

The package is not yet published to PyPI (that's Phase 9). Until then,
install from source:

git clone https://github.com/wshobson/maverick-mcp.git
cd maverick-mcp
uv sync --extra dev --extra backtesting --extra research
uv run python -m maverick.server --transport stdio