# Mr. Market Docs > Mr. Market is a read-only research MCP server for US public companies: SEC statements and filings, earnings call transcripts, 13F and insider ownership, ETFs, screens, industry boards, US macro and market data, with a source for every number. Server: https://mrmarket.fyi/mcp (Streamable HTTP, OAuth sign-in with a Mr. Market account). Every page link below is the page's Markdown; append `.md` to any docs URL for the same. ## Agent resources - [Mr. Market skill](https://docs.mrmarket.fyi/skills/mr-market/SKILL.md): which tool answers which question, identifiers, periods, paging, errors and rules. Install all skills with `npx skills add https://docs.mrmarket.fyi` - [All docs in one file](https://docs.mrmarket.fyi/llms-full.txt): every page below, concatenated - [Skills index](https://docs.mrmarket.fyi/.well-known/agent-skills/index.json): Agent Skills discovery - MCP server: `https://mrmarket.fyi/mcp` (Streamable HTTP; OAuth with a Mr. Market account). See [Quickstart](https://docs.mrmarket.fyi/quickstart.md) ## Get started - [Mr. Market for AI assistants](https://docs.mrmarket.fyi/index.md): 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. - [Quickstart](https://docs.mrmarket.fyi/quickstart.md): Connect your AI assistant to Mr. Market in three steps, then ask your first question. - [Access and invites](https://docs.mrmarket.fyi/access.md): Mr. Market is in private beta. How invites work, which account to use, and what each member gets. - [Limits and errors](https://docs.mrmarket.fyi/limits.md): How many calls you can make, how big answers can be, and what every error code means. ## Connect - [Claude (web and desktop)](https://docs.mrmarket.fyi/connect/claude.md): Add Mr. Market as a custom connector in claude.ai or the Claude desktop app. - [Claude Code](https://docs.mrmarket.fyi/connect/claude-code.md): Add Mr. Market to Claude Code with one command, sign in with /mcp, and run workflows as slash commands. - [ChatGPT](https://docs.mrmarket.fyi/connect/chatgpt.md): Add Mr. Market to ChatGPT as a developer-mode connector and turn it on in a chat. - [Codex](https://docs.mrmarket.fyi/connect/codex.md): Add Mr. Market to Codex (app, IDE extension and CLI) and sign in. - [Cursor](https://docs.mrmarket.fyi/connect/cursor.md): Add Mr. Market to Cursor with one click or in mcp.json. - [VS Code](https://docs.mrmarket.fyi/connect/vs-code.md): Add Mr. Market to GitHub Copilot in VS Code with one click or in mcp.json. - [Other apps](https://docs.mrmarket.fyi/connect/other.md): Connect Windsurf, Zed, Gemini CLI or any MCP client, and bridge apps that only run local servers. ## Use it well - [Best practices](https://docs.mrmarket.fyi/guides/best-practices.md): How to get precise, cited answers from Mr. Market, keep them readable, and stay within the limits. - [Example questions](https://docs.mrmarket.fyi/guides/example-questions.md): Questions that work well with Mr. Market, grouped by what you want to know. - [Skills](https://docs.mrmarket.fyi/skills.md): Ready-made research workflows that teach your assistant how to run an analyst task on Mr. Market, step by step, with cited output. ## Skills - [Company snapshot](https://docs.mrmarket.fyi/skills/company-snapshot.md): A one-page tear sheet on any saved company. - [Financials pull](https://docs.mrmarket.fyi/skills/financials-pull.md): Income, balance sheet and cash flow at any depth. - [Filing reader](https://docs.mrmarket.fyi/skills/filing-reader.md): Find a 10-K, 10-Q or 8-K and quote what it says. - [Earnings call review](https://docs.mrmarket.fyi/skills/earnings-call-review.md): What management said on the call, quoted. - [Earnings preview](https://docs.mrmarket.fyi/skills/earnings-preview.md): Everything to know before the next report. - [Comp set](https://docs.mrmarket.fyi/skills/comp-set.md): Side-by-side peers on size, growth, margins and quality. - [Quality scorecard](https://docs.mrmarket.fyi/skills/quality-scorecard.md): Growth & Quality scores explained metric by metric. - [Segments breakdown](https://docs.mrmarket.fyi/skills/segments-breakdown.md): Revenue and profit by segment, product and region. - [Valuation check](https://docs.mrmarket.fyi/skills/valuation-check.md): Multiples computed from the price and the filings, shown step by step. - [Ownership activity](https://docs.mrmarket.fyi/skills/ownership-activity.md): Who owns it, who is adding, and what insiders do. - [Investor portfolio](https://docs.mrmarket.fyi/skills/investor-portfolio.md): What a famous investor owns and how it changed. - [ETF look-through](https://docs.mrmarket.fyi/skills/etf-lookthrough.md): What's inside an ETF and how it changed. - [Stock screener](https://docs.mrmarket.fyi/skills/stock-screener.md): Filter the saved universe on growth, size and profit. - [Industry report](https://docs.mrmarket.fyi/skills/industry-report.md): A theme or industry ranked, with the peer valuation model. - [Macro dashboard](https://docs.mrmarket.fyi/skills/macro-dashboard.md): Rates, inflation, jobs and this week's calendar. ## Reference - [Tools reference](https://docs.mrmarket.fyi/reference/tools.md): Every Mr. Market MCP tool with what it answers, its arguments, defaults and an example call. - [Data and coverage](https://docs.mrmarket.fyi/reference/data.md): Where Mr. Market's data comes from, how fresh it is, and what isn't covered. - [Security and privacy](https://docs.mrmarket.fyi/reference/security.md): How assistants sign in, what they can reach, what is logged, and how to cut one off. - [Troubleshooting](https://docs.mrmarket.fyi/reference/troubleshooting.md): Fixes for sign-in, connection, limit and data problems. - [Changelog](https://docs.mrmarket.fyi/changelog.md): What changed in Mr. Market's MCP server and these docs.