Filivora MCP
AI-powered financial intelligence platform that transforms publicly available SEC filings into structured, explainable and evidence-backed research.
Servidor MCP alojado
npx add-mcp 'https://filivora.com/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Use Filivora from an AI agent.
Filivora speaks the Model Context Protocol. An agent such as Claude can look up an accounting indicator and get the figure back with the SEC filing it was read from, as it was knowable on a date you choose.
What it offers.
Tools answer a question: 18 of them, all read-only. Resources are reference text an agent can load into the conversation: a glossary, the limits, the methodology. Prompts are ready-made careful workflows, such as reviewing a company or explaining a figure, that your client can show as menu items.
Nothing here can change data. No tool starts a job, loads a company or writes anything. Every answer carries a stamp with the data vintage and the plain statement that no indicator has been validated as a predictor of returns, and every figure names its filing.
Connect.
The address is https://filivora.com/mcp (streamable HTTP). Some servers require a token; if yours does, send it as Authorization: Bearer <token>.
Claude Code
claude mcp add --transport http filivora https://filivora.com/mcp
# with a token:
claude mcp add --transport http filivora https://filivora.com/mcp --header "Authorization: Bearer <token>"
Claude Desktop and other apps with custom connectors
Add a custom connector (or remote MCP server) and paste https://filivora.com/mcp as its URL. Add the header above if a token is needed. Apps that only start local programs can use the standalone server in the repository, python -m app.mcp_server --stdio.
Any client with an mcpServers block
{
"mcpServers": {
"filivora": {
"type": "http",
"url": "https://filivora.com/mcp",
"headers": { "Authorization": "Bearer <token>" }
}
}
}
Python
from fastmcp import Client
from fastmcp.client.transports import StreamableHttpTransport
async with Client(StreamableHttpTransport("https://filivora.com/mcp")) as c:
print(await c.call_tool("get_indicators", {"company": "AAPL"}))
Then ask something: “What is Apple's operating cash flow over net income, and which filing is that from?”
Tools.
company takes a ticker, a CIK or a name that identifies one company; a name that matches several is refused with the candidates listed. as_of is a date such as 2024-06-30 and shows only what was public by then.
| Tool | What it returns |
|---|---|
get_status | Companies loaded and scored, history, data vintage, validation statement. Call it when freshness matters. |
list_indicators | The indicator dictionary: formula, inputs, unit and direction of every metric. |
search_companies | Name, ticker or CIK lookup among loaded companies. |
get_indicators | One company and one year: each indicator with its formula, inputs and filing, the signals that fired, the aggregate. Arguments: company, as_of, fiscal_year_end. |
screen_companies | A review list, most flags first. Filters: industry, flagged_signal, min_flags, tickers, include_banks. |
get_peers | A company beside same-industry peers on the same indicators. |
get_alerts | What is new for a list of tickers, ranked high, medium, info. |
get_events | New filings and disclosure analyses, across the universe or for tickers. |
get_disclosure_changes | Substantive changes against the same section a year earlier, each with its checked quote and status. |
get_panel | The indicator panel as rows, one per company-year. With as_of there is no look-ahead. Blank means not reported. |
list_data_sources | Every source, how late it is, whether it is implemented. |
list_institutional_managers | The 13F managers loaded and their latest public period. |
get_manager_holdings | What a manager reported holding at a quarter end, with concentration. |
get_manager_changes | The latest 13F against the one before: new, increased, decreased, exited. |
get_manager_overlap | Securities reported by more than one manager. |
get_insider_activity | Forms 3, 4 and 5 by transaction code; open-market trades kept apart from awards and withholding. |
get_corporate_events | 8-K items as events with the SEC's item title and when they became public. |
get_cyber_disclosures | Material cybersecurity incident disclosures (8-K item 1.05) and their updates. |
Resources.
Reference text and data an agent, or you, can attach to a conversation. In most clients they appear under an attach or “@” menu.
| URI | Content |
|---|---|
filivora://glossary | Plain definitions: point in time, accession number, 8-K items, the published models, 13F, Form 4 codes. |
filivora://limits | What Filivora does not claim or do, and the caps on a call. |
filivora://methodology | What is computed, the point-in-time rule, how quotes are checked. |
filivora://indicators | The indicator dictionary as JSON. |
filivora://data-sources | Each source, how late it is, whether it is implemented. |
filivora://alerts-guide | How alerts and events are ranked and what they do not say. |
filivora://status | Data vintage, coverage and the validation statement. |
filivora://company/{company} | A template: the latest-year indicators of one company, for example filivora://company/AAPL. |
Prompts.
A prompt sends the model through the right tools in the right order, with the caveats built in. Each asks for the accession number of every figure, the data vintage, and no claim that anything was misstated. Clients show prompts as slash commands or a menu.
| Prompt | Arguments | What it asks for |
|---|---|---|
review_company | company | A careful accounting-quality review: indicators, peers, verified disclosure changes, 8-K alerts. |
explain_figure | company, metric, fiscal_year_end | One indicator traced to its formula, inputs and source filings. |
what_changed | company, days | New filings, 8-K items and verified disclosure changes, facts kept apart from rule-based signals. |
screen_for_review | industry, min_flags | A reading list of companies with the most flags, as a reading order and not a ranking of risk. |
compare_with_peers | company | The company and its two closest peers side by side, with unreported values named. |
ownership_check | company | Reported 13F changes and insider trades, with the timing caveats. |
point_in_time_view | company, as_of | What was knowable on a past date, without later filings. |
watchlist_digest | tickers, days | A digest grouped by priority, ending with the tickers that had nothing. |
Examples.
Trace a figure. Run the prompt explain_figure with AAPL and ocf_to_net_income. The agent reads the formula, fetches the two inputs and answers with the accession number and link of the 10-K each came from. If an input was not reported it says so; it never fills in zero.
Ask in plain language. “Which software companies have three or more flags, and what fired for the first three?” The agent calls screen_companies with industry “software” and min_flags 3, then get_indicators for the top three, and calls the list a reading order.
Point in time. “What was knowable about Apple's cash conversion on 2024-06-30?” The agent passes as_of to get_indicators. Filings accepted after that date, and restatements filed later, are hidden. Pick a fiscal year with fiscal_year_end, never by passing a year end as as_of.
A quant panel. get_panel with years “all”, an as_of date and a list of tickers returns one row per company-year as it could have been seen that day.
A weekly digest. The prompt watchlist_digest with your tickers and 7 days returns facts about new filings. It does not say what they mean for a price.
What to expect.
Indicators are rules of thumb or published models, and none has been validated as a predictor of returns. Coverage is the companies loaded so far, not every SEC filer. 13F reports show a quarter end, filed up to 45 days later, not a current position. A list returns at most 100 rows a call. Nothing here is investment advice. The full list of limits
Why not the website.
The website and its REST interface are for people in a browser. Programs, crawlers and AI assistants that call them directly are refused. This MCP server is the supported way in for AI, with the same figures, each with its filing.
Troubleshooting.
| You see | What it means and what to do |
|---|---|
| 401 Unauthorized | A token is required and the header is missing or wrong. Send Authorization: Bearer <token>. |
| 429 Too Many Requests | The token passed its per-minute quota. Wait for the Retry-After seconds. |
| 403 with a page titled “Just a moment” | A bot-protection layer in front of the site is challenging a non-browser client. The MCP server is not involved; ask whoever runs the site to allow /mcp. |
| Company not found | Coverage is the companies loaded so far. Try search_companies. |
| “Ambiguous” with a list | Pass the ticker or CIK from the list. |
| A blank indicator value | The filing did not report an input. It is never zero. |
| No resources or prompts in your client | Some clients support tools only. list_indicators and list_data_sources return the same content as tools. |