Financial market data & macro insights for AI agents.

claude mcp add macroview --transport http https://macro-view.com/mcp
# then, inside Claude Code:
/mcp

codex mcp add macroview --url https://macro-view.com/mcp
codex mcp login macroview

{
  "mcpServers": {
    "macroview": { "url": "https://macro-view.com/mcp" }
  }
}

{
  "servers": {
    "macroview": { "type": "http", "url": "https://macro-view.com/mcp" }
  }
}

{
  "mcpServers": {
    "macroview": {
      "httpUrl": "https://macro-view.com/mcp",
      "authProviderType": "dynamic_discovery",
      "oauth": { "enabled": true }
    }
  }
}
# then, inside Gemini CLI:
/mcp auth macroview

{
  "mcp": {
    "macroview": {
      "type": "remote",
      "url": "https://macro-view.com/mcp",
      "headers": { "Authorization": "Bearer etfffs_sk_YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "macroview": {
      "type": "http",
      "url": "https://macro-view.com/mcp",
      "headers": { "Authorization": "Bearer etfffs_sk_YOUR_KEY" }
    }
  }
}

"tools": [{
  "type": "mcp",
  "server_label": "macroview",
  "server_url": "https://macro-view.com/mcp",
  "authorization": "etfffs_sk_YOUR_KEY",
  "require_approval": "never"
}]

What is the MacroView MCP server?

MacroView is a finance MCP server with 39 tools. They give any AI agent live market heatmaps, volatility and macro gauges, a market-event calendar spanning IPOs, earnings, FOMC/CPI/jobs releases, options expiry, index rebalances and dividends, post-earnings reaction history, an earnings wire of just-filed SEC 8-Ks, a 52-week-low screener, per-ticker support and resistance levels with the touch history behind every line, the 50/100/200-day moving-average configuration of the major US and European indexes against their region's corporate-profit trend, an institutional flow screen, a disclosure wire of 13D/13G activist stakes and Form 4 insider buying with the UK short register beside it, futures positioning, a sovereign-debt network, an AI build-out financing map that reads the hyperscalers' capex funding mix out of SEC filings and sets it against credit spreads, a cash-and-gold capital-parking picker and a daily news digest, over the Model Context Protocol at macro-view.com/mcp. The market data is read-only; five further tools let an agent run your paper-trading account.

Can an AI agent place trades?

Only simulated ones. On the Analyst plan and up, an agent can read your investment simulator, open one, place buy and sell orders with an optional stop loss and take profit, and reset the account — a fictional 100,000 EUR or USD account, filled at MacroView's cached quotes. No order ever reaches a broker and no real money is involved. It is the same account the dashboard shows, so an agent's trades appear there too, and the tools are marked as writes so your client can ask you before running them.

How do stop-loss and take-profit work in the simulator?

You attach them to a position, from the dashboard or through an agent, as prices in the instrument's own currency. They are settled when the account is read rather than watched tick by tick: each read scans the daily closes since your last fill, and the first close through a level closes the whole position at that close's price and date. Intraday spikes, and a level crossed and recovered between two closes, are missed by design — the whole simulator runs on cached prices, so a bracket is a realistic stop, not a resting order on an exchange.

Does the simulator model leverage on FX?

Yes. FX pairs trade on 1:30 margin, the retail default, so 3.33% of the position is posted as cash and the profit and loss runs on the whole notional — which is what makes a 0.5% currency move visible in a 100,000 account. Stocks, ETFs and indices are unlevered. A levered position that loses more than the margin behind it is closed automatically, and every position reports its margin, notional and return on the cash committed.

Which AI agents and clients can connect?

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

Do I need an API key?

Not for most clients. Claude Code, Claude Desktop, claude.ai, OpenAI Codex, Cursor, VS Code and Gemini CLI all speak the MCP OAuth 2.1 flow: point them at the endpoint, approve the sign-in in your browser once, and they refresh their own token from then on — nothing to paste, nothing to rotate. A per-user API key (etfffs_sk_…) is still available for callers that have no browser, such as the OpenAI Responses API, the Anthropic MCP connector and CI, and for direct REST calls. Either way the request needs an active plan. 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, the 52-week-low screen, the moving-average trend read and futures positioning refresh every 12 hours, the 13F holdings diffs every 6; the 13D/13G and Form 4 disclosure feeds every 30 minutes, the UK short register once each working day; the earnings wire is fed within minutes of an earnings 8-K landing on SEC EDGAR). 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 — including money-market and short-bill funds and physical gold ETCs with their fees, venues and availability — the AI-infrastructure complex on three sides (the semiconductor chain; the cloud hyperscalers, neocloud GPU providers and data-center operators that host the compute; and how the build-out is financed — the vendor-financing circle, capex versus operating cash flow straight from SEC filings, and the credit spreads behind it), volatility (VIX, MOVE and SKEW), a market-event calendar (IPOs, large-cap earnings, FOMC/CPI/jobs release dates, options expiry and quad witching, index rebalance schedules, ex-dividends and IPO lockup expiries) with post-earnings reaction history, an earnings wire of just-filed 8-Ks, a 52-week-low screener across $20B+ large caps, per-ticker support and resistance levels over windows from six months to five years, the 50/100/200-day moving-average configuration of the S&P 500, Nasdaq 100, STOXX Europe 600 and EURO STOXX 50 read against US after-tax corporate profits and euro-area gross operating surplus, quarterly 13F holdings diffs, SEC Schedule 13D/13G activist stakes and Form 4 insider purchases as they are filed, the FCA's aggregated UK short register, CFTC futures positioning, and a clustered daily news digest.

Is MacroView free?

The MacroView dashboard is free to explore. Agent access over MCP needs a paid plan, whether the client signs in through the browser or sends an API key — pick a plan in the app and the connection works immediately.