v0.2.5

Congressional disclosure dates

house_trades_by_ticker and senate_trades_by_ticker now return
disclosure_date on every series row — when the trade became public, as
opposed to date, which is when it was executed. Agents can answer
reporting-lag questions directly instead of inferring them.

screener_house_trades and screener_senate_trades carry the field too.

Upgrading

Requires finbrain-python >= 0.2.6.

The JSON shape is additive — no existing keys renamed or removed. One thing
to check: format="csv" output gains a trailing disclosure_date column,
where a missing value renders as an empty field rather than null. Anything
parsing those CSVs positionally, or asserting a fixed column count, needs
updating.

disclosure_date is null on rows collected before the field was captured
upstream, so treat it as optional.

pip install --upgrade finbrain-mcp

v0.2.4

[0.2.4] - 2026-06-18

Added

• patent_filings_by_ticker tool — USPTO granted patents mapped to a single ticker by corporate assignee (patent ID, grant date, title, type, claims, citations, CPC classification, inventors, filing-to-grant time)
• screener_patent_filings tool — cross-ticker patent filings screening with summary stats (total patents, total tickers, top CPC sections)
• Integration tests for patent filings (ticker, screener, and tool-level round-trip)

Fixed

• Screener summary block is now populated for screener_government_contracts (regression since 0.2.3) and screener_reddit_mentions (since 0.2.2) — both previously returned all-null summary fields because the SDK unwraps screener responses down to the rows and discards the summary. The adapter now fetches the full envelope so the backend-computed summary is preserved.

Changed

• Bumped finbrain-python dependency from >=0.2.3 to >=0.2.5 (required for patent filings endpoints)
• FBClient now caches the underlying finbrain-python client per API key, so repeated tool calls reuse a single HTTP session/connection pool instead of opening a new one each call
• Strengthened screener integration tests to assert summary values (not just key presence), which is what previously masked the empty-summary bug
• Internal cleanup: removed the unused _make_client helper from the server entrypoint, documented latest_slice's chronological-ordering assumption, and corrected README inaccuracies (a non-existent settings.py in the project tree and the API-key configuration note)

v0.2.3 — U.S. Government Contracts

[0.2.3] - 2026-03-30

Added

• government_contracts_by_ticker tool — U.S. government contract awards (award amount, awarding agency, NAICS classification, dates) for a single ticker
• screener_government_contracts tool — cross-ticker government contract screening with summary stats (total contracts, total value)
• Integration tests for government contracts (ticker, screener, and tool-level round-trip)

Changed

• Bumped finbrain-python dependency from >=0.2.3 to >=0.2.4 (required for government contracts endpoints)

v0.2.2 — Add Reddit Mentions tracking across subreddits

[0.2.2] - 2026-03-17

Added

• reddit_mentions_by_ticker tool — Reddit mention counts across subreddits for a single ticker (date, subreddit, mentions)
• screener_reddit_mentions tool — cross-ticker Reddit mention screening with per-subreddit breakdown and summary stats

Changed

• Bumped finbrain-python dependency from >=0.2.1 to >=0.2.3 (required for Reddit mentions endpoints)

v0.2.1 — Add Corporate Lobbying dataset integration

[0.2.1] - 2026-03-12

Added

• corporate_lobbying_by_ticker tool — corporate lobbying filings (registrant, income, expenses, issue codes, government entities) for a single ticker

Changed

• Bumped finbrain-python dependency from >=0.2.0 to >=0.2.1 (required for corporate lobbying endpoint)

v0.2.0 - API v2 Migration + Full Endpoint Coverage

[v0.2.0] - 2026-03-10

Added

• news_by_ticker tool — recent news articles with per-article sentiment for a single ticker
• available_regions tool — list markets grouped by region
• recent_news tool — latest news articles across all tracked stocks
• recent_analyst_ratings tool — latest analyst ratings across all tracked stocks
• 9 screener tools for cross-ticker screening:
  • screener_sentiment, screener_analyst_ratings, screener_news
  • screener_insider_trading, screener_house_trades, screener_senate_trades
  • screener_put_call_ratio, screener_linkedin, screener_app_ratings

Changed

• BREAKING: Migrated from FinBrain API v1 to v2
  • The market parameter has been removed from all per-symbol tool inputs (news_sentiment_by_ticker, app_ratings_by_ticker, analyst_ratings_by_ticker, house_trades_by_ticker, senate_trades_by_ticker, insider_transactions_by_ticker, linkedin_metrics_by_ticker, options_put_call)
  • predictions_by_market now uses the v2 screener endpoint and accepts optional market, region, and prediction_type parameters instead of a required market
  • insider_transactions_by_ticker now supports date_from and date_to parameters
• Upgraded fastmcp dependency from v2 to v3
• Upgraded finbrain-python dependency from v0.1.x to v0.2.0
• Rewrote all normalizers for v2 response shapes (field renames, restructured data keys, nested objects)
• Updated fake SDK fixtures and all tests for v2 compatibility

v0.1.6 - Senate Trades & Python 3.14 Support

New Features

• Senate Trades API — New senate_trades_by_ticker tool to retrieve US Senator stock transactions disclosed under the STOCK Act. Complements the existing House trades endpoint for complete congressional trading coverage.

Improvements

• Python 3.14 support — Added Python 3.14 to the CI test matrix
• Documentation link — Added link to official FinBrain MCP documentation at finbrain.tech/integrations/mcp

What's Changed

• Add senate_trades_by_ticker MCP tool with normalizer and tests
• Update "US Congress Trades" feature description to include Senators
• Add Python 3.14 to CI pipeline

Full Changelog: v0.1.5...v0.1.6

v0.1.5 - Docker Support

🐋 Docker Support

This release adds Docker support for containerized deployment of FinBrain MCP server.

✨ What's New

• Docker Support: Multi-stage Dockerfile for optimized containerized deployment

  • Optimized image size with multi-stage build (~640MB)
  • Runs as non-root user for security
  • Includes health checks
  • Uses Python 3.11-slim base image

• Documentation: Added comprehensive Docker usage guide (DOCKER.md)

• CHANGELOG: Added CHANGELOG.md to track version history

🚀 Docker Usage

Pull and run the image (once published to Docker MCP Catalog):

docker pull mcp/finbrain
docker run -i --rm -e FINBRAIN_API_KEY="your_key" mcp/finbrain

Or build locally:

docker build -t finbrain-mcp:latest .
docker run --rm -e FINBRAIN_API_KEY="your_key" finbrain-mcp:latest

v0.1.2

Initial public release of FinBrain MCP