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_..."