llms.txt
+16 −6
https://getfinbolt.com/llms.txt
− > Finbolt gives AI agents analyst tools over MCP. Composite tools answer common questions in one call, backed by 113 financial data tools covering stock quotes and price history, company fundamentals, earnings, news sentiment, forex, crypto, commodities, US economic indicators and 50+ technical indicators. Built for AI agents and MCP clients (Claude, ChatGPT, Cursor, custom agents).− - Credits: every data call costs credits: 1 for `get_fact`, `financials` and each market-data tool, 5 for `analyze_stock` and `compare_stocks`. Errors and calls that return no figure or no data are free. Every charged result carries `credits: {charged, remaining, resets}`. At zero, calls return `CREDITS_EXHAUSTED` until credits reset or a top-up; there is no overage. Top-ups are $10 per 1,000 credits and never expire while the account is open (`POST /api/topup`, same auth as upgrade).− - `Authentication required` / `Invalid API key`: sign up (above) or check the key.− - `Premium feature: '<tool>' requires a paid subscription`: upgrade (above) or use a free tool.− Each one runs several data calls and returns compact JSON (a few hundred tokens) with plain-language states, `as_of` and `sources`. A composite call counts as one call. Free keys get 5 composite calls a day.− The default `tools/list` has the composite tools, 17 core data tools (quotes, search, daily/weekly/monthly series, overview, statements, earnings, SMA, EMA, RSI, MACD, Bollinger Bands, news sentiment, exchange rate) and two meta-tools:+ > Finbolt gives AI agents company figures cited to their SEC filings: one reported figure, a full statement, peers side by side, earnings releases, restatements, and a check of an agent's draft against the filings. Every figure carries its filing. Delayed market data tools are included for personal research.+ - Credits: every data call costs credits: 1 for get_fact, financials, earnings_release, restatement_history, snapshot and each market-data tool; 1 per company with a new filing in the period for changes_since; 1 per company with filed figures for peer_table; 5 for analyze_stock; 5 per ticker for compare_stocks. resolve is free. Errors and calls that return no figure or no data are free. Every charged result carries `credits: {charged, remaining, resets}`. At zero, calls return `CREDITS_EXHAUSTED+ - `An API key is required` / `Invalid API key`: sign up (above) or check the key.+ - `<tool> is part of the Pro plan`: upgrade (above) or use a tool on your plan.+ ## Filing tools (SEC filings, cited by accession)+ Figures from companies' 10-K, 10-Q and earnings-release 8-K filings, each cited to the filing it came from: accession number, form, filing date, a link to the filing and, where the filing tags the figure, its XBRL tag. A figure the company never reported comes back as missing, never estimated. Values are in units as filed. Foreign private issuers (20-F, 40-F) are not covered yet. The filing tools use no market price. Where one computes market cap or P/E, you pass the price and its date.+ - `get_fact(company, concept, period?, as_of?)`: one reported figure, such as revenue, net income, diluted EPS, total assets or operating cash flow, for the latest period, a fiscal year (`FY2025`), a fiscal quarter (`FY2025 Q2`) or a period end date (`2025-06-28`). Restated values are listed, and `as_of` returns the figure as it was on file on that date.+ - `financials(company, statement?, period_type?, limit?, as_of?)`: an income statement, balance sheet or cash flow statement, annual or quarterly, up to 8 periods, newest first. Every null carries its reason.+ - `resolve(company, period?, concept?)`: which company a ticker is, what a period phrase means for its fiscal year, and which line item a name maps to. No figures. Free.+ - `snapshot(company, price?, price_date?)`: a first look at one company from its SEC filings alone: revenue, margins, growth, EPS, cash flow and net debt over the last four quarters, with short observations built only from those figures. 1 credit.+ - `peer_table(tickers, prices?)`: 2 to 10 companies side by side from their SEC filings: revenue and its growth over the last four quarters, pretax margin, net income growth, diluted EPS growth and net debt, with each column ranked. 1 credit per company with filed figures.+ - `earnings_release(company, period?, all_cells?)`: the quarterly earnings release from the company's 8-K, as the company printed it: headline figures (GAAP, non-GAAP and operating measures) and the company's guidance word for word, beside the SEC-tagged figure for the same quarter and the quarter before. 1 credit.+ - `restatement_history(company, concept?, years?, as_of?)`: figures that a later SEC filing changed: the value as first filed, the latest value, the change in percent, and which one `get_fact` gives you. Most changes are recasts, not corrections of errors. 1 credit.+ - `changes_since(companies, since, as_of?)`: for up to 40 companies, what each one filed with the SEC since a date in the last 400 days: reports, amendments, earnings-release and non-reliance 8-Ks, the new periods `get_fact` can now answer, and figures a filing in that window changed. 1 credit per company with a new filing in the period; a call where nothing changed is free.+ Each one runs several data calls and returns compact JSON (a few hundred tokens) with plain-language states, `as_of` and `sources`. analyze_stock costs 5 credits; compare_stocks costs 5 credits for each ticker that returns an analysis.+ The default `tools/list` has the composite tools, the filing tools, 17 core data tools (quotes, search, daily/weekly/monthly series, overview, statements, earnings, SMA, EMA, RSI, MACD, Bollinger Bands, news sentiment, exchange rate) and two meta-tools: