StockTools in your AI assistant
Ask your assistant about a company’s SEC filings, its insiders’ open-market trades, its next earnings date, this month’s US economic releases or the Treasury curve, and get answers that carry their sources and dates, with a link back to the page here that shows the same thing. It is a Model Context Protocol (MCP) server: free, no account, no key. Sign in and the same connector also manages your own watchlist and alerts.
Connect
In any assistant that supports remote MCP servers, add a custom connector with this address:
https://stocktools.ai/api/mcp
Claude Code:
claude mcp add --transport http stocktools https://stocktools.ai/api/mcp
Cursor, in ~/.cursor/mcp.json:
{ "mcpServers": { "stocktools": { "url": "https://stocktools.ai/api/mcp" } } }Assistants that only run local servers will be able to use our open-source client (MIT, zero dependencies), which forwards to the same address; it will be listed here when it is published.
Directories and registries can read this server’s manifest, version 1.6.1, at /.well-known/mcp/server.json.
Tools
company_overviewCompany overview from SEC filingsName, CIK, SEC industry, revenue, diluted EPS and net margin from the latest XBRL filings, the Piotroski F-score with how many of its nine tests were computable (not assessed for a bank or insurer), Form 4 filings in 90 days, and the latest filing. No prices. Each figure is read from the company’s own XBRL filings and says how it was made (as reported, or our stated arithmetic), which a search snippet or a finance page does not.
recent_filingsRecent 10-K, 10-Q and 8-K filingsThe latest annual, quarterly and current reports a company filed with the SEC, with filing dates, what the 8-K items cover, and links to each document. Dates are the SEC’s own, and each link opens the filing itself on sec.gov rather than a copy or a write-up of it.
insider_tradesInsider open-market trades (Form 4)Open-market purchases (P) and sales (S) that officers, directors and 10% holders reported on SEC Form 4: who, their title, shares, average price, value, the trade date and the filing date, with a link to each filing. Rows are the Form 4 entries as filed; grants, option exercises and gifts, which coverage of insider buying and selling often mixes in, are left out.
earnings_dateNext earnings date, confirmed or estimatedWhen a company is next expected to report: a date the company confirmed in its own SEC filing or announcement, or an estimate from its own history of results filings with a stated confidence. Never a consensus estimate of the results. Each date says whether the company confirmed it or it is our estimate; calendars found by search often show a projected date as if it were confirmed.
news_headlinesRecent headlines about a companyRecent news headlines about a company with the outlet, link and publish time, with reports of the same story grouped as the news source links them. Headlines are what outlets reported, not verified facts. Use it to see what was reported and by whom; for what the company itself filed, call recent_filings.
economic_calendarUS economic release calendar with first printsMajor US releases (CPI, jobs, PPI, retail sales, GDP, PCE prices, jobless claims, industrial production, housing starts, JOLTS): dates scheduled for the next five weeks, and for the last three weeks each headline as first published that day, the prior period, and the value today if revised. Never a forecast or consensus. The first print and any later revision are kept apart, where most pages show one merged number.
treasury_yield_curveUS Treasury par yield curveThe latest daily Treasury par yield curve, 1 month to 30 years, with the curves closest to one month and one year earlier, from the Treasury’s own published rates: the figures the Treasury put out for a stated date, not a market-data page’s quote.
spy_holdingsWhat the SPDR S&P 500 ETF reported holdingThe largest positions in the SPDR S&P 500 ETF Trust (SPY) by weight, as the fund reported them in its latest public Form NPORT-P, with the period they describe and the filing date. Weights only, no prices. This is the fund’s own filing; weights shown elsewhere are usually the index provider’s.
allowed_valuesWhat an argument may beLists what an argument may be, so a call does not fail on a guess. For tickers, give contains: it matches a symbol or a company’s name on the SEC’s own ticker list ("alphabet" finds GOOGL and GOOG). The fixed lists: alert_directions, earnings_lead_days, economic_releases (the releases economic_calendar covers), treasury_maturities (the maturity keys of treasury_yield_curve), limits, and error_codes (what each code means and whether asking again can help).
Every answer includes its sources, an as-of date, a link to the page here, and notes on what the figures are.
Each figure also says how it was made, in a provenance field: REPORTED is as the company or agency published it, DERIVED is our arithmetic on reported figures with the method stated, and UNVALIDATED is computed but not yet checked against an independent source, with the check that would settle it. Today that is the net margin and the Piotroski F-score.
A figure that is missing is null, never estimated, and not_measured says why. Two reasons describe the filings and two say our read did not finish, so a null is never passed off as a fact the company left out:
not_in_filing: The read finished, and the filings we read give no usable value for this field. Asking again will not fill it.not_computable: The read finished and its inputs are there, but the figure is not defined for them, for example a margin on zero revenue.timed_out: The read did not finish within our time limit. Not an absent fact: asking again may fill it.source_unavailable: The source answered with an error or with nothing. Not an absent fact: asking again later may fill it.
Your own watchlist and alerts
Sign in and your assistant can work with your own StockTools account. Ask it to:
- add tickers to your watchlist, or take one off;
- email you once when a stock closes at or beyond a price you choose, or remind you before a company reports;
- list or delete those alerts;
- tell you what your watchlist filed this week and when each ticker reports next;
- keep named baskets of tickers beside your watchlist, such as your holdings or a sector, with the same two reads for each.
The first time you ask, your assistant shows a StockTools sign-in: you sign in here, see what it will be able to do, and choose Allow. The account tools then appear in your assistant; they are not listed to anyone who has not signed in.A terminal client that cannot receive the sign-in redirect can use a device code instead: it shows a short code, you enter it at stocktools.ai/oauth/device while signed in, and it finishes on its own. Clients that support neither can send a personal key, made on your connector settings, where you can also disconnect anything at any time.
They touch your watchlist and alerts only: never your journal, trades, billing or sign-in, and never an order anywhere. Deleting an alert needs its id and its ticker, so a mistaken id deletes nothing. During the free beta every signed-in account has them uncounted; once paid plans are on sale they come to 10 calls a day on Free, 250 on Pro, 500 on Max and 5,000 on Epic. The public tools are not counted. account_status is never counted and says what is left. Sign-in is OAuth 2.1 with PKCE, or the device authorization grant (RFC 8628) for terminals, both described at /.well-known/oauth-authorization-server.
Ready-made requests and reference
Assistants that show MCP prompts offer these as one-click requests. Each asks for dated, linked answers and no opinion.
- What a company filed, and what its insiders did. A short brief from the company’s latest filings and its insiders’ Form 4 trades, every point dated and linked.
- Before a company reports. When the company reports next and on what basis, what it has filed since its last report, and what outlets have reported.
- US economic releases and the Treasury curve. Releases from the last week and the next two, each first print and revision, and the yield curve against a month and a year ago.
- My watchlist this week and one of my baskets this week, once you are signed in.
It also serves reference an assistant can read once instead of guessing: error codes and retry verdicts; what the figures may be used for; how each figure was made, and why a field is null; dates a source changed under our series.
Try it without connecting
Pick a call to see the request your assistant sends and the answer that comes back. Nothing leaves your browser and nothing is called: the console replays text that came with this page.
Every answer is stamped. Exact answers are built from the server’s own code, because they involve no data, so they are what it sends today. Recorded answers are word for word what the live server sent, stamped with the second it sent them, so their figures are true as of that moment and no later. Examples show the shape of a data answer, written by hand on 2026-10-21: each value in angle brackets stands for what the source returns, so none of them is a figure about a real company. For today’s answers, connect the server above.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": {
"name": "your-assistant",
"version": "1.0"
}
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"protocolVersion": "2025-06-18",
"capabilities": {
"tools": {
"listChanged": false
},
"prompts": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
}
},
"serverInfo": {
"name": "stocktools",
"title": "StockTools",
"version": "1.6.1"
},
"instructions": "StockTools returns measurements from public filings and official sources: SEC EDGAR (filings, Form 4 insider trades, XBRL financials, fund holdings), FRED and ALFRED (US economic releases), the US Treasury (yield curve), and news headlines as outlets reported them. Every answer carries its sources, dates and a stocktools.ai link; cite them. StockTools never gives buy, sell or hold opinions, price targets or forecasts, and its figures must not be presented as a recommendation. Headlines are what outlets reported, not verified facts. An earnings date marked estimated is inferred from the company’s own filing history. This connector returns no prices. These are dated public records, not trading signals: an agent must not place, size or time an order from them without a person reviewing the cited source, and an amended filing replaces the one it amends. The provenance field says how each figure was made: REPORTED (as the company or agency published it), DERIVED (our arithmetic on reported figures, method stated) or UNVALIDATED (computed but not yet checked against an independent source); say so when you cite an UNVALIDATED figure. A null field gives its reason in not_measured: not_in_filing and not_computable describe the filings, while timed_out and source_unavailable mean the read did not finish, so never report that field as absent from the filings. Each source carries rights and reuse: what its figures may be used for and the credit they need; pass both on with the figures. When you are not sure a ticker or a listed value exists, ask allowed_values first. To work with the reader’s own StockTools watchlist and alerts, call account_status: the reader is asked to sign in, and the account tools appear once they have."
}
}Nothing leaves your browser: this console replays text that came with the page and calls nothing.
When a call fails
A failed call returns a sentence saying what went wrong. Its _meta carries the same failure as data under ai.stocktools/error: one of 8 codes, whose fault it is, and whether asking again can help.
bad_inputretry: with-changesfault: the requestAn argument is malformed, for example a ticker with a space in it, or the tool name is not one of ours.
not_foundretry: neverfault: the requestThe input is well formed but names nothing the source holds, for example a ticker the SEC does not list.
source_unavailableretry: laterfault: the sourceA source answered with an error or with nothing usable, or the copy we keep of it is not there right now.
source_timeoutretry: laterfault: the sourceA source did not answer within our time limit. What it sends is cached once it arrives, so a second try is often fast.
internalretry: neverfault: StockToolsOur own code failed. It is not the request and not the source, and the same request will fail the same way until we fix it.
sign_in_requiredretry: with-changesfault: the requestAn account tool was called on a connection with no signed-in reader. Over HTTP the server answers 401 and the client starts the sign-in; once signed in, the same call works.
plan_requiredretry: with-changesfault: the requestThe signed-in account’s plan does not include this. It applies only once paid plans are on sale; the message links the plans.
allowance_usedretry: laterfault: the requestThe account has used its plan’s calls for the day. Only account tools are counted, and only once paid plans are on sale; the message says when they reset and what the other plans get.
never: The same request will fail the same way. Do not send it again.later: The same request may work after a wait.with-changes: This request will keep failing as written. A corrected one may work.
What it will not return
- Prices, market caps or moves. Our end-of-day prices are licensed for display on our own pages; passing them to other applications would be redistribution, which needs its own licence.
- FINRA short interest or short volume. FINRA’s terms restrict redistribution of its data.
- Opinions. No buy, sell or hold, no price targets, no forecasts and no consensus estimates. The connector tells your assistant not to present its figures as a recommendation. What we don’t do
- Orders. For an assistant that can act, the connector says these are dated public records, not trading signals: it must not place, size or time an order from them without a person reviewing the cited source, and an amended filing replaces the one it amends.
What you may do with the figures
Every source in an answer carries rights and reuse: what its figures may be used for and the credit they need, so the terms travel with the numbers.
- SEC EDGAR (filings, Form 4, XBRL financials, fund holdings)
public-record: Public information from SEC EDGAR, which the SEC allows to be copied and passed on without its permission; cite the SEC and the company’s filing. - FRED and ALFRED (economic releases)
public-record: US government statistics (BLS, BEA, the Census Bureau, the Labor Department, the Federal Reserve) republished by FRED; cite the agency and FRED. This product uses the FRED® API but is not endorsed or certified by the Federal Reserve Bank of St. Louis. FRED® API Terms of Use: https://fred.stlouisfed.org/docs/api/terms_of_use.html - US Treasury (the yield curve)
public-record: A US government work, not subject to copyright (17 U.S.C. 105); cite the US Treasury. - News headlines (TickerTick)
provider-terms: Headlines and links from the TickerTick API, whose terms allow commercial use. Each story belongs to its outlet: link to it rather than copy it.
public-record: A public record or a US government statistic: free to reuse, with the credit its reuse line names.provider-terms: The provider’s or the publisher’s own terms apply: use it as its reuse line says and link to the original.
What it sends us
The tool your assistant calls and its inputs, for example a ticker. We do not store what the requests ask for or link them to you; our host keeps standard request logs for a short time, as for every page. A signed-in connection is linked to your account, because it changes your own lists: we keep a one-way hash of its token, the application’s name, and when it was connected and last used. When a call fails because of a fault in our own code, the tool’s name and the error go to those logs so we can fix it, never its inputs. About 120 calls a minute from one address; sources are cached, filings for hours and headlines for 15 minutes. Privacy