mrmarket.ai MCP server

A purpose-built analytical engine for financial research, exposed over MCP. Ask hard questions about US-listed equities in plain English and get structured, reproducible results back.

mrmarket.ai is a remote MCP server. Connect it to Claude, ChatGPT, or Gemini and your assistant gains a dedicated engine for resolving financial questions against clean, structured market data. It is not a language model with a database bolted on, and it is not an API wrapper. You describe the analysis; the engine computes it and returns rows, columns, and the assumptions it applied.

The interesting questions in equity research require joins that no single API endpoint will run for you. "Stocks where insiders bought over $1M, free cash flow grew four quarters running, and the price sits below the 200-day moving average" spans insider filings, quarterly cash flow statements, and daily prices at once. mrmarket.ai is built for exactly that class of question.

---

Why it is different

• Computed, not predicted. Answers are derived from the underlying data, not generated from a model's recollection. The same question returns the same answer every time.
• Cross-dataset by design. Fundamentals, prices, earnings, and insider activity are resolved together in a single question, with time dimensions aligned across differing data frequencies.
• Point-in-time aware. Historical and as-of questions respect the information available on the date in question, so backward-looking studies do not leak future data.
• Built to fail loud. When a question falls outside coverage, the engine returns an explicit error rather than fabricating a plausible number.
• Transparent. Every result carries the assumptions and defaults that were applied, so they can be inspected and adjusted.

---

Connect

mrmarket.ai is a remote MCP server reachable at:

https://mcp.mrmarket.ai/mcp

Each connection is tied to a free account so that credit balance and rate limits apply correctly. Authorization happens over OAuth on first use. Create an account and manage connections at mrmarket.ai/connect.

Claude Code

claude mcp add --transport http mrmarket https://mcp.mrmarket.ai/mcp

Claude Desktop

Open Settings, go to Connectors, choose Add custom connector, and paste the endpoint:

https://mcp.mrmarket.ai/mcp

Claude prompts for authorization on first use. Note that editing claude_desktop_config.json by hand does not work for this server; that file only accepts local, command-based servers, and mrmarket.ai is remote.

ChatGPT

In Settings, open Connectors, choose Add custom connector, and point it at the same endpoint.

Gemini

Add it as a remote MCP extension when prompted by Gemini's MCP onboarding, using the same endpoint.

---

Tools

Tool	Cost	Purpose
query_data	metered	The workhorse. A natural-language financial question in; structured rows and columns out. Screens, rankings, comparisons, time-series, cohort studies, and event studies are all single calls.
fetch_page	free	The continuation. When a query_data result is too large for one response, page 1 comes back with a pagination.next_cursor; pass that cursor to fetch_page to retrieve the rest. It runs no new query, so it never costs credits — the original query_data is charged once.
describe_data	free	The data catalog. Browse categories and fields, or search for a specific metric, before composing a question.
get_symbols	free	Fast ticker, sector, and industry resolution. Name to ticker, sector membership, or the full universe in under 50ms.
getting_started	free	A structured orientation tour with verified example prompts, grouped by use case.
recent_queries	free	Your recent queries, for context and re-runs.
get_account_status	free	Connected account, plan tier, credit balance, and rate limits. A useful first call in any new session.
report_issue	free	Flag a result that looks wrong or a feature that is missing. Pass the query_id from the response so the trace can be investigated.

Seven of the eight tools cost zero credits. Only query_data consumes credits, priced by query complexity. Start with getting_started or describe_data, then move to query_data.

---

What you can ask

Every prompt below resolves in a single query_data call. Phrase questions the way an analyst would speak them, not as a list of column filters.

Screens

Technology stocks with ROIC above 20%, debt-to-equity below 0.5, and 5-year revenue CAGR above 10%.
Healthcare companies with positive free cash flow and gross margin above 50%.
Companies with four consecutive quarters of growing free cash flow.

Rankings

Top 20 stocks by ROIC, excluding financials.
Top 15 companies by smoothness of year-over-year revenue growth over the last five fiscal years.
Bottom 10 consumer discretionary stocks by 1-year total return.

Comparisons

Compare AAPL, MSFT, and GOOGL on revenue and net income over the last five years.
AMZN versus WMT operating margin trend over the last decade.
NVDA quarterly EPS surprise history.

