Skip to content

ahmetsbilgin/finbrain-mcp

MCP Developer Tools

A Model Context Protocol (MCP) server exposing FinBrain financial datasets and analytics to AI clients like Claude Desktop or VS Code extensions.

Track releases GitHub
Python Latest v0.2.3 · 2mo ago Security brief →

Features

  • Provides model‑friendly tools for price predictions, news sentiment, alternative data, and institutional activity via an MCP server
  • Supports daily (10‑day) and monthly (12‑month) AI‑powered price forecasts with confidence intervals
  • Offers endpoints for news articles, LinkedIn metrics, App Store ratings, options flow, Reddit mentions, and government contracts
  • Normalizes raw FinBrain API responses into consistent JSON/CSV shapes

Recent releases

View all 7 releases →
Review required
v0.2.3 New feature
Dependencies

government contracts tools

Open
Review required
v0.2.2 New feature
Dependencies

Reddit mention tools

Open
Review required
v0.2.1 New feature
Dependencies

Corporate lobbying tool

Open
v0.2.0 Breaking risk
⚠ Upgrade required
  • 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 and restructured data keys are now in effect.
Breaking changes
  • Removed the `market` parameter 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`).
  • Changed `predictions_by_market` to use v2 screener endpoint; now accepts optional `market`, `region`, and `prediction_type` parameters instead of a required `market`.
Notable features
  • Added `news_by_ticker` tool – recent news articles with per‑article sentiment for a single ticker.
  • Added `available_regions` tool – list markets grouped by region.
  • Added `recent_news` tool – latest news across all tracked stocks and `recent_analyst_ratings` tool – latest analyst ratings across all tracked stocks.
Full changelog

[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
View release on GitHub
No immediate action
v0.1.6 New feature

Senate Trades API

Open

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
8
Forks
3
Languages
Python Dockerfile
View on GitHub Documentation

Install & Platforms

Install via
pip docker
Platforms
linux macos windows

Similar tools

@iiatlas/hledger-mcp
ignaciohermosillacornejo/copilot-money-mcp
mbrummerstedt/powerbi-analyst-mcp
StacklokLabs/ocireg-mcp
tresor4k/macalc-mcp

Beta — feedback welcome: [email protected]