For AI agents

# Finance MCP server

Give Claude, Cursor or Codex Gloom's research tools: quotes, filings, options flow, insider and congress trades, macro and news. One command connects it; tool calls need Gloom Pro.

- Connect your agent
- [Gloom Pro plans](https://gloom.sh/cloud#pricing)

Checked 17 October 2026

## Connect

**Claude Code**

```
claude mcp add --transport http gloom https://api.gloom.sh/mcp
```

The first call opens a browser tab where you choose what Claude Code may reach. claude.ai signs in the same way.

**Cursor**

```
{
  "mcpServers": {
    "gloom": {
      "url": "https://api.gloom.sh/mcp",
      "headers": { "Authorization": "Bearer gloom_mcp_..." }
    }
  }
}
```

Or give Cursor only `https://api.gloom.sh/mcp` and sign in through the browser, no key.

**Codex**

```
export GLOOM_MCP_KEY=gloom_mcp_...
codex mcp add gloom --url https://api.gloom.sh/mcp --bearer-token-env-var GLOOM_MCP_KEY
```

Create the key in [Cloud settings, Agents](https://gloom.sh/cloud/account?view=agents). Keys are shown once.

Listed in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers/io.github.gloom-sh%2Fgloom/versions/latest) and on [Smithery](https://smithery.ai/servers/gloom/gloom).

## What your agent can reach

| Tools | For example |
| --- | --- |
| Prices and options | market.quotes, market.options_flow |
| Companies | company.statements, equity.diagnostic |
| Filings, insiders, 13F, Congress | sec.insider_transactions, congress.house_trades |
| Macro and news | macro.yield_curve, news.stories |
| Catalysts and credit | market.catalysts, credit.screen |
| KPIs, awards and hiring | company.kpis, company.hiring |
| GPUs, perps, supply chain, power | gpu.history, company.supply_chain_graph |
| Your notes, teams and brokers | notes.save, portfolio.positions |

- **Every tool, by group (70 tools)**

  Market: market.search, market.quotes, market.history, market.screener, market.options_chain, market.short_interest, market.options_flow

  Company: company.profile, company.financials, company.holders, company.analyst_research, company.corporate_actions, company.statements, equity.diagnostic

  Filings and ownership: sec.filings, sec.insider_transactions, sec.thirteenf_holders, sec.thirteenf_crowding, congress.house_trades, congress.senate_trades

  Macro and news: macro.calendar, macro.yield_curve, macro.series, news.stories, social.ticker_posts, social.search_posts

  Events and credit: market.catalysts, company.litigation, catalysts.event, catalysts.changes, credit.documents, credit.instrument, credit.screen

  Company data: company.kpis, company.guidance, company.awards, company.award_evidence, company.hiring, market.hiring_movers, hiring.momentum, apps.attention, apps.rank_history

  Markets and compute: market.attention, perps.board, perps.compare, perps.history, perps.rankings, gpu.board, gpu.history, gpu.changes

  Supply chain and power: company.supply_chain_graph, company.supply_chain_paths, company.supply_chain_evidence, power.board, power.history, power.summary, power.project, power.coverage

  Notes and teams: teams.list, notes.list, notes.get, notes.save, collections.list, collections.get, collections.add_symbol, collections.remove_symbol

  Portfolio: portfolio.accounts, portfolio.positions, portfolio.performance, portfolio.exposure

  Arguments, Terminal control and the broker tools are in the [MCP reference](https://gloom.sh/docs/mcp#tools).

## Ask it

1. List the largest SPY options prints of the last three days. market.options_flow
2. Compare NVDA's insider sales with its largest 13F holders. sec.insider_transactions, sec.thirteenf_holders
3. Sum up this week's macro calendar and the yield curve. macro.calendar, macro.yield_curve

## Which plan

Creating a key needs Gloom Pro, $70 a month after a 7-day trial. Tool calls need Pro too, except the `portfolio.*` tools.

For a fund or desk, [Gloom Team](https://gloom.sh/firms) gives every seat Pro, MCP and the REST API.

- [Try the data in your browser first, no account](https://term.gloom.sh/?ticker=NVDA)
- [Plans: Free, Pro and Team](https://gloom.sh/cloud#pricing)

- **Limits (5 items)**

  - 120 requests a minute and 5,000 a day per key. Over that, 429 with Retry-After.
  - Results are capped at 256 KB and carry status, rowCount, truncated and asOf.
  - Up to 10 keys, each shown once. Access is fixed when you create it.
  - Access levels: Market data, Read, Read and write. Terminal control can be added to any of them.
  - If Pro lapses, keys stay but tool calls are refused.
- **Sources (3 sources)**

  - [MCP server reference](https://gloom.sh/docs/mcp) updated 9 October 2026: connect commands, tools, plans and limits
  - [Official MCP Registry, io.github.gloom-sh/gloom](https://registry.modelcontextprotocol.io/v0/servers/io.github.gloom-sh%2Fgloom/versions/latest) read 17 October 2026
  - [Smithery, gloom/gloom](https://smithery.ai/servers/gloom/gloom) read 17 October 2026

## Related

- [MCP server reference](https://gloom.sh/docs/mcp)
- [REST API: the same key over HTTP](https://gloom.sh/docs/rest-api)
- [Bloomberg API alternative](https://gloom.sh/answers/bloomberg-api-alternative)