edgrapi-skills
US government + SEC data as clean JSON: SAM.gov, USAspending, Grants.gov, Congress, SEC filings.
我該用這個嗎
品質與安全性
發現項目（4）
- LOWTool 'get_ratios' description lacks action verb在 get_ratios 中
- LOWTool 'get_company' description lacks action verb在 get_company 中
- LOWTool 'get_filings' description lacks action verb在 get_filings 中
- LOWTool 'resolve_entity' description lacks action verb在 resolve_entity 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"edgrapi-skills": {
"url": "https://api.edgrapi.com/mcp"
}
}
}遠端端點
https://api.edgrapi.com/mcpstreamable-http它能做什麼
工具清單
工具（19）
🟢get_fundamentals(ticker, period, limit)
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.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US stock ticker, e.g. 'AAPL'."
},
"period": {
"type": "string",
"description": "Reporting period (default annual).",
"enum": [
"annual",
"quarterly"
]
},
"limit": {
"type": "integer",
"description": "Number of periods to return, 1-20 (default 5)."
}
},
"required": [
"ticker"
]
}🟢get_ratios(ticker)
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.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US stock ticker, e.g. 'AAPL'."
}
},
"required": [
"ticker"
]
}🟢get_company(ticker)
CIK, legal name, SIC industry, fiscal-year end, exchanges and website for a ticker, resolved from SEC EDGAR submissions.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US stock ticker, e.g. 'AAPL'."
}
},
"required": [
"ticker"
]
}🟢get_filings(ticker, limit, form)
Recent SEC filings for a ticker (10-K/10-Q/8-K) with filing/report dates and document links.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US stock ticker, e.g. 'AAPL'."
},
"limit": {
"type": "integer",
"description": "Number of filings to return, 1-100 (default 20)."
},
"form": {
"type": "string",
"description": "Optional form filter, e.g. '10-K', '10-Q', '8-K'."
}
},
"required": [
"ticker"
]
}🟢get_sections(ticker, form, item)
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.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US stock ticker, e.g. 'AAPL'."
},
"form": {
"type": "string",
"description": "Filing type: '10-K' (default) or '10-Q'."
},
"item": {
"type": "string",
"description": "Section to fetch, e.g. '1A' (Risk Factors) or '7' (MD&A). Omit to list available sections."
}
},
"required": [
"ticker"
]
}🟢get_insider(ticker, limit, form, days, min_insiders)
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.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US stock ticker (e.g. 'AAPL'), 'latest' for market-wide buys, or 'clusters' for cluster buys."
},
"limit": {
"type": "integer",
"description": "Number of results, 1-100 (default 20)."
},
"form": {
"type": "string",
"enum": [
"3",
"4",
"5",
"144"
],
"description": "Ownership form: 4 (trades, default), 3 (initial holdings), 5 (annual), or 144 (notice of proposed sale — an intent-to-sell signal that precedes the Form 4)."
},
"days": {
"type": "integer",
"description": "For 'clusters': lookback window in days (default 15)."
},
"min_insiders": {
"type": "integer",
"description": "For 'clusters': min distinct insiders (default 3)."
}
},
"required": [
"ticker"
]
}🟢get_events(ticker, limit, notable, item, days)
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.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US stock ticker (e.g. 'AAPL'), or 'restatements' / 'auditor-changes' for the market-wide item feed."
},
"limit": {
"type": "integer",
"description": "Number of events, 1-100 (default 20; 50 for feeds)."
},
"notable": {
"type": "boolean",
"description": "Only market-moving events (default false)."
},
"item": {
"type": "string",
"description": "Filter to a specific 8-K item code, or comma-separated codes, e.g. '4.02' (restatement) or '5.02,2.02'."
},
"days": {
"type": "integer",
"description": "For the market-wide feeds: lookback window in days (default 45)."
}
},
"required": [
"ticker"
]
}🟢get_holdings(identifier, limit, changes)
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).
輸入結構描述
{
"type": "object",
"properties": {
"identifier": {
"type": "string",
"description": "Fund name (e.g. 'berkshire', 'burry', 'pershing-square'), a CIK, or a ticker whose company files the 13F (e.g. BRK-B)."
},
"limit": {
"type": "integer",
"description": "Max positions, 1-500 (default 50)."
},
"changes": {
"type": "boolean",
"description": "Diff vs the prior quarter (default true)."
}
},
"required": [
"identifier"
]
}🟢get_activist(identifier, activist_only, min_percent, limit)
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.
輸入結構描述
{
"type": "object",
"properties": {
"identifier": {
"type": "string",
"description": "'latest' for the market-wide >5% feed, or a US ticker (e.g. 'AAPL') for stakes indexed on that company."
},
"activist_only": {
"type": "boolean",
"description": "For 'latest': keep only 13D (activist-intent) filings (default false)."
},
"min_percent": {
"type": "number",
"description": "For 'latest': minimum percent of class (default 0)."
},
"limit": {
"type": "integer",
"description": "Number of filings, 1-100 (default 40)."
}
},
"required": [
"identifier"
]
}🟢resolve_entity(ticker, cik, 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.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US stock ticker, e.g. 'AAPL'."
},
"cik": {
"type": "string",
"description": "SEC CIK, e.g. '320193' (zero-padding optional)."
},
"cusip": {
"type": "string",
"description": "9-character CUSIP, e.g. '037833100'."
}
}
}🟢search_filings(q, forms, startdt, enddt, limit, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Search query. Quote a phrase (\"climate change\") for an exact match; space-separated terms are ANDed."
},
"forms": {
"type": "string",
"description": "Comma-separated form filter, e.g. '8-K' or '10-K,10-Q'."
},
"startdt": {
"type": "string",
"description": "Only filings on/after this date, YYYY-MM-DD."
},
"enddt": {
"type": "string",
"description": "Only filings on/before this date, YYYY-MM-DD."
},
"limit": {
"type": "integer",
"description": "Results to return, 1-100 (default 20)."
},
"offset": {
"type": "integer",
"description": "Pagination offset into the result set (default 0)."
}
},
"required": [
"q"
]
}🟢get_xbrl(ticker, cik, concept, accession, period, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US stock ticker, e.g. 'AAPL'."
},
"cik": {
"type": "string",
"description": "SEC CIK, alternative to ticker."
},
"concept": {
"type": "string",
"description": "Comma-separated us-gaap/dei tag(s) to return the raw series for, e.g. 'Revenues,Assets'. Omit for normalized statements + concept index."
},
"accession": {
"type": "string",
"description": "An accession (e.g. '0000320193-24-000123') to return every XBRL concept reported in that one filing. Overrides ticker/concept."
},
"period": {
"type": "string",
"enum": [
"annual",
"quarterly"
],
"description": "Statement period (default annual)."
},
"limit": {
"type": "integer",
"description": "Max periods per statement, 1-100 (default 40)."
}
}
}🟢get_shares(ticker, history)
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.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US stock ticker, e.g. 'AAPL'."
},
"history": {
"type": "boolean",
"description": "Include the full reported history (default false)."
}
},
"required": [
"ticker"
]
}🟢get_form_d(identifier, limit)
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.
輸入結構描述
{
"type": "object",
"properties": {
"identifier": {
"type": "string",
"description": "Issuer CIK (Form D issuers are usually private), a ticker if public, or 'latest' for the market-wide feed."
},
"limit": {
"type": "integer",
"description": "Number of notices, 1-100 (default 20 for latest, 10 per issuer)."
}
},
"required": [
"identifier"
]
}🟢get_subsidiaries(ticker)
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.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "US stock ticker or CIK, e.g. 'AAPL'."
}
},
"required": [
"ticker"
]
}🟢get_opportunities(posted_from, posted_to, naics, ptype, state, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"posted_from": {
"type": "string",
"description": "Posted-date start, YYYY-MM-DD (default: 30 days ago)."
},
"posted_to": {
"type": "string",
"description": "Posted-date end, YYYY-MM-DD (default: today)."
},
"naics": {
"type": "string",
"description": "NAICS code filter, up to 6 digits, e.g. '541519'."
},
"ptype": {
"type": "string",
"description": "Procurement type: o solicitation, p presolicitation, a award, etc."
},
"state": {
"type": "string",
"description": "Place-of-performance state, e.g. 'TX'."
},
"set_aside": {
"type": "string",
"description": "Set-aside code, e.g. 'SBA', '8A', 'WOSB', 'HZC'."
},
"title": {
"type": "string",
"description": "Match on opportunity title."
},
"limit": {
"type": "integer",
"description": "Records to return, 1-200 (default 20)."
},
"offset": {
"type": "integer",
"description": "Pagination offset (default 0)."
}
}
}🟢get_awards(category, keyword, agency, recipient, state, ...)
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.
輸入結構描述
{
"type": "object",
"properties": {
"category": {
"type": "string",
"description": "contracts (default), idvs, grants, loans, direct_payments, or other."
},
"keyword": {
"type": "string",
"description": "Full-text keyword filter."
},
"agency": {
"type": "string",
"description": "Awarding agency, top-tier exact name, e.g. 'Department of Defense'."
},
"recipient": {
"type": "string",
"description": "Recipient name search, e.g. 'Lockheed'."
},
"state": {
"type": "string",
"description": "Place-of-performance state, e.g. 'CA'."
},
"start": {
"type": "string",
"description": "Action-date start, YYYY-MM-DD (default: 1 year ago)."
},
"end": {
"type": "string",
"description": "Action-date end, YYYY-MM-DD (default: today)."
},
"limit": {
"type": "integer",
"description": "Records to return, 1-100 (default 20)."
},
"page": {
"type": "integer",
"description": "Page number (default 1)."
}
}
}🟢get_grants(keyword, status, agency, category, aln, ...)
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).
輸入結構描述
{
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "Full-text keyword filter."
},
"status": {
"type": "string",
"description": "Pipe/comma list of forecasted, posted, closed, archived (default posted|forecasted)."
},
"agency": {
"type": "string",
"description": "Agency code filter, e.g. 'HHS-OPHS'."
},
"category": {
"type": "string",
"description": "Funding category code, e.g. 'HL' (health)."
},
"aln": {
"type": "string",
"description": "Assistance Listing (CFDA) number, e.g. '93.217'."
},
"limit": {
"type": "integer",
"description": "Records to return, 1-100 (default 20)."
},
"offset": {
"type": "integer",
"description": "Start record number (default 0)."
}
}
}🟢get_congress(ticker, action, limit)
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.
輸入結構描述
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "Stock ticker for one-stock history, e.g. 'NVDA'. Omit for the recent feed."
},
"action": {
"type": "string",
"description": "Filter the feed to 'buy' or 'sell'."
},
"limit": {
"type": "integer",
"description": "Trades to return, 1-100 (default 40)."
}
}
}社群
證據