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 集成