Cohort-relative analysis

Stocks whose ROIC is at least one standard deviation above their sector average.
Companies with a net profit margin more than twice their sector average.
Companies with revenue growth in the top quartile of their industry.

Time-series and overlays

AAPL daily closes for the last five years with earnings dates overlaid.
MSFT price with insider buy and sell markers over the past two years.
50-day and 200-day moving averages for TSLA.

Event studies

Average 30-day return after companies beat earnings by more than 10 percent.
Forward 3-month returns following insider purchases above $1M, grouped by sector.
Across the large-cap universe, the correlation between monthly insider purchase count and the next 3-month return.

Multi-step research, driven by your assistant

Larger studies decompose into several calls that your assistant orchestrates while mrmarket.ai supplies the ground truth at each step:

For every large-cap stock that gapped down 5 percent or more after earnings in the
past two years, what is the 30, 60, and 90-day recovery rate, and is it statistically
significant against random 90-day windows?

Backtest this signal: buy stocks with insider purchases above $500K within 30 days
before earnings that then beat EPS estimates, hold for 63 trading days, and report
CAGR, maximum drawdown, and win rate against buying every post-beat stock.

Build a pre-earnings watchlist: companies reporting in the next two weeks where
insiders bought in the last 90 days, the stock trades below its 200-day moving
average, and they beat estimates last quarter.

---

Coverage

Universe	11,000+ US-listed stocks and ETFs (NYSE, NASDAQ, AMEX)
History	20+ years of financials on US equities
Response time	Under 10 seconds for typical questions

Data spans daily adjusted prices, annual and quarterly financial statements (income statement, balance sheet, cash flow), earnings actuals against estimates, insider transactions, and valuation snapshots, alongside computed metrics such as ROIC, free cash flow, debt-to-equity, ROE, margins, returns, and earnings surprise. Sourced with point-in-time accuracy and curated for cross-dataset queries.

Scope

mrmarket.ai is a research and analysis layer, not a brokerage and not a real-time feed. Prices are end-of-day. The following are out of scope: intraday and tick data, options chains, news and transcript text, raw filing text, macro series, FX, crypto, bonds, and futures. When a question reaches an edge, the engine reports it rather than guessing.

---

Troubleshooting

Every query_data response carries a stable error_code, plus warnings and assumptions arrays that explain how the question was interpreted. Read those first; they usually point at the cause.

Symptom	What it means	What to do
QUERY_NOT_UNDERSTOOD	The question was ambiguous or referenced an unsupported metric.	Rephrase with specifics (period type, time range, ranking criterion). Use describe_data to confirm a field exists.
RATE_LIMITED	You hit your tier's per-minute or per-day cap.	Wait briefly, or check get_account_status for your exact limits.
INSUFFICIENT_CREDITS	Your credit balance is exhausted.	Top up or upgrade at mrmarket.ai. Not a fault, no retry needed.
SCHEMA_DRIFT	A data field is temporarily unavailable (mid-update).	Rephrase without the affected scope and try again.
INVALID_CURSOR / SNAPSHOT_EXPIRED	A fetch_page cursor was malformed or its result snapshot aged out (snapshots live ~15 minutes).	Re-run the original query_data question to get a fresh result and cursor.
BILLING_UNAVAILABLE / SERVICE_ERROR	A transient server-side issue.	Retry once; the retryable flag will be set.
Empty result on a screen	Filters were too tight.	Loosen one threshold (e.g. ROIC > 15% instead of 25%) or widen the time range.
A result looks wrong	An assumption or default may not match your intent.	Read the assumptions array. If it still looks wrong, file it with report_issue (include the query_id).

For a guided tour of capabilities, limits, and worked examples at any time, call the free getting_started tool.

Support

• Report a wrong result, bug, or feature request with the report_issue tool. Pass the query_id from the response so the exact run can be investigated. This is the fastest path because it links directly to the query trace.
• Email: support@mrmarket.ai

---

Links

• Product and sign-up: mrmarket.ai
• Connect your assistant: mrmarket.ai/connect
• Endpoint: https://mcp.mrmarket.ai/mcp