Skip to main content
POST
Search financial statements
Find tickers that match numeric conditions. Body takes filters — each a field, an operator and a value — plus limit. Returns results with ticker, currency, sector, industry and whichever filtered field was matched. This is the only tool here that works without knowing a ticker in advance; everything else takes one as input. Filterable fields are the metric names get_financial_financial_metrics returns. Use it to build a candidate list, then pull detail on each name with the statement or metric tools.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. The commands per client, and what each call costs, are on aisa.one/mcp.
Set this endpoint up in your agent →

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
filters
object[]
required

An array of filter objects to apply to the search.

Minimum array length: 1
period
enum<string>
default:ttm

The time period for the financial data.

Available options:
annual,
quarterly,
ttm
limit
integer
default:100

The maximum number of results to return.

Required range: 1 <= x <= 100
order_by
enum<string>
default:ticker

The field to order the results by. Use -field to order in descending order.

Available options:
ticker,
-ticker,
report_period,
-report_period
currency
enum<string>

The currency of the financial data.

Available options:
USD,
EUR,
GBP,
JPY,
CHF,
AUD,
CAD,
SEK
historical
boolean
default:false

Whether to return historical financial data.

Response

Successful search response

results
object[]

Stocks matching the requested screener filters.