> Mr. Market docs. Source: https://docs.mrmarket.fyi/. Every page is listed in https://docs.mrmarket.fyi/llms.txt; append `.md` to any docs URL for its Markdown.

# Mr. Market for AI assistants

Connect Claude, ChatGPT, Codex or any MCP app to Mr. Market and ask about any US public company. Answers come from SEC filings and market data, with a source for every number.

Mr. Market is a research site for US public companies. Its **MCP server** lets your AI assistant use the same
research directly: financial statements, filings, earnings calls, institutional and insider ownership, ETFs, a
screener, industry boards, US macro data and market prices. The assistant reads it live and cites where each number
came from.

- [Quickstart](https://docs.mrmarket.fyi/quickstart.md): Connect in three steps. No keys to copy.
- [Connect your app](https://docs.mrmarket.fyi/connect/claude.md): Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code and more.
- [Skills](https://docs.mrmarket.fyi/skills.md): 15 ready-made research workflows that come with the server.
- [Tools reference](https://docs.mrmarket.fyi/reference/tools.md): Every tool, every argument, with examples.

## At a glance

| | |
| --- | --- |
| Server address | `https://mrmarket.fyi/mcp` |
| Transport | Streamable HTTP |
| Sign-in | OAuth with your Mr. Market account (no API keys) |
| Access | Mr. Market members ([private beta](https://docs.mrmarket.fyi/access.md)) |
| Tools | 25, all read-only |
| Workflows | 15 prompts and installable skills |
| Cost | Free during the beta |

## What you can ask

```text
Using mr-market, how have Apple's revenue and net income changed over the last four years? Cite the filings.
```

```text
Using mr-market, what did management say about margins on Costco's latest earnings call?
```

```text
Using mr-market, which Super Investors hold Alphabet, and who added last quarter?
```

```text
Using mr-market, screen for companies with revenue growth over 30% and positive operating cash flow.
```

More in [example questions](https://docs.mrmarket.fyi/guides/example-questions.md).

## What's covered

- **Statements and ratios** from SEC XBRL filings: annual, quarterly and trailing twelve months, up to 12 periods.
- **Filings**: every 10-K, 10-Q, 8-K and proxy, read in pages, plus full-text search of EDGAR since 2001.
- **Earnings calls**: saved transcripts, speaker by speaker, searchable across companies.
- **Ownership**: 13F institutional holders, 87 Super Investors, insider trades (Form 4) and ETF holdings (N-PORT).
- **Screens and industries**: a screener on the latest quarter, SEC industry peers, curated theme boards.
- **Markets and macro**: quotes, price history, news, price targets, analyst estimates, earnings dates, FRED and
  Treasury series, and the economic calendar.

Details and sources: [data and coverage](https://docs.mrmarket.fyi/reference/data.md).

## How it works

1. You add `https://mrmarket.fyi/mcp` to your assistant.
2. Your assistant opens Mr. Market's sign-in. You sign in and choose **Allow**.
3. The assistant gets its own read-only access. It calls Mr. Market's tools while it answers you, and every result
   carries its period, filing and source link.

Nothing you connect can change your account or any data. You can disconnect any assistant in
[Account](https://mrmarket.fyi/account) at any time.

> **Research, not advice.** Mr. Market reports what companies filed and what data providers publish. It does not
> recommend buying or selling anything.