Filivora MCP

AI-संचालित वित्तीय इंटेलिजेंस प्लेटफ़ॉर्म, जो सार्वजनिक रूप से उपलब्ध SEC फाइलिंग्स को संरचित, व्याख्यायोग्य और साक्ष्य-समर्थित शोध में बदलता है।

होस्ट किया गया MCP सर्वर

npx add-mcp 'https://filivora.com/mcp'

Claude Code, Codex, Cursor और अन्य में इंस्टॉल होता है

दस्तावेज़

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.

ToolWhat it returns
get_statusCompanies loaded and scored, history, data vintage, validation statement. Call it when freshness matters.
list_indicatorsThe indicator dictionary: formula, inputs, unit and direction of every metric.
search_companiesName, ticker or CIK lookup among loaded companies.
get_indicatorsOne 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_companiesA review list, most flags first. Filters: industry, flagged_signal, min_flags, tickers, include_banks.
get_peersA company beside same-industry peers on the same indicators.
get_alertsWhat is new for a list of tickers, ranked high, medium, info.
get_eventsNew filings and disclosure analyses, across the universe or for tickers.
get_disclosure_changesSubstantive changes against the same section a year earlier, each with its checked quote and status.
get_panelThe indicator panel as rows, one per company-year. With as_of there is no look-ahead. Blank means not reported.
list_data_sourcesEvery source, how late it is, whether it is implemented.
list_institutional_managersThe 13F managers loaded and their latest public period.
get_manager_holdingsWhat a manager reported holding at a quarter end, with concentration.
get_manager_changesThe latest 13F against the one before: new, increased, decreased, exited.
get_manager_overlapSecurities reported by more than one manager.
get_insider_activityForms 3, 4 and 5 by transaction code; open-market trades kept apart from awards and withholding.
get_corporate_events8-K items as events with the SEC's item title and when they became public.
get_cyber_disclosuresMaterial 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.

URIContent
filivora://glossaryPlain definitions: point in time, accession number, 8-K items, the published models, 13F, Form 4 codes.
filivora://limitsWhat Filivora does not claim or do, and the caps on a call.
filivora://methodologyWhat is computed, the point-in-time rule, how quotes are checked.
filivora://indicatorsThe indicator dictionary as JSON.
filivora://data-sourcesEach source, how late it is, whether it is implemented.
filivora://alerts-guideHow alerts and events are ranked and what they do not say.
filivora://statusData 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.

PromptArgumentsWhat it asks for
review_companycompanyA careful accounting-quality review: indicators, peers, verified disclosure changes, 8-K alerts.
explain_figurecompany, metric, fiscal_year_endOne indicator traced to its formula, inputs and source filings.
what_changedcompany, daysNew filings, 8-K items and verified disclosure changes, facts kept apart from rule-based signals.
screen_for_reviewindustry, min_flagsA reading list of companies with the most flags, as a reading order and not a ranking of risk.
compare_with_peerscompanyThe company and its two closest peers side by side, with unreported values named.
ownership_checkcompanyReported 13F changes and insider trades, with the timing caveats.
point_in_time_viewcompany, as_ofWhat was knowable on a past date, without later filings.
watchlist_digesttickers, daysA 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 seeWhat it means and what to do
401 UnauthorizedA token is required and the header is missing or wrong. Send Authorization: Bearer <token>.
429 Too Many RequestsThe 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 foundCoverage is the companies loaded so far. Try search_companies.
“Ambiguous” with a listPass the ticker or CIK from the list.
A blank indicator valueThe filing did not report an input. It is never zero.
No resources or prompts in your clientSome clients support tools only. list_indicators and list_data_sources return the same content as tools.

Open the Data Access page How it works