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 filings

Name, 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 filings

The 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 estimated

When 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 company

Recent 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 prints

Major 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 curve

The 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 holding

The 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 be

Lists 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:

Your own watchlist and alerts

Sign in and your assistant can work with your own StockTools account. Ask it to:

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.

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.

Exact answers, no data involved
Recorded answers
Examples of the shape
Exact · built from the server’s own code
Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "your-assistant",
      "version": "1.0"
    }
  }
}
Response
{
  "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 request

An 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 request

The input is well formed but names nothing the source holds, for example a ticker the SEC does not list.

source_unavailableretry: laterfault: the source

A 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 source

A 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: StockTools

Our 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 request

An 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 request

The 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 request

The 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.

What it will not return

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.

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