NetNest Design Fundamentals API
SEC company fundamentals and filing events, each with its source filing. Pay per call with x402.
Should I use this
Quality & Safety
Findings (1)
- LOWTool 'get_events_head' description lacks action verbin get_events_head
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"fundamentals": {
"url": "https://api.netnestdesign.com/mcp"
}
}
}Remote endpoints
https://api.netnestdesign.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
🟢search_company(q, limit)
Free ticker and company name lookup: find the ticker for a company name, or the company for a ticker. Data from SEC filings. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Company name or ticker, for example apple or AAPL"
},
"limit": {
"description": "Number of results, 1 to 25 (default 10)",
"type": [
"number",
"string"
]
}
},
"required": [
"q"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_company(ticker)
Latest company financials from SEC filings for one ticker: revenue, net income, diluted EPS, operating income, total assets, cash, free cash flow and shares outstanding, for the latest fiscal year, latest quarter and trailing twelve months. Every number includes its period dates, the 10-K or 10-Q it came from, the filing date and a link to the SEC filing.
Input Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "Stock ticker, for example AAPL or BRK.B"
}
},
"required": [
"ticker"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_fundamentals(ticker, metrics, period)
Latest company revenue, net income, EPS, operating income, assets, liabilities, equity, cash, operating cash flow, capex, free cash flow or shares outstanding from SEC filings. Choose metrics and period (annual, quarterly or ttm). Latest values follow the fiscal year of each company, with the source filing, filing date and accession number for every number.
Input Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "Stock ticker, for example AAPL or BRK.B"
},
"metrics": {
"description": "Comma separated: revenue, net_income, eps_basic, eps_diluted, operating_income, total_assets, total_liabilities, equity, cash, operating_cash_flow, capex, free_cash_flow, shares_outstanding, revenue_contract",
"type": "string"
},
"period": {
"description": "annual, quarterly or ttm (trailing twelve months)",
"type": "string"
}
},
"required": [
"ticker"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_history(ticker, metric, period, limit)
Financial history of one metric from SEC filings, newest first: revenue history, net income history, EPS history, cash flow history and more, by year, quarter or trailing twelve months. Up to 200 periods, each with its 10-K or 10-Q, filing date and SEC link.
Input Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "Stock ticker, for example AAPL or BRK.B"
},
"metric": {
"type": "string",
"description": "The metric to return: revenue, net_income, eps_basic, eps_diluted, operating_income, total_assets, total_liabilities, equity, cash, operating_cash_flow, capex, free_cash_flow, shares_outstanding, revenue_contract"
},
"period": {
"description": "annual, quarterly or ttm (trailing twelve months)",
"type": "string"
},
"limit": {
"description": "Number of periods, newest first, 1 to 200 (default 20)",
"type": [
"number",
"string"
]
}
},
"required": [
"ticker",
"metric"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_events(since, before, types, tickers, limit)
SEC filing events across companies, newest first: 8-K items by plain name, Form 4 insider transactions and Schedule 13D and 13G stakes, each with its form, filing date, acceptance time, accession number, SEC link, CIK and ticker. Paid with x402 per call or with an API key.
Input Schema
{
"type": "object",
"properties": {
"since": {
"description": "Cursor from an earlier answer (its next field): only events newer than it are returned",
"type": "string"
},
"before": {
"description": "Cursor from an earlier answer (its continue field): the next page of older events",
"type": "string"
},
"types": {
"description": "Event types to include, for example 8k_results or form4_transaction",
"type": "array",
"items": {
"type": "string"
}
},
"tickers": {
"description": "Tickers to include, for example AAPL or BRK.B",
"type": "array",
"items": {
"type": "string"
}
},
"limit": {
"description": "Number of events, 1 to 100 (default 100)",
"type": [
"number",
"string"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_events_head(since)
Free: the newest cursor of the SEC events feed and, given a cursor, how many events are newer than it, so a poller pays only when there is something new. Data from SEC filings. Not investment advice.
Input Schema
{
"type": "object",
"properties": {
"since": {
"description": "Cursor from an earlier answer (its next field): only events newer than it are returned",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence