Search / ai.tickerscout/ticker-scout
protogridR0· no sign-inAgent-native SEC data, 20 tools: statements assembled, any line item, filings synthesized. No key.
v3.0.1 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"ticker-scout": {
"type": "http",
"url": "https://mcp.tickerscout.ai/mcp"
}
}
}claude mcp add --transport http ticker-scout https://mcp.tickerscout.ai/mcp[mcp_servers.ticker-scout]
url = "https://mcp.tickerscout.ai/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ticker-scout": {
"type": "remote",
"url": "https://mcp.tickerscout.ai/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"ticker-scout": {
"type": "http",
"url": "https://mcp.tickerscout.ai/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=ticker-scout&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLnRpY2tlcnNjb3V0LmFpL21jcCJ9"
}{
"servers": {
"ticker-scout": {
"type": "http",
"url": "https://mcp.tickerscout.ai/mcp"
}
}
}{
"mcpServers": {
"ticker-scout": {
"httpUrl": "https://mcp.tickerscout.ai/mcp"
}
}
}extensions:
"ticker-scout":
enabled: true
name: "ticker-scout"
type: streamable_http
uri: "https://mcp.tickerscout.ai/mcp"
timeout: 300
protocol.modernsupports 2026-07-28 (server/discover)protocol.statelessanswers without a sessionprotocol.transportstreamable HTTPprotocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every useauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_length4 tools have descriptions over 1,024 characters, which crowds the contexttools.schemasevery tool has an object input schematools.annotations20 of 20 tools declare readOnlyHint or destructiveHinttools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHinttools.token_costabout 7,578 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes199 tool changes in 30 daysstability.rug_pull2 tools kept their name but changed most of their description in 30 days; review before trusting themdeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageget_restructuring_eventsremovedRestructuring plans, workforce reductions, exit costs and impairments announced in current reports (Item 2.05 and related), with the charges and timing stated, each dated and cited by accession. Returns matching sections of the events digest in full, then individual items from other sections that mention the topic, each labeled with where it came from. If there are none, the response says so and lists the digest's sections. Pass `record` for the digest as of an earlier record.
get_governance_eventsremovedAnnual meeting results and shareholder votes (Item 5.07), bylaw and charter amendments, and other governance actions reported in current reports, each dated and cited by accession. Returns matching sections of the events digest in full, then individual items from other sections that mention the topic, each labeled with where it came from. If there are none, the response says so and lists the digest's sections. Pass `record` for the digest as of an earlier record.
get_debt_and_financing_eventsremovedDebt offerings, notes issued and their coupons and maturities, credit facilities and revolvers entered or amended, term loans, commercial paper programs and other financing actions from current reports (Items 1.01 and 2.03 and exhibits), each dated and cited by accession. Returns matching sections of the events digest in full, then individual items from other sections that mention the topic, each labeled with where it came from. If there are none, the response says so and lists the digest's sections. Pass `record` for the digest as of an earlier record.
get_legal_proceedingsremovedLitigation, government investigations, antitrust and regulatory matters: every legal or regulatory section, subsection or passage in the 10-K/10-Q narrative (Item 3 and the contingencies note, as condensed), followed by any legal or regulatory items in the 8-K events digest. Each passage says where in the document it came from. Returns the section's full text as markdown. Headings differ by company and carry the fiscal period, so the section is found by pattern; if this company's narrative has none, the response says so and lists its sections. Pass `record` for the narrative as of an earlier record.
get_subsequent_eventsremovedMaterial developments after the latest period end: what the company disclosed after the balance-sheet date in its latest report and in current reports since (acquisitions, financings, dividends, litigation outcomes, leadership changes), each dated and sourced by accession. Returns the section's full text as markdown. Headings differ by company and carry the fiscal period, so the section is found by pattern; if this company's narrative has none, the response says so and lists its sections. Pass `record` for the narrative as of an earlier record.
get_risk_factorsremovedThe company's risk factors, condensed from Item 1A of its annual report and updated from its latest quarterly report, grouped by theme (demand, supply chain, competition, regulation, legal, financial, macro, cybersecurity), with risks that are new, expanded or removed since the prior filing flagged. Read from the filings, not from news. Returns the section's full text as markdown. Headings differ by company and carry the fiscal period, so the section is found by pattern; if this company's narrative has none, the response says so and lists its sections. Pass `record` for the narrative as of an earlier record.
get_coverage_summaryremovedWhat Ticker Scout covers as a whole: how many companies, when the data was last updated, how many hold each latest form (10-Q, 10-K, 6-K, 20-F), which are foreign issuers, how many published records each company has and the earliest record held, the URL patterns for every file, and what is deliberately not covered (no market prices, no estimates, no analyst data).
get_next_filingremovedWhen a company is expected to file next with the SEC, and what: the predicted date and form (10-Q or 10-K; 6-K or 20-F for a foreign issuer), alongside the latest period held, when that filing was made, and the filing dates of the reports the record is built from. The date is a prediction from the company's own filing history, not an announced date, and a filing date is not an earnings date: most companies release earnings on an 8-K days or weeks before the 10-Q or 10-K is filed.
get_stock_splitsremovedStock splits a company's record has adjusted for: every split applied (ratio and date), which figures were restated for it, and any as-reported pre-split values the record keeps alongside. Per-share figures and share counts Ticker Scout publishes are split-adjusted, so periods before and after a split compare directly. Also returns the record's notes that mention a split.
get_accession_numbersremovedEvery SEC accession number a company's record cites, across the financial statements, the 10-K/10-Q narrative and the 8-K events digest, newest first. For each: the form (10-K, 10-Q, 8-K, 20-F, 6-K, DEF 14A...), the filing date where stated, the EDGAR filing index URL, the document URL where known, and every use - which periods' figures came from it, which narrative or events sections cite it. An accession number (0001045810-26-000075 = filer CIK 0001045810, year 2026, sequence 75) is the SEC's permanent ID for one filing, the thing to cite. Use get_filing for everything about one of them.
Showing the latest 10. Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +dns-namespace +website +reachable +uptime-94% +updated-7d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://mcp.tickerscout.ai/mcp streamable-http | none | yes | 94% | 378 ms | 2026-07-28 | 2026-10-19 |
compare_companiesread-only | One standard figure for two to ten companies side by side: revenue, net income, EPS, operating income, free cash flow, debt, cash, equity or any other standard figure listed in get_figure. Defaults to each company's latest discrete period (its latest quarter, or its latest fiscal year if that is newer); pass period='latest annual', 'ttm', 'latest quarter' or a fiscal year. Fiscal calendars differ between companies, so each row states its own period and dates, and the field it was read from; a company that does not report the figure, or the period, gets a row saying so rather than failing the call. All money is in actual dollars (not thousands, not millions), per-share figures in dollars per share (per ADS for a foreign issuer that has one), share counts in actual shares, split-adjusted. A foreign issuer's figures are converted to US dollars at the rate recorded on each period. |
get_companyread-only | Company identity and coverage manifest: name, CIK, exchange, state of incorporation, SIC industry, the fiscal period of the latest data, the SEC filings that record is built from (the annual report and the latest quarterly report, each with its own fiscal year, filing date, accession number and EDGAR link), every published record with its permanent URLs, and the predicted next filing date and form (a prediction from filing history; a filing date is not an earnings date). Pass `record` for an earlier record's manifest. |
get_company_metricsread-only | Measures a company reports outside its GAAP statements, as it defines them: `operating` KPIs (users, subscribers, paid memberships, bookings, stores, RevPAR, deliveries, backlog, remaining performance obligations), `non_gaap` measures (adjusted EPS, adjusted operating income, EBITDA, FFO for a REIT, core earnings, with the reconciling figures held), `bank` metrics (CET1 and other capital ratios, net interest margin, efficiency ratio, average balances and yields, credit quality) and `insurance` metrics (premiums, underwriting results, combined and loss ratios, investment income, float, book value). Default: every kind this company reports. These are the company's own definitions from its filings or earnings release. Every period in the latest record by default, or the periods named by `period`. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. |
get_data_notesread-only | The record's explanation of itself, to read before relying on an unusual figure or concluding one is missing: its sourcing notes (how the statement template was chosen, which filing each statement was read from, how a discrete quarter was derived, what was reclassified or restated), period-level notes on coverage, its list of uncertainties (figures the filings do not disclose, periods presented only year to date, items that could not be reconciled), and which standard figures are absent from the latest fiscal year and quarter. Where a filing does not disclose a figure it is omitted and the omission explained, never zeroed. |
get_eventsread-only | Digest of a company's material current reports (Form 8-K; 6-K for a foreign issuer) over roughly the trailing five quarters, read from the filings and their exhibits: earnings releases and guidance, management and board changes, dividends and buybacks announced, debt offerings and credit facilities, mergers and acquisitions, shareholder votes, restructuring and legal matters, each dated and citing its SEC accession number. Returns the full digest by default; it is short. Pass `section` as a heading or a topic (earnings, management changes, capital returns, debt and financing, m&a, governance, restructuring, legal) to narrow it, or index=true for a one-line, dated index of every item. Pass `record` for the digest as of an earlier record. |
get_figureread-only | Get any figure for a company: revenue, net income, EPS, free cash flow, debt, a segment's revenue, a bank's CET1 ratio, a KPI. Pass a standard name or synonym and it returns the field this company uses for it, named; pass a field name or path from the record and it returns exactly that field; otherwise fields whose names contain all the words. Case, spaces and underscores do not matter. Standard figures: revenue, cost_of_revenue, gross_profit, gross_margin_pct, research_and_development, sga, operating_expenses, operating_income, interest_expense, net_interest_income, noninterest_income, provision_for_credit_losses, pretax_income, income_tax, effective_tax_rate, net_income, diluted_eps, basic_eps, diluted_shares, basic_shares, depreciation_and_amortization, cash, total_assets, total_liabilities, total_debt, long_term_debt, short_term_debt, shareholders_equity, current_assets, current_liabilities, goodwill, intangible_assets, inventories, accounts_receivable, accounts_payable, property_and_equipment, retained_earnings, shares_outstanding, operating_cash_flow, capital_expenditures, free_cash_flow, investing_cash_flow, financing_cash_flow, dividends_paid, dividends_per_share, share_repurchases, stock_based_compensation, acquisitions. Every value leads with its name_in_record and json_path, so what is returned is never relabeled, and carries its dates, form and accession. Every value carries the SEC accession number of the filing it came from and, where the filing tags the number, a sec.gov link that opens the filing at the line printing it. Default: every period in the latest record. `period` narrows to a fiscal year, quarter, 'ttm', 'ytd' or 'latest', searching older records; period='all' returns the full history held, oldest first, as annual and quarterly series (the newer record's value wins where two hold the same period, because it carries any restatement). All money is in actual dollars (not thousands, not millions), per-share figures in dollars per share (per ADS for a foreign issuer that has one), share counts in actual shares, split-adjusted. A foreign issuer's figures are converted to US dollars at the rate recorded on each period. When nothing matches, the error names the closest fields; list_company_figures lists every field by name. |
get_filingsread-only | The SEC filings behind a company's data. Without `accession`: every accession number the record cites across the financial statements, the 10-K/10-Q narrative and the 8-K events digest, newest first, each with its form (10-K, 10-Q, 8-K, 20-F, 6-K, DEF 14A...), filing date where stated, EDGAR index URL, document URL where known and every use (which periods' figures came from it, which narrative or events sections cite it); plus the annual and quarterly report the record is built from. With `accession` (dashes optional): everything about that one filing, including the full text of every narrative and events passage that cites it, e.g. what an 8-K announced; every published record is searched unless `record` is given. An accession number (0001045810-26-000075 = filer CIK 0001045810, year 2026, sequence 75) is the SEC's permanent ID for a filing, the thing to cite. For the sec.gov line behind one figure, use get_figure. |
get_financialsread-only | Income statement, balance sheet and cash flow, already assembled from a company's SEC filings, for up to three fiscal years plus the latest quarter, year to date and trailing twelve months, with segment tables, per-share figures and the record's own notes. This is the published financials.json, whole or by top-level section. Already assembled: no XBRL concept selection, no deriving a discrete quarter from year-to-date columns, no scale factor to infer. Section names differ per company, so call with no sections first (or read available_sections) and then request only what you need. Request the figure_sources section by name for a sec.gov link to the line of the filing that prints each figure; a whole-file call leaves it out. All money is in actual dollars (not thousands, not millions), per-share figures in dollars per share (per ADS for a foreign issuer that has one), share counts in actual shares, split-adjusted. A foreign issuer's figures are converted to US dollars at the rate recorded on each period. For one statement or one period, searching older records too, use get_statements; for one figure, get_figure. |
get_key_figuresread-only | The headline for a company's most recent reported period: revenue, net income, diluted EPS and similar, each with its exact dollar amount, prior-year value, year-over-year change, the record field it was read from and its SEC accession number; plus a one-paragraph written summary and question-and-answer pairs built from those figures. Start here for any 'how did X do' or 'how much did X earn' question. Far smaller than get_financials. Pass `record` for an earlier record's headline. For any other figure, or a figure across periods, use get_figure. |
get_margins_and_ratiosread-only | Profitability margins and balance-sheet ratios for every period: every margin and rate the record itself stores (gross margin %, operating margin %, effective tax rate, segment margins, efficiency ratio and the like), plus gross, operating, net and free-cash-flow margin, working capital and current ratio calculated here from the period's own figures, each labeled as calculated with its formula and the exact fields used, so it can be checked. A ratio is calculated only when both figures are in the same period of the same record; nothing is estimated. Every period in the latest record by default, or the periods named by `period`. |
get_narrativeread-only | Qualitative synthesis of a company's latest annual and quarterly reports, condensed from the filings themselves rather than from news: business description, risk factors with changes since the prior filing flagged, annual MD&A, the current quarter, legal proceedings and subsequent events. Called without `section` it returns an INDEX: every section with its size, first sentence and subsection headings, because the full document is large. Then pass `section` as a heading or subsection heading from the index, or as a topic (business, risk factors, md&a, current quarter, subsequent events, legal), which finds the matching sections whatever this company calls them ('legal' also pulls legal items from the 8-K digest), or 'all' for everything. Pass `record` for the narrative as of an earlier record. To find a keyword anywhere, use search_text. |
get_reporting_conventionsread-only | How to read a company's numbers before comparing or converting them: the units statement (actual dollars, not millions), reporting currency and, for a foreign issuer such as TSMC, the conversion policy and each period's exact exchange rate with its source (average rate for income and cash flow, closing rate for the balance sheet, stated as foreign currency per US dollar); the ADR ratio and per-share basis (per ADS for a foreign issuer that has one); stock splits adjusted for and any as-reported pre-split values; the fiscal year end and convention; the business type and statement template; the accounting basis (US GAAP, IFRS); and any definitions the record gives for its own line items and segments. All money is in actual dollars (not thousands, not millions), per-share figures in dollars per share (per ADS for a foreign issuer that has one), share counts in actual shares, split-adjusted. A foreign issuer's figures are converted to US dollars at the rate recorded on each period. Every period's dates are in list_periods. |
get_segmentsread-only | How a company's results split, exactly as it reports them: `segments` (reportable segment revenue, operating income or profit, and whatever else it discloses per segment: assets, capex, managed-basis results for a bank, business-unit earnings for a conglomerate), `revenue_by_product` (revenue by product, service, end market, platform, channel or customer type, e.g. NVIDIA's Data Center, Apple's iPhone and Services), and `revenue_by_geography` (by country or region, with long-lived assets by geography where held). Default: all three. Table names differ by company and are returned as the record names them. Every period in the latest record by default, or the periods named by `period`. Actual dollars (not millions), shares split-adjusted, a foreign issuer's figures in US dollars. If the company reports none, the response says so and lists the tables it does have. |
get_statementsread-only | The income statement, balance sheet or cash flow statement, as the company reports it with line items in reported order, for any fiscal year, quarter, year to date or trailing twelve months. `statement` picks one (default: every statement and table held for the period, including segments and industry metrics). `period` picks the periods (default: every period in the latest record: up to three fiscal years, the latest quarter and its prior-year comparative, year to date, trailing twelve months) and searches older records when the latest does not hold it; 'ttm' and 'ytd' return those blocks with their derivation notes. A period earlier than the data held returns that the data does not go back that far, and what is held. Each period carries its dates, source form and accession. All money is in actual dollars (not thousands, not millions), per-share figures in dollars per share (per ADS for a foreign issuer that has one), share counts in actual shares, split-adjusted. A foreign issuer's figures are converted to US dollars at the rate recorded on each period. include_sources=true adds the sec.gov link for every figure the filing tags. |
guideread-only | Start here if unsure. How Ticker Scout's tools fit together: what a record is versus a period, the period syntax every period argument accepts, units and currency, how figures are cited and linked to sec.gov, which tool answers common questions, and the standard figures (with the words get_figure and compare_companies accept for each). No arguments. |
list_companiesread-only | The public companies Ticker Scout covers, with the fiscal period of each one's latest data, every published record held and the predicted date of its next SEC filing, plus a coverage summary (company count, last update, filers by latest form, foreign issuers). Call this first when you do not know whether a company is covered, or to turn a company name into a ticker. Coverage is S&P 500 companies plus major foreign issuers that file with the SEC. |
list_company_figuresread-only | Discover which figures a company's record holds and what it calls them. Without `query`: standard_figures maps each standard figure (revenue, net income, EPS, cash, debt and the rest) to the name THIS company's record gives it (Apple's revenue is total_net_sales, JPMorgan's is total_net_revenue), and other_figures holds every remaining figure grouped by its statement or table (segments, revenue_by_* breakdowns, key metrics, bank and insurance tables, non-GAAP measures), keyed by path, with its values. With `query`: only the fields whose names contain every word ('data center', 'cet1', 'comparable sales', 'backlog', 'subscribers'), plus the standard figure the words name, if any. Every name and path returned can be passed to get_figure exactly as written. `block` limits to one table. A listing defaults to the latest fiscal year and latest quarter, a search to every period in the latest record; pass `period` for others. |
list_periodsread-only | How far back the data goes for one company: every fiscal year and every quarter Ticker Scout holds, across every published record, with each period's start and end dates, length in days, source form and accession, and which records carry it; the year-to-date and trailing-twelve-months blocks; the fiscal year end and whether the company runs 52/53-week years; and the list of published records (each the snapshot built when one 10-Q or 10-K was filed, with its permanent URLs). Fiscal years are the company's own: NVIDIA's FY2027 ends in January 2027, Apple's FY2026 in September 2026. |
list_upcoming_filingsread-only | Every covered company expected to file a 10-Q or 10-K (or 6-K / 20-F) within the next N days, soonest first, with the predicted date and form and the period currently held. Use it to see whose data refreshes soon. Dates are predictions from each company's filing history, not announced dates, and a filing date is not an earnings date: most companies release earnings on an 8-K days or weeks before the 10-Q or 10-K. One company's next filing is in get_company. |
search_textread-only | Find what a company's filings say about a keyword. Searches the 10-K/10-Q narrative, the 8-K events digest and the financial record's sourcing notes, and returns the paragraphs and list items that contain every word of the query, best first, each in full with its section and subsection, plus a ranked list of the sections that mention it most (to read one whole with get_narrative or get_events). Case-insensitive; double quotes match an exact phrase. Examples: 'buyback authorization', '"remaining performance obligations"', 'China export', 'credit facility', 'goodwill impairment', 'CEO'. |
Schemas: list_tools.
{
"name": "ai.tickerscout/ticker-scout",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://mcp.tickerscout.ai/mcp",
"type": "streamable-http"
}
],
"version": "3.0.1",
"repository": {
"url": "https://github.com/tickerscout/tickerscout-mcp",
"source": "github"
},
"websiteUrl": "https://tickerscout.ai/mcp/",
"description": "Agent-native SEC data, 20 tools: statements assembled, any line item, filings synthesized. No key."
}