MCP.Market

SentimentFX MCP server

online · 96% uptime
by sentimentfx.org·org.sentimentfx/market-sentiment·v1.0.0
No reviews yet

FinBERT news sentiment and price history for 42 crypto, FX, stock, ETF and commodity tickers.

A88/100grade A
Write a reviewRun it
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
Growing

0 stars

Reviews

Write one

Nobody has reviewed SentimentFX yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

SentimentFX tools (6)

write = sends, deletes, buys or posts
  • get_correlationFree

    180-day Pearson correlation between daily sentiment shifts and next-day price returns for `ticker`. Returns Pearson `r`, `p_value`, `n_days` overlapping, a 95% confidence interval (Fisher z), and a categorical `strength` (strong / weak / inconclusive). Costs 1 API credit — same as GET /v1/correlation/{ticker}. Requires ≥30 overlapping day-pairs. Under that, returns a `note` field explaining what's missing so a caller can suggest waiting or switching to a higher-coverage ticker.

  • get_pricesFree

    Return daily close prices for `ticker` over the last `days`, in the ticker's native currency -- see the `currency` field on the response. Costs 1 API credit per day actually returned — same as GET /v1/prices/{ticker}. Prices come back reverse-chronological. Crypto is GBP (yfinance BTC-GBP etc.), FX pairs are a raw exchange rate in the pair's native convention (e.g. USDJPY is yen per dollar), and everything else (stocks/ETFs/commodity futures) is native USD -- there is no currency conversion.

  • get_sentimentFree

    Return the most recent FinBERT-scored headlines for `ticker`. Each headline has a `sentiment_score` in [-1, +1] (positive_prob - negative_prob) and a categorical `sentiment_label`. Costs 1 API credit per 25 headlines actually returned — same billing as GET /v1/sentiment/{ticker}. An empty result costs nothing. `limit` is capped at 100. Titles come back reverse-chronological so the first item is the freshest.

  • get_summaryFree

    Return daily aggregated sentiment for `ticker` over the last `days`. Each entry has `avg_sentiment` (unweighted mean of that day's scores), `article_count`, and a directional `label` (positive / negative / neutral, thresholded at ±0.1). Costs 1 API credit per day actually returned — same as GET /v1/summary/{ticker}. A window with no coverage costs nothing.

  • get_usageFree

    Introspect your API key: included allowance, remaining credits, and when they refill. Free keys get 1,000 calls per 30-day window starting at their first billable call (`resets_at` is null when no window is running); paid plans refill on the 1st of each month. Free — doesn't hit the billing meter. Useful before a large batch of `get_sentiment`/`get_summary` calls to check you have credit headroom.

  • list_tickersFree

    List every asset SentimentFX tracks. Cheap (free — doesn't hit the billing meter). Returns two groups: `primary` (5 crypto + 7 FX pairs — the ones with full sentiment coverage across the primary RSS feeds), and `background` (US equities, ETFs, commodity futures — coverage is thinner but real). Use the exact ticker string from either group as the `ticker` arg to the other tools.

Public scan report

scanner v0.1.10 · 2026-10-16 · same rubric, same numbers if you re-run it

no findings
  • –Code scanremote-only server, no package to scann/a
  • Live reliabilityremote reachable in 1464ms20/20
  • Tool poisoning6 tool descriptions checked15/15
  • Auth qualityAPI key sent as a header8/15
  • Maintenancelast push 1 days ago15/15
  • Maintainer identityendpoint served from the registry-verified namespace domain8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How SentimentFX compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 85% of 1,759 Finance servers
Tools
6
the typical Finance server has 8
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Uptime
96%
of our recent checks; the typical remote Finance server answers 100%
Response time
198 ms
faster than 68% of 1,131 Finance servers

What its tools let an agent do: 6 read

Install SentimentFX in Claude Code, Cursor or VS Code

claude mcp add --transport http market-sentiment https://api.sentimentfx.org/mcp
Add to Cursor

What the publisher says

From the SentimentFX repository's README, as published. We do not edit it. Read it on GitHub

SentimentFX

Full-stack crypto sentiment intelligence platform. Scrapes financial news headlines, scores them with FinBERT (a finance-specific transformer model), and correlates sentiment against live GBP crypto prices to surface predictive signals.

Live: sentimentfx.org · app.sentimentfx.org · developers.sentimentfx.org

What it does

  • Scrapes headlines every hour from GNews API + CoinTelegraph/CoinDesk RSS feeds
  • Scores each headline with FinBERT (positiveprob - negativeprob → range -1 to +1)
  • Fetches daily GBP prices via yfinance
  • Computes Pearson correlation across 0–7 day lags to find the best predictive signal
  • Exposes a public metered API with Stripe billing for developers

Tech Stack

Features

Dashboard

  • Sentiment vs price chart with 7/30/90/ALL day ranges
  • Pearson correlation with lag analysis (0–7 days)
  • Momentum vs contrarian signal detection
  • Paginated headline feed with per-article sentiment scores
  • GBP/USD currency toggle
  • CSV export (Pro)

Tickers: BTC, ETH, SOL, XRP, DOGE

Access tiers

  • Free — BTC only, 30 day history
  • Pro (£11.99/mo or £99.99/yr) — all tickers, full history, CSV export, sentiment alerts

Developer API (api.sentimentfx.org/v1/)

  • /v1/sentiment/{ticker} — scored headlines
  • /v1/summary/{ticker} — daily averaged sentiment
  • /v1/prices/{ticker} — daily GBP closing prices
  • /v1/correlation/{ticker} — Pearson r across lag periods
  • Metered billing at £0.01/call after 100 free calls
  • Rate limited via slowapi

Architecture

GNews API + RSS feeds
        ↓
   scraper.py → FinBERT (sentiment.py) → headlines table
                                              ↓
yfinance → prices.py → prices table    /dashboard/{ticker}
                                              ↓
                                       React + Recharts

APScheduler runs scrape_all() on a cron trigger at the top of every hour.

Getting Started

Backend

cd backend
python -m venv venv
source venv/Scripts/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env          # fill in your keys
python -m uvicorn app.main:app --reload

Frontend

cd frontend
npm install
npm run dev

Sentiment Scoring

Uses FinBERT's output probabilities directly:

score = positive_probability - negative_probability

Range: -1 (maximally negative) to +1 (maximally positive). Neutral headlines score near 0. This avoids the label × confidence collapse that zeros out neutral predictions.

API Reference

Full docs at developers.sentimentfx.org

# Generate a free API key
curl -X POST https://api.sentimentfx.org/api/keys/generate \
  -H "Content-Type: application/json" \
  -d '{"email": "your@email.com"}'

# Use the key
curl https://api.sentimentfx.org/v1/summary/BTC \
  -H "X-API-Key: sfx_your_key_here"

Deployment

  • Backend: Railway via Procfile + nixpacks.toml. Starts with uvicorn app.main:app --host 0.0.0.0 --port $PORT.
  • Frontend/Landing/Docs: Vercel, auto-deploys from main.

Nothing above is checked by us. What we check is on the safety report.

SentimentFX: common questions

Is SentimentFX MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the SentimentFX safety report
How do I install SentimentFX?
It runs remotely at api.sentimentfx.org. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does SentimentFX need an API key?
Yes. The registry entry asks for X-API-Key.
Is SentimentFX maintained?
The last commit was 21 days ago (2026-10-15). The latest release is v1.0.0.
Is SentimentFX up?
96% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of SentimentFX?
Servers from other publishers that do the same job: Zwldarren Akshare One MCP server, Alpha Vantage MCP server and TickDB Market Data MCP server.
How does SentimentFX compare with other Finance MCP servers?
safety score 88/100 (higher than 85% of 1,759 Finance servers); tools 6 (the typical Finance server has 8); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to SentimentFX

Same job from other publishers: the closest match first, then the best rated.

  • Zwldarren Akshare One
    Provide access to Chinese stock market data including historical prices, real-time data, news, and…
    More from smithery.ai →
    A
  • Alpha Vantage
    Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators
    A
  • TickDB Market Data
    Real-time & historical market data: forex, stocks, crypto, indices, metals, K-line, quotes
    B
  • Shumi
    Crypto market intelligence: prices, funding rates, narratives, regime, and delta-neutral research.
    A
  • Free Crypto News
    Free crypto news MCP server — 38 tools, 130+ sources, market data, sentiment, whale alerts & more
    More from nirholas →
    B