Analytical engine for US-listed equities: screens, rankings, and event studies in plain English.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
π‘ Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Inspect callable tools, capabilities, and parameters exposed to AI agents by Mrmarket.ai.
query_dataThe 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_pageThe 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_dataThe data catalog. Browse categories and fields, or search for a specific metric, before composing a question.
get_symbolsFast ticker, sector, and industry resolution. Name to ticker, sector membership, or the full universe in under 50ms.
getting_startedA structured orientation tour with verified example prompts, grouped by use case.
recent_queriesYour recent queries, for context and re-runs.
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.
mrmarket.ai is a remote MCP server reachable at:
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.
Open Settings, go to Connectors, choose Add custom connector, and paste the endpoint:
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.
In Settings, open Connectors, choose Add custom connector, and point it at the same endpoint.
Add it as a remote MCP extension when prompted by Gemini's MCP onboarding, using the same endpoint.
| 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.
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.
Larger studies decompose into several calls that your assistant orchestrates while mrmarket.ai supplies the ground truth at each step:
| 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.
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.
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.
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.https://mcp.mrmarket.ai/mcpShowcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/mrmarket-ai)<a href="https://allmcps.com/mcp/mrmarket-ai"><img src="https://allmcps.com/api/badge/mrmarket-ai?style=directory" alt="Mrmarket.ai on AllMCPs" /></a>