get_fundamentals
Get company financial statements
Normalized income statement, balance sheet, and cash flow for a US-listed ticker, parsed from SEC EDGAR XBRL. Counts as one request on the Edgrapi plan.
limitperiodticker必填
io.github.paperandbeyond23-gif由 GitHub 帳號 paperandbeyond23-gif 發布v1.3.1更新於 Oct 27, 2026
US government + SEC data as clean JSON: SAM.gov, USAspending, Grants.gov, Congress, SEC filings.
發布方自己的服務:RestoSignals
託管型 MCP 伺服器,為助理提供正規化的 JSON 資料:SEC EDGAR 財報與內部人交易、13F 持股,以及美國聯邦合約、撥款、補助和國會議員交易。
Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/io.github.paperandbeyond23-gif%2Fedgrapi-skills/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"edgrapi-skills": {
"type": "http",
"url": "https://api.edgrapi.com/mcp"
}
}
}US government data for AI agents — five official sources, one key, one JSON schema.
SAM.gov contract opportunities, USAspending awards, Grants.gov funding, US House STOCK Act trades, and SEC EDGAR filings, served as a hosted MCP server plus drop-in Python skills, over the Edgrapi API.
Every one of those sources is free and public. Each also ships its own headache: SAM.gov takes
ncode where you'd expect naics and silently ignores unknown filters, its dates are MM/dd/yyyy
and its query window caps at a year; USAspending's hasNext goes false at record 10,000 while real
rows continue to 50,000; EDGAR gives you XBRL tag drift. Edgrapi normalises all of it into one
schema so your agent gets numbers it can trust in one call.
Free to start — grab a key, 50 free credits to start, no card.
Pure Python standard library. No dependencies. MIT-0 licensed.
Nothing to install, no local process. Point any MCP client at one URL:
Works in Claude Desktop, Claude Code, Cursor and Cline. Transport is streamable-http. Auth is a
bearer edgr_ key or OAuth 2.1 with PKCE — the server is its own provider and supports dynamic
client registration. Discovery (initialize, tools/list) is open, so you can inspect the full
tool list before you have a key; tools/call needs one.
Also listed in the Official MCP Registry as
io.github.paperandbeyond23-gif/edgrapi-skills.
19 tools, all read-only.
For the live list, call tools/list or read the
server card — both are generated from
the server, so neither goes stale.
Drop-in Python, pure standard library. Install all of them or just the one you need.
Set EDGRAPI_KEY to your key (format edgr_...). It is sent as the X-API-Key header, and the
base URL is hardcoded, so the key never reaches any other host.
Get a free key — 50 credits to start, no card. The same key works for the skills, the MCP server and direct REST.
Credits are weighted by endpoint, not one per request. Government endpoints cost 2. On the SEC side,
company, filings, events, entity resolution and full-text search cost 1; fundamentals, ratios and
XBRL cost 3; sections, insider, holdings and activist cost 5. The exact cost of a call comes back in
the X-Credits-Cost header.
Top-up packs, one-time and never expiring: 5,000 / $7 · 15,000 / $18 · 50,000 / $55. Paid-plan credits roll over. Full details at https://edgrapi.com/pricing. Also available metered on RapidAPI.
See CONTRIBUTING.md. Security reports: SECURITY.md.
MIT No Attribution. Fork, ship, sublicense — no attribution required.
Edgrapi is an independent service, not affiliated with, endorsed by or sponsored by the U.S. Securities and Exchange Commission, the General Services Administration, SAM.gov, USAspending.gov, Grants.gov, or the U.S. House of Representatives. All data originates from those bodies' public systems and is in the public domain.
來源:README.md,提交 e7e1b2a
Get company financial statements
Normalized income statement, balance sheet, and cash flow for a US-listed ticker, parsed from SEC EDGAR XBRL. Counts as one request on the Edgrapi plan.
limitperiodticker必填Get computed financial ratios
Margins, returns (ROE/ROA), leverage and liquidity ratios for a ticker, derived from SEC EDGAR fundamentals, plus per-share figures (eps_diluted, book_value_per_share, shares_outstanding). Price-based ratios (P/E, P/B) aren't returned because EDGAR has no market price; divide your own price by the per-share figures.
ticker必填Get a company profile
CIK, legal name, SIC industry, fiscal-year end, exchanges and website for a ticker, resolved from SEC EDGAR submissions.
ticker必填Get recent SEC filings
Recent SEC filings for a ticker (10-K/10-Q/8-K) with filing/report dates and document links.
formlimitticker必填Get 10-K/10-Q narrative sections
Narrative sections from the latest 10-K/10-Q as clean text — Risk Factors (item 1A), MD&A (item 7), Business (item 1), etc. Built for LLM/RAG equity research. Omit 'item' to list the available sections first.
formitemticker必填Get parsed insider transactions
Parsed SEC Form 4 insider trades for a ticker: owner, role, transaction code (P open-market purchase, S sale, A award, M exercise, F tax withholding), shares, price, dollar value, and a 10b5-1 plan flag. Code P is the only own-money buy signal; A/M/F are automatic compensation. Set form=3/5 for holdings statements or form=144 for notices of proposed sale (an intent-to-sell signal that precedes the Form 4). Pass ticker='latest' for the market-wide feed of the biggest open-market buys, or ticker='clusters' for companies where several insiders bought at once.
daysformlimitticker必填min_insidersGet 8-K material events
8-K material events for a ticker as typed items (2.02 earnings, 5.02 executive change, 1.05 cybersecurity incident, 2.01 acquisition, etc.), each with a notable flag for the market-moving ones and a link to the filing. Pass item to filter to one event type (e.g. '4.02' for every restatement a company filed). Pass ticker='restatements' or 'auditor-changes' for the market-wide red-flag feed of recent item 4.02 / 4.01 8-Ks across all filers.
daysitemlimitticker必填notableGet 13F institutional holdings
A fund's latest 13F portfolio parsed from the SEC information table: every position ranked by value, aggregated by CUSIP across sub-managers, options flagged put/call, and diffed against the prior quarter (new / added / reduced / exited). Identify the fund by a known name (berkshire, burry, ackman, bridgewater, citadel), a CIK, or a filer ticker (BRK-B).
limitchangesidentifier必填Get 13D/13G >5% activist stakes
Schedule 13D/13G filings, the disclosure anyone crossing 5% of a company's voting stock must make. A 13D signals possible activist intent; a 13G is a passive large holder. Each record has the issuer, CUSIP, reporting person(s), and exact percent of class. Pass identifier='latest' for the market-wide feed of new >5% stakes, or a ticker for the stakes indexed on that company.
limitidentifier必填min_percentactivist_onlyResolve a ticker, CIK, or CUSIP
Map any one of a ticker, CIK, or CUSIP to the canonical SEC entity: legal name, CIK, ticker(s), exchange, SIC industry and sector, state of incorporation, and location. The foundational lookup for identifying a filer.
cikcusiptickerFull-text search across SEC filings
Search the full text of every SEC filing since 2001 (the EDGAR full-text index). Returns matching filing documents with company, form, date, 8-K item codes, and a SEC.gov link. Quote a phrase for exact match; filter by form and date range.
q必填enddtformslimitoffsetstartdtConvert SEC XBRL to JSON
The full XBRL-to-JSON converter. By default returns a company's normalized income statement, balance sheet and cash flow across every reported period, plus a concept index of every us-gaap/dei tag it reports. Pass `concept` to pull the raw time series for any specific tag(s) beyond the curated fundamentals; pass `accession` for every concept reported in one specific filing.
ciklimitperiodtickerconceptaccessionGet shares outstanding & public float
Common shares outstanding (latest + history) and public float for a ticker, from the SEC XBRL cover-page tags. Shares outstanding updates every 10-Q/10-K; public float is reported on the 10-K cover. The inputs for market-cap and free-float math.
ticker必填historyGet Form D private placements
Parsed Form D notices — the filing a company makes when it raises money in a private placement under a Regulation D exemption. Each carries the issuer, jurisdiction, industry, amount offered and sold, the exemption, related persons, and date of first sale. Pass a CIK (or ticker if public) for one issuer, or 'latest' for the market-wide feed of new private raises.
limitidentifier必填Get company subsidiaries (10-K Exhibit 21)
The company's subsidiaries and their jurisdictions of incorporation, parsed from Exhibit 21 of its latest 10-K. Best-effort parse of an HTML exhibit; empty for filers that list only significant subsidiaries or file no Exhibit 21.
ticker必填Get federal contract opportunities (SAM.gov)
Federal contract opportunities from SAM.gov — solicitations, presolicitations, sources-sought, and award notices — normalized into flat JSON. Each carries the notice id, title, solicitation number, posted date, type, set-aside, NAICS, place of performance, award (when present), a point of contact, and the sam.gov link. Leave the dates off for the recent feed; SAM caps a query window at one year.
limitnaicsptypestatetitleoffsetposted_toset_asideposted_fromGet federal awards (USAspending)
Federal spending awards from USAspending.gov — contracts, grants, loans, and direct payments — normalized into flat JSON. Each carries the award id, recipient, amount, awarding agency, type, dates, place of performance, description, and the usaspending.gov link. Pick one category per call; leave dates off for the last year. Pairs with get_opportunities: the SAM solicitation, then who won the awards here.
endpagelimitstartstateagencykeywordcategoryrecipientGet federal grant opportunities (Grants.gov)
Federal grant funding opportunities from Grants.gov, normalized into flat JSON. Each carries the opportunity id and number, title, agency, status, open and close dates, the Assistance Listing (CFDA) numbers, and the grants.gov link. Defaults to open opportunities (posted + forecasted). Completes the gov-funding trio with get_opportunities (contracts) and get_awards (spending).
alnlimitagencyoffsetstatuskeywordcategoryGet congressional stock trades (House STOCK Act)
Congressional stock trades parsed from US House STOCK Act periodic transaction reports, normalized to flat JSON: member, state/district, ticker, buy or sell, the disclosed dollar range, transaction and disclosure dates, and a House disclosure PDF link. Pass a ticker for one stock, or omit it for the recent feed. House-only for now (Senate coming); amounts are ranges and disclosure lags the trade by up to 45 days.
limitactionticker已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
{ "mcpServers": { "edgrapi": { "url": "https://api.edgrapi.com/mcp", "headers": { "Authorization": "Bearer edgr_YOUR_KEY" } } }}# Python clientpip install edgrapi
# Docker — the MCP server as a containerdocker run -e EDGRAPI_API_KEY=edgr_... ghcr.io/paperandbeyond23-gif/edgrapi-mcp:latest
# Python skills from this repo, via the skills CLInpx skills add paperandbeyond23-gif/edgrapi-skills --allnpx skills add paperandbeyond23-gif/edgrapi-skills --skill edgrapi-fullexport EDGRAPI_KEY="edgr_..."