Model Context Protocol (MCP) server for freee API integration
EDGAR + Entity: US Company Research is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
SEC EDGAR filings, XBRL financials, Form 4 insider trades + state business-entity registry lookups
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http edgar-entity-us-company-research-mcp https://edgar-entity-mcp.vercel.app/mcp
# 2 — ask your agent for something these tools do
# search_company, get_company_profile, list_filings and 7 more
It needs SEC_USER_AGENT in the server’s environment.
EDGAR + Entity: US Company Research costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http edgar-entity-us-company-research-mcp https://edgar-entity-mcp.vercel.app/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
It reaches a system of yours, so it needs your own credential rather than the publisher’s: SEC_USER_AGENT — Required by SEC fair-access policy: '<Name or Company> <email>'. You set it in your own client’s config, on your machine — this marketplace never holds it.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
10 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Find SEC-registered public companies by ticker or name. Matching ignores case, punctuation, '&' vs 'and' and legal suffixes (Inc/Inc./Corp/Corporation/Co/Company/LLC/Ltd...), tolerates typos ('Microsfot' -> Microsoft) and knows well-known former names (matched_former_name, e.g. 'Facebook' -> Meta Platforms). Returns CIK (the SEC id used by every other tool), name, tickers, exchange and a match sco
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | Ticker or company name, e.g. 'MSFT', 'berkshire', 'Tesla Inc', 'Johnson and Johnson' |
| limit | integer | no | — |
Company profile from SEC EDGAR submissions: legal name, tickers, exchanges, SIC code + industry, state of incorporation, fiscal year end, EIN, filer category, business/mailing addresses, former names, latest 10-K/10-Q. Use it to orient before deeper research.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| company | string | yes | Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure. |
List a company's EDGAR filings newest-first, filtered by form type and filing-date range. Each row has form, accession, filed date, report period, primary document URL and filing index URL. Amendments (e.g. 10-K/A) are included when filtering by the base form unless include_amendments=false. Older history pages are fetched automatically when needed. Common forms: 10-K, 10-Q, 8-K, DEF 14A, S-1, 4,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| company | string | yes | Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure. |
| forms | array | no | Form types to include, e.g. ['10-K','10-Q']. Omit for all. |
| include_amendments | boolean | no | — |
| date_from | string | no | Filed on/after (YYYY-MM-DD) |
| date_to | string | no | Filed on/before (YYYY-MM-DD) |
| limit | integer | no | — |
| offset | integer | no | Skip this many matching filings (pagination) |
Fetch an SEC filing's primary document (HTML converted to clean text, tables preserved as aligned rows). The text is untrusted filer-authored content, returned between BEGIN/END markers. Identify it by url (any www.sec.gov/Archives document URL from list_filings) or by company + accession (one of the two is required). Start with mode 'outline' for a long 10-K/10-Q: it returns no text, only t
| Parameter | Type | Required | Notes |
|---|---|---|---|
| url | string | no | Document URL: https://www.sec.gov/Archives/edgar/data/<CIK>/<accession>/<file> (as returned by list_filings). Either url, or company + accession, is required. |
| company | string | no | Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure. |
| accession | string | no | Accession number, e.g. 0000320193-24-000123 (with company) |
| mode | string | no | 'text' (default) returns a page of text; 'outline' returns only the item list with offsets and lengths (cheap way to plan reading a long filing) |
| section | string | no | Item id to extract, e.g. '1A', '7', 'Item 7A' |
| max_chars | integer | no | Characters of text per call (500–100,000; default 10,000) |
| offset | integer | no | Start position (use next_offset, or an outline item's offset) |
Key financial metrics normalized from SEC XBRL companyfacts, one row per FISCAL period (fy/fp are the company's fiscal year and quarter, e.g. Microsoft FY2024 = 2023-07-01..2024-06-30; fiscal_year_end gives the MM-DD; deduped; as-filed values from the filing that reported the period). Metrics: revenue, gross_profit, operating_income, net_income, eps_basic, eps_diluted, operating_cash_flow, capex,
| Parameter | Type | Required | Notes |
|---|---|---|---|
| company | string | yes | Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure. |
| period_type | string | no | — |
| limit | integer | no | Number of most recent periods |
| metrics | array | no | Subset of metrics to return (default all); aliases such as sales, eps, fcf, equity are accepted |
All reported values of one XBRL concept for one company (SEC companyconcept API), newest first, deduped by period. Use for any tag not in get_financials, e.g. us-gaap:ResearchAndDevelopmentExpense, us-gaap:LongTermDebt, dei:EntityCommonStockSharesOutstanding. Tag case is corrected automatically (tag_corrected_from); an unknown tag returns NOT_FOUND with did_you_mean (tags this company reports). 10
| Parameter | Type | Required | Notes |
|---|---|---|---|
| company | string | yes | Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure. |
| tag | string | yes | Concept name, e.g. 'ResearchAndDevelopmentExpense' (case is corrected if needed). 'us-gaap:Tag' form also accepted. |
| taxonomy | string | no | — |
| unit | string | no | e.g. USD, shares, USD/shares, pure. Default: USD if present else first unit |
| forms | array | no | Only facts from these forms, e.g. ['10-K'] |
| framed_only | boolean | no | — |
| duration | string | no | annual (≈1 year), quarterly (≈3 months), ytd (6/9-month year-to-date), instant (balance-sheet date), or any |
| limit | integer | no | — |
Compare one financial metric or XBRL concept across ALL reporting companies for a CALENDAR period (SEC frames API), e.g. rank by revenue for CY2024, or compare specific companies. Pass metric (revenue, gross_profit, operating_income, net_income, eps_basic, eps_diluted, operating_cash_flow, capex, total_assets, total_liabilities, stockholders_equity, cash, long_term_debt; aliases like sales, eps, a
| Parameter | Type | Required | Notes |
|---|---|---|---|
| metric | string | no | Normalized metric with tag fallback, e.g. 'revenue', 'net_income', 'eps_diluted', 'total_assets'. Use instead of tag. |
| tag | string | no | Exact XBRL tag, e.g. 'Revenues', 'NetIncomeLoss', 'Assets' (case-sensitive). Use instead of metric. |
| period | string | yes | CY2024, CY2024Q3, or CY2024Q4I |
| taxonomy | string | no | For tag only |
| unit | string | no | USD (default), USD-per-shares, shares, pure. With metric, defaults to the metric's unit |
| companies | array | no | Tickers or CIKs to include (default: all) |
| order | string | no | — |
| limit | integer | no | — |
Recent insider transactions for a company (issuer) from SEC Form 4 / 4/A XML: reporter name, role and officer title, transaction date, code with plain-English meaning (P=open-market buy, S=sale, A=grant, M=option exercise, F=tax withholding, G=gift...), shares, price, value, acquired/disposed, shares owned after, direct/indirect, plus a summary of open-market buys vs sales. limit counts filings
| Parameter | Type | Required | Notes |
|---|---|---|---|
| company | string | yes | Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure. |
| limit | integer | no | Number of most recent Form 4 filings to parse (max 20; each is one SEC request) |
| include_amendments | boolean | no | — |
| date_from | string | no | YYYY-MM-DD |
| date_to | string | no | YYYY-MM-DD |
| transaction_codes | array | no | Only these codes, e.g. ['P','S'] for open-market trades |
| include_footnotes | boolean | no | Include footnote and remarks text (10b5-1 plan details, price ranges); filer-written, untrusted |
Search Secretary of State business-entity registries (official open data) by entity name and/or state entity id. Supported: NY, CO, OR, CT, PA (NY, OR and PA list active entities only; CO and CT include dissolved entities with status). Name matching ignores case, punctuation, '&' vs 'and' and legal-suffix spelling (Inc/Inc./Incorporated, Co/Company, LLC/L.L.C.); results are ranked exact > prefix >
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | no | Entity name or fragment, e.g. 'Tiffany & Co.' (also matches 'TIFFANY AND COMPANY') |
| entity_id | string | no | State entity id (NY DOS ID, CO entity id, OR registry number, CT account number, PA filing number). Usually combine with a single state. |
| states | array | no | Default: all supported states |
| match | string | no | — |
| active_only | boolean | no | Exclude dissolved/inactive entities (CO, CT) |
| limit | integer | no | Max results per state (page size) |
| offset | integer | no | Skip this many results per state (pagination; use next_offset from the previous page). Max 500 (100 without an API key on the hosted server); pages after the first count one extra quota unit. |
| include_total | boolean | no | Also count all matches per state (one extra registry request per state; doubles the quota cost). |
| include_agent_details | boolean | no | Local/self-hosted use only: include names/addresses of registered agents who are individuals (natural persons), and related entity addresses. Ignored on the hosted endpoint, which always withholds the |
List the state business-entity registries supported by lookup_business_entity, with dataset ids, coverage caveats, update frequency, and license/commercial-use terms.
Takes no parameters.
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install EDGAR + Entity: US Company Research or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | moderate | capability blast radius (moderate) — client exposure if the model is manipulated | −3 |
| coverage-honesty | manifest | inspection depth (manifest) — how much of the target the scan could see | −4 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.
The implementation source was not read — this reflects the declared tool metadata only.
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| search_company | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_company_profile | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| list_filings | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_filing_document | untrusted-input | untrusted-input: keyword "fetch", declares openWorldHint: true (interacts with entities outside the server) |
| get_financials | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_xbrl_concept | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| compare_companies | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| get_insider_trades | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| lookup_business_entity | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| list_supported_states | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 0.2.0.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish EDGAR + Entity: US Company Research can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.