Content
# Helium MCP Server
Real-time news with bias scoring, live market data, and AI-powered options pricing — all accessible through the [Model Context Protocol](https://modelcontextprotocol.io).
[](https://glama.ai/mcp/servers/connerlambden/helium-mcp)
[](https://glama.ai/mcp/servers/connerlambden/helium-mcp)
[](https://www.npmjs.com/package/helium-mcp)
[](https://opensource.org/licenses/MIT)
## Overview
Helium MCP gives your AI assistant access to:
- **3.2M+ news articles** from 5,000+ sources, each scored across 15+ bias dimensions
- **Balanced news synthesis** — left, right, and center perspectives aggregated into one coherent story
- **Live market data** — price, IV rank, AI-generated bull/bear cases, and price forecasts
- **AI options pricing** — proprietary ML models for fair-value estimates and probability ITM
- **Meme search** — semantic search across viral memes with OCR text and captions
50 free queries included. No sign-up required.
## Quick Start
### Cursor
Add to your Cursor MCP settings:
```json
{
"mcpServers": {
"helium": {
"url": "https://heliumtrades.com/mcp"
}
}
}
```
### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"helium": {
"type": "streamable-http",
"url": "https://heliumtrades.com/mcp"
}
}
}
```
### Windsurf
Add to your Windsurf MCP settings:
```json
{
"mcpServers": {
"helium": {
"serverUrl": "https://heliumtrades.com/mcp"
}
}
}
```
### GitHub Copilot
Add to your `.github/copilot-instructions.md` or MCP config:
```json
{
"mcpServers": {
"helium": {
"type": "streamable-http",
"url": "https://heliumtrades.com/mcp"
}
}
}
```
### Any MCP Client
Connect to the streamable HTTP endpoint:
```
https://heliumtrades.com/mcp
```
## Example Output
> "What's the bull and bear case for Bitcoin?"
```
get_ticker("BTC")
→ Bitcoin: $71,040.01
Bull case: "Institutional spot demand resumes... squeeze toward mid/upper-80ks to low-100ks"
Bear case: "Higher-for-longer rates, persistent ETF outflows... slide into 40–55k plausible"
Forecast: +1.8% over 37 days (range: -1.2% to +5.0%)
IV Rank: available
Options strategies: long vol + short vol packs included
```
> "How biased is CNN?"
```
get_source_bias("CNN")
→ Emotionality: 7/10
30+ bias dimensions scored (political lean, fearfulness, opinion, oversimplification...)
Signature phrases: "trump threatens", "mortgage rates", "nuclear weapons"
Similar sources: NBC, PBS, AP, Newsweek, CBS
Per-article bias breakdown on recent stories included
```
> "What are the best options trades right now?"
```
get_top_trading_strategies()
→ AI-ranked short vol + long vol setups
Each includes: ticker, price, bull/bear case, 5 probability-weighted outcomes,
full option pack (strike, expiry, Greeks, ML fair value, probability ITM)
```
> "Give me NVIDIA's full analysis"
```
get_ticker("NVDA")
→ NVIDIA: $183.91
5 probability-weighted scenarios (38% mean-revert, 25% +10-25%, 20% -5-12%...)
Forecast: +4.2% over 37 days (range: -2.6% to +8.9%)
IV rank, volatility surface, term structure, return profile charts
27 time-horizon uncertainty visualizations (1-day to 995-day)
```
> "Find me stock market crash memes"
```
search_memes("stock market crash")
→ Babylon Bee: "Kamala Desperately Googles 'What Is A Stock Market Crash'" (32K likes)
→ "Everyone: 'omg the stock market is crashing!' / 500 cigarettes adapter" (437K likes)
Full OCR text, source, date, image URLs included
```
## Tools
### search_news
Full-text search across 3.2M+ articles from 5,000+ sources. Filter by source, category, date, and minimum shares. Returns bias scores, AI summaries, and context.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `query` | string | Yes | — | Search keywords |
| `limit` | integer | No | 20 | Max results (1–100) |
| `source` | string | No | — | Filter by source name (e.g. `"CNN"`, `"Reuters"`) |
| `category` | string | No | — | One of: `trending`, `tech`, `markets`, `politics`, `business`, `science`, `memes` |
| `days_back` | integer | No | 720 | Only include articles from the last N days |
| `min_shares` | integer | No | -1 | Minimum total social shares |
| `sort` | string | No | `"rank"` | One of: `rank` (relevance), `date` (newest), `shares` (most shared) |
### search_balanced_news
AI-synthesized articles that aggregate multiple sources into balanced coverage. Each story includes a summary, takeaway, evidence breakdown, potential outcomes, and relevant tickers.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `query` | string | Yes | — | Search keywords |
| `limit` | integer | No | 10 | Max results (1–50) |
| `category` | string | No | — | One of: `tech`, `politics`, `markets`, `business`, `science` |
| `days_back` | integer | No | 0 | Only include stories from the last N days (0 = no filter) |
### get_source_bias
Deep bias analysis for any news outlet: political lean, emotional tone, prescriptiveness, signature phrases, similar sources, and historical trends.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `source` | string | Yes | — | Source name (e.g. `"Fox News"`) or domain (e.g. `"foxnews.com"`) |
| `recent_articles` | integer | No | 10 | Number of recent articles to include (1–50) |
### get_bias_from_url
Analyze any article URL for per-dimension bias scores: political lean, emotionality, manipulation level, factfulness, and more.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `url` | string | Yes | — | Full article URL |
### get_ticker
Comprehensive data for any stock, ETF, or crypto: live price, AI-generated bull/bear cases, price forecast, IV rank, volatility surface, and top-ranked options strategies.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `ticker` | string | Yes | — | Ticker symbol (e.g. `"AAPL"`, `"SPY"`, `"BTC"`) |
### get_option_price
Helium's proprietary ML model-predicted fair-value price for a specific option contract. Returns predicted price, probability ITM, and the data date.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `symbol` | string | Yes | — | Ticker symbol (e.g. `"AAPL"`, `"SPY"`) |
| `strike` | number | Yes | — | Strike price (e.g. `150.0`) |
| `expiration` | string | Yes | — | Expiration date as `YYYY-MM-DD` |
| `option_type` | string | Yes | — | `"call"` or `"put"` |
### get_top_trading_strategies
Helium's highest-conviction options setups ranked by AI edge score, expected value, and market conditions. Returns both short volatility and long volatility strategies.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `sort` | string | No | `"helium_rank"` | One of: `helium_rank`, `odds_of_profit`, `historical_performance`, `reward_to_risk`, `smallest_max_loss` |
| `limit` | integer | No | 5 | Results per strategy type (1–20) |
### get_all_source_biases
Bias scores for every tracked news source — compare outlets, rank by credibility, or build a full media landscape overview. Returns all sources with >100 articles analyzed, sorted by average social shares.
**Parameters:** None required.
### search_memes
Semantic search across viral memes — images, captions, OCR text, like counts, and source attribution.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `query` | string | Yes | — | Search keywords (matched against OCR text and captions) |
| `limit` | integer | No | 20 | Max results (1–100) |
## Pricing
| Plan | Cost | Details |
|------|------|---------|
| **Free** | $0 | 50 queries per network — no sign-up needed |
| **Pay As You Go** | $0.02/query | Billed daily via Stripe. All 9 tools, unlimited queries. |
Get an API key at [heliumtrades.com/mcp-page](https://heliumtrades.com/mcp-page).
## Examples, Recipes & Interactive Demo
- **[Helium News Bias Explorer](https://connerlambden.github.io/helium-news-explorer/)** — interactive single-page demo (zero dependencies) that fetches the live source-bias corpus and lets you rank, scatter, or inspect any of the 216 sources across all 37 bias dimensions. The fastest way to feel what the API can do without writing code.
- **[Helium Ticker Forecast Dashboard](https://connerlambden.github.io/helium-news-explorer/tickers.html)** — companion dashboard that renders the top 10 short-vol and long-vol candidates with ML 37-day forecasts, uncertainty cones, and bull/bear narratives. Single GET to `mcp_top_strategies/`.
- **[Forecaster Honesty Board](https://connerlambden.github.io/helium-news-explorer/calibration.html)** — post-hoc Brier grades for published `prob_itm` forecasts.
- **[helium-mcp-cookbook](https://github.com/connerlambden/helium-mcp-cookbook)** — eight runnable Python recipes, calibration scorecard, and a citeable bias-corpus dataset snapshot.
## AI discoverability (`llms.txt`)
Machine-readable index for LLM crawlers: [`docs/llms.txt`](docs/llms.txt) and [`docs/llms-full.txt`](docs/llms-full.txt). Deploy copies at `https://heliumtrades.com/llms.txt`. Schema.org snippet for mcp-page: [`docs/mcp-page-schema-snippet.html`](docs/mcp-page-schema-snippet.html).
## Links
- [Helium MCP Page](https://heliumtrades.com/mcp-page/)
- [Helium News Bias Explorer](https://connerlambden.github.io/helium-news-explorer/) — live interactive demo (news side)
- [Helium Ticker Forecast Dashboard](https://connerlambden.github.io/helium-news-explorer/tickers.html) — live interactive demo (markets side)
- [helium-mcp-cookbook](https://github.com/connerlambden/helium-mcp-cookbook) — seven runnable Python recipes
- [Glama](https://glama.ai/mcp/servers/connerlambden/helium-mcp)
- [Smithery](https://smithery.ai/servers/conner-m4el/helium-mcp)
- [npm](https://www.npmjs.com/package/helium-mcp)
- [Helium Trades](https://heliumtrades.com)
- [Privacy Policy](https://heliumtrades.com/pp/)
## License
MIT
