Edgrapi Skills

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

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取金融商業與電商

概覽

AI 產生的概覽

託管型 MCP 伺服器,為助理提供正規化的 JSON 資料:SEC EDGAR 財報與內部人交易、13F 持股,以及美國聯邦合約、撥款、補助和國會議員交易。

可以做什麼
  • 公司與文件查詢:解析股票代號、CIK 與 CUSIP,列出近期 10-K/10-Q/8-K 文件,全文檢索 2001 年以來的 EDGAR,並擷取風險因素、管理層討論等敘述章節
  • 財務資料:正規化損益表、資產負債表和現金流量表,計算比率,流通股與公眾持股量,以及原始 XBRL 標籤時間序列
  • 持股與事件追蹤:Form 4 內部人交易、逐季比較的 13F 基金持股、13D/13G 大額持股,以及分類的 8-K 重大事件
  • 聯邦採購與資金檢索:SAM.gov 合約機會、USAspending 授標、Grants.gov 補助機會
  • 取得美國眾議院 STOCK 法案揭露的國會議員股票交易
適用情境
適合股票研究、盡職調查和公共部門市場研究:助理需要以一致結構取得 SEC 財務、文件或持股資料,或聯邦合約、補助與授標資料,而不必直接處理原始政府資料來源。
執行需求
可使用遠端 streamable-HTTP 端點,或在本地執行 Docker 映像。呼叫工具需要 Edgrapi API 金鑰,放在 EDGRAPI_API_KEY 中(格式 edgr_...);僅瀏覽工具清單不需金鑰。免費額度為 50 點,另有付費方案和加值包。需要能連線至 Edgrapi API 的網路。
安裝前請注意
每次呼叫依端點消耗付費點數(1 至 5 點),大量使用會用盡免費額度並需購買方案。API 金鑰屬機密,會傳送給第三方服務。資料為唯讀,但來自第三方:國會交易僅涵蓋美國眾議院,以金額區間揭露且依法最多延遲 45 天,資料新鮮度取決於各來源自身的更新節奏。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Edgrapi Skills,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.paperandbeyond23-gif%2Fedgrapi-skills/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "edgrapi-skills": {
      "type": "http",
      "url": "https://api.edgrapi.com/mcp"
    }
  }
}

README

edgrapi-skills

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.

Fastest path: the hosted MCP server

Nothing to install, no local process. Point any MCP client at one URL:

json
{  "mcpServers": {    "edgrapi": {      "url": "https://api.edgrapi.com/mcp",      "headers": { "Authorization": "Bearer edgr_YOUR_KEY" }    }  }}

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.

Other ways in

bash
# 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-full

Also listed in the Official MCP Registry as io.github.paperandbeyond23-gif/edgrapi-skills.

What the MCP server covers

19 tools, all read-only.

SourceToolsCredits
SAM.govget_opportunities — contract opportunities by NAICS, set-aside, state, type2
USAspendingget_awards — contracts, grants, loans, direct payments2
Grants.govget_grants — funding opportunities with CFDA numbers and deadlines2
Congressget_congress — US House STOCK Act stock trades2
SEC EDGARget_insider (Form 4, with cluster-buy detection), get_holdings (13F, diffed quarter-over-quarter), get_activist (13D/G >5% stakes), get_events (typed 8-K), get_fundamentals, get_ratios, get_sections, get_company, get_filings, XBRL-to-JSON, entity resolution, full-text search1–5

For the live list, call tools/list or read the server card — both are generated from the server, so neither goes stale.

Skills in this repo

Drop-in Python, pure standard library. Install all of them or just the one you need.

SkillToolsPurpose
edgrapi-full9Everything below in one skill, across all five sources
edgrapi-gov5SAM.gov opportunities, USAspending awards, Grants.gov, congressional trades
edgrapi-fundamentals2Normalised financial statements + computed ratios
edgrapi-filings2Company profiles + recent 10-K/10-Q/8-K

Authentication

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.

bash
export EDGRAPI_KEY="edgr_..."

Get a free key — 50 credits to start, no card. The same key works for the skills, the MCP server and direct REST.

Pricing

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.

PlanPriceCredits
Free$050 to start (one-time)
Starter$10/mo10,000 / month
Pro$29/mo30,000 / month
Pro annual$290/yr360,000 up front
Business$99/mo150,000 / month

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.

Limits, stated plainly

  • Congressional trades are US House only, reported as dollar ranges, and lag up to 45 days by law.
  • No state or local (SLED) procurement. Federal only.
  • Contract alerts poll daily, not in realtime, so a notice can be up to a day old when it lands.
  • Freshness is each source's own cadence. Edgrapi normalises the official feeds; it does not hold or restate anything.
  • USAspending search cannot reach before 2007-10-01, and EDGAR full-text search covers 2001 onward.

Source

Issues and contributions

See CONTRIBUTING.md. Security reports: SECURITY.md.

License

MIT No Attribution. Fork, ship, sublicense — no attribution required.

Independence

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

工具

19

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必填

get_ratios

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_company

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_filings

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_sections

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_insider

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_insiders

get_events

Get 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必填notable

get_holdings

Get 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_activist

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_only

resolve_entity

Resolve 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.

輸入參數cikcusipticker

search_filings

Full-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必填enddtformslimitoffsetstartdt

get_xbrl

Convert 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.

輸入參數ciklimitperiodtickerconceptaccession

get_shares

Get 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必填history

get_form_d

Get 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_subsidiaries

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_opportunities

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_from

get_awards

Get 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.

輸入參數endpagelimitstartstateagencykeywordcategoryrecipient

get_grants

Get 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).

輸入參數alnlimitagencyoffsetstatuskeywordcategory

get_congress

Get 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

版本歷史

3
  1. v1.3.1最新Oct 16, 2026
  2. v1.3.0Sep 23, 2026
  3. v1.2.1Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Restosignals 整合