MCP Server · Finance

Financial market data & macro insights for AI agents.

MacroView is a finance MCP server — 21 read-only tools that plug live market data and macro-economic insights straight into any AI agent over the Model Context Protocol. Market heatmaps, a volatility regime read, carry-unwind and gold-driver gauges, IPO & earnings calendars, a sovereign-debt network and a daily news digest — the same feed the MacroView dashboard runs on.

https://macro-view.com/mcp
Connect your agent

One endpoint. Every client.

Add MacroView as a remote MCP server and replace the placeholder key with your bearer token. Works with Claude Code, Codex, Cursor, opencode, pi and — from code — the OpenAI Responses API.

Claude Codeterminal
claude mcp add macroview --transport http \
  --header "Authorization: Bearer etfffs_sk_YOUR_KEY" \
  https://macro-view.com/mcp
Codex CLI · Desktop · IDE~/.codex/config.toml
[mcp_servers.macroview]
url = "https://macro-view.com/mcp"
http_headers = { "Authorization" = "Bearer etfffs_sk_YOUR_KEY" }
opencodeopencode.json
{
  "mcp": {
    "macroview": {
      "type": "remote",
      "url": "https://macro-view.com/mcp",
      "headers": { "Authorization": "Bearer etfffs_sk_YOUR_KEY" }
    }
  }
}
pi · Cursor · other MCP clientsmcpServers config
{
  "mcpServers": {
    "macroview": {
      "type": "http",
      "url": "https://macro-view.com/mcp",
      "headers": { "Authorization": "Bearer etfffs_sk_YOUR_KEY" }
    }
  }
}
Web client MCP integration
Using claude.ai or Claude Desktop?
No config file needed — add it once as a custom connector and it’s available across claude.ai, the desktop app and mobile:
WhereSettings → Connectors → Add custom connectorURLhttps://macro-view.com/mcpHeaderAuthorization: Bearer etfffs_sk_YOUR_KEY
Keys are provisioned per user — only the MCP endpoint needs one; browsing the dashboard just needs a free account.
Using ChatGPT / the OpenAI API?
ChatGPT’s web connectors currently accept OAuth only — there is no field for a static bearer key — so MacroView can’t be added through the ChatGPT UI yet. From code, attach it to the OpenAI Responses API as an MCP tool instead (the key goes in authorization, without the “Bearer” prefix):
"tools": [{
  "type": "mcp",
  "server_label": "macroview",
  "server_url": "https://macro-view.com/mcp",
  "authorization": "etfffs_sk_YOUR_KEY",
  "require_approval": "never"
}]
What your agent gets

All 21 tools

A complete, read-only mirror of the live datasets behind the dashboard. Every tool returns structured JSON with an updatedAt and ttl so an agent knows how fresh the data is.

Freshness
60 min server cache (3 hours on weekends; the bond network every 12 hours).
Auth
Per-user bearer key (etfffs_sk_…) on POST /mcp. The dashboard’s REST API is session-gated; the sectors, Mag 7 and earnings-bubble teasers are the keyless exceptions.
Suggested flow
Start broad — get_market_heatmap, get_macro_snapshot — then drill down with get_stock_cards and lookup_ticker.
get_market_heatmap
Trailing returns (d1/w1/m1/m3/ytd/y1) plus a 22-session sparkline per symbol, by category: sectors, forex, energy, bonds, china, korea, cars, war, defensives.
get_stock_cards
Price, previous close, day and 52-week ranges, and average volume per stock, by group (mag7, energy_leaders).
get_volatility_regime
VIX / MOVE / SKEW levels with a 0–100 stress score, a regime label, and the VIX term structure.
get_price_alerts
Movers across the mag7 / semis / energy baskets: 52-week breakouts (within 1%) and ±3% daily moves, strongest first.
get_event_alerts
IPO and earnings heads-ups no more than 3 days out, soonest first — the near-term cut of the calendar.
get_macro_snapshot
Cross-asset return windows plus the FRED indicator strip: fed funds, 2s10s, CPI YoY, credit OAS and more.
get_bond_network
Sovereign Treasury holders with MoM/YoY changes, 10-year yields and debt/GDP; optional IMF CPIS cross-holding edges.
get_carry_unwind_risk
Yen carry-unwind gauge: 0–100 score with a label, CFTC yen positioning, USD/JPY momentum, the US–Japan 10-year gap and VIX, plus historical analogs and insights.
get_gold_drivers
Gold versus real yields and the dollar: rolling driver correlation and a fixed-beta "unexplained bid" residual (official-demand proxy), with caveated insights.
get_events_calendar
This month's IPO calendar (Nasdaq) plus large-cap (≥ $20B) earnings dates (Yahoo).
get_ipo_performance
Post-debut performance of IPOs priced in roughly the last 3 months: offer / first-close / latest price, pop-then-fade signals and market cap.
get_weekly_movers
Large caps whose 1-week move is at least ±6% at or above the cap floor (default $20B), sorted by the size of the move.
get_hot_stocks
Hot-stocks radar ranked by hotScore (volume, momentum, breakout and news heat components) plus the top-5 volume-share crowding aggregate.
get_risk_rotation
Today's risk-on/off divergence — Safe Havens vs Mag 7 vs Semis as 1-day-move lanes with medians, plus a havens-minus-growth tilt label. Derived from cached datasets.
get_earnings_bubble
2000 dot-com giants (static, verified) vs today's high-P/E cohort (live forward/trailing P/E), with the Nasdaq crash aggregate and a CAPE / concentration / rates backdrop — for valuation-bubble questions.
get_price_series
Raw daily closes as [unix, close] pairs per basket ticker, by set (bonds, capspread, forex, gold, rotation, china and more).
lookup_ticker
Ticker, name or ISIN to cross-exchange listings with local symbol, MIC and currency. Live OpenFIGI lookup, cached 90 days.
get_news_sources
Static directory of where to read news per sector (RSS and search URLs). Pointers only, no article text.
get_market_news
Pre-aggregated daily digest: top clustered headlines per sector, a topWeekly array, and per-company headlines for popular tickers. Headline metadata only, no article text.
get_earnings_recap
Last reported quarter for ~35 popular large caps — EPS actual vs consensus, surprise %, the post-report price reaction, and each name's next report date.
get_macro_picture
Composite "start here" brief — regime, popular stocks, cross-asset, rates & credit, rotation, stress gauges and news, with cross-dataset signals and web-search hints. depth = brief | full.
Ask your agent

Example prompts

“What macro factors are affecting semiconductor stocks today?”
“Give me a cross-asset macro snapshot — rates, credit and the volatility regime.”
“Which large caps moved more than 6% this week, and what's driving them?”
“Is a yen carry-unwind risk building right now?”
“How does today's high-P/E cohort compare to the 2000 dot-com peak?”
Questions

FAQ

What is the MacroView MCP server?

MacroView is a finance MCP server — 21 read-only tools that give any AI agent live market heatmaps, volatility and macro gauges, IPO and earnings calendars, a sovereign-debt network and a daily news digest, over the Model Context Protocol at macro-view.com/mcp.

Which AI agents and clients can connect?

Any MCP-capable client — Claude Code, Claude Desktop and claude.ai, OpenAI Codex, Cursor, opencode and pi — plus the OpenAI Responses API. Copy-paste configuration for each is on this page.

Do I need an API key?

Yes. The MCP endpoint requires an Authorization: Bearer key (etfffs_sk_…), provisioned per user. The REST API behind the dashboard is session-gated for signed-in browsing; only the sectors heatmap, Mag 7 and earnings-bubble teasers are keyless.

How fresh is the data?

Tools serve from a 60 min server cache (3 hours on weekends; the sovereign-debt network refreshes every 12 hours). Every payload carries updatedAt and ttl, so an agent knows exactly how stale the data is.

What markets does it cover?

Equities and ETFs, sectors, forex, energy, bonds and sovereign debt, gold, volatility (VIX, MOVE and SKEW), IPO and earnings calendars, and a clustered daily news digest.

Is MacroView free?

The MacroView dashboard is free to explore. Agent access over MCP uses a per-user API key — pick a plan in the app to provision one.