get_fundamentalsLABSCO SUMMARY
Someone else parsed XBRL so you do not have to.
The pitch is narrow and checkable: EDGAR is free but its company-facts payloads hide trailing-twelve-month windows inside quarterlies and drift across tags, and this returns periodized statements you can put straight into a model. Independence is stated plainly — Edgrapi is not affiliated with the SEC, and all the underlying data is public EDGAR.
What it is
Agent skills over the Edgrapi REST API, with a hosted MCP endpoint alongside them. EDGAR's XBRL company-facts payloads are the raw material; what arrives is normalized JSON keyed by fiscal period, so the agent gets periodized numbers instead of tag drift and overlapping windows.
What you get
- Income statement, balance sheet and cash flow, periodized and in USD —
get_fundamentals, taking a ticker, period and limit - Computed ratios — margins, ROE and ROA, leverage and liquidity —
get_ratios - The company record: CIK, legal name, SIC industry, fiscal-year end, exchanges and website —
get_company - Recent filings with filing and report dates and document links, filterable by form —
get_filings - Three install shapes: the bundled
edgrapi-fullskill, or the narroweredgrapi-fundamentalsandedgrapi-filingswhen you want a smaller tool surface - A remote MCP endpoint at
https://api.edgrapi.com/mcpover streamable HTTP, declared in the repo's server.json
Requirements
An Edgrapi key in EDGRAPI_KEY, in the form edgr_..., sent as the X-API-Key header — the base URL is hardcoded, so the key reaches no other host. A free key gives 100 one-time credits with no card, and 1 credit is 1 request. Skills install with npx skills add paperandbeyond23-gif/edgrapi-skills --all, or a single one with --skill edgrapi-full; a ClawHub install is documented too. The skills are pure Python standard library with no dependencies, under MIT No Attribution.
Setup effort
One command plus a key — npx skills add paperandbeyond23-gif/edgrapi-skills --all, then supply credentials
USE CASES
01
Pulling a company's numbers mid-analysis
Ask for fundamentals by ticker and period and get statements you can use without normalizing them first.
02
Comparing two companies on the same basis
Read computed ratios for each rather than deriving margins and returns by hand.
03
Checking what a company actually filed
List recent filings by form and follow the document links to the source.
04
Resolving a ticker to the filing entity
Read the CIK, legal name, industry code and fiscal-year end before pulling anything else.
4 tools
Listed in project docs. Your client may show a different list.
get_ratiosget_companyget_filingsBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
EDGRAPI_KEY in your environment
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx skills add paperandbeyond23-gif/edgrapi-skills --allHosted endpoint
ENDPOINT URL
https://api.edgrapi.com/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Claude Code, Cursor, Cline
TERMINAL
npx skills add paperandbeyond23-gif/edgrapi-skills --allThe configuration on this page does not set EDGRAPI_KEY; the project's instructions set it with an export line. That line reaches only programs started from the same terminal, so to supply EDGRAPI_KEY, start your client or the server from that terminal.
OpenClaw — ClawHub
OPENCLAW — CLAWHUB · TERMINAL
npx clawhub@latest install edgrapi-fullThe configuration on this page does not set EDGRAPI_KEY; the project's instructions set it with an export line. That line reaches only programs started from the same terminal, so to supply EDGRAPI_KEY, start your client or the server from that terminal.
