{
  "markdown": "# edgrapi-skills\n\n**Agent skills for clean company financials from SEC EDGAR.** Drop-in skills that let any agent pull normalized income/balance/cash-flow fundamentals, computed ratios, company profiles, and recent SEC filings for any US-listed ticker — over the [Edgrapi REST API](https://edgrapi.com).\n\nEDGAR is free, but its XBRL company-facts payloads are brutal to parse (tag drift, mixed periods, trailing-twelve-month windows hiding inside 10-Qs). Edgrapi normalizes all of that into clean JSON, keyed by fiscal period — so your agent gets numbers it can trust in one call.\n\nFree to start — [grab a key](https://edgrapi.com/app) (100 free credits every month, no card required) and you're pulling fundamentals from Claude, ChatGPT, Cursor, or your own agent loop in under two minutes.\n\nPure Python standard library. No dependencies. MIT-0 licensed.\n\n## Install\n\n```bash\n# Claude Code, Cursor, Cline, etc. — `skills` CLI, installs straight from this repo\nnpx skills add paperandbeyond23-gif/edgrapi-skills --all\n# or pick one: npx skills add paperandbeyond23-gif/edgrapi-skills --skill edgrapi-full\n\n# OpenClaw / ClawHub — published to the ClawHub registry\nnpx clawhub@latest install edgrapi-full   # also: edgrapi-fundamentals, edgrapi-filings\n```\n\n## Use it as an MCP server\n\nThe skills above are one way in. The other is the hosted MCP server — point any MCP client at a\nsingle URL, with nothing to install and no local process:\n\n```json\n{\n  \"mcpServers\": {\n    \"edgrapi\": {\n      \"url\": \"https://api.edgrapi.com/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer edgr_YOUR_KEY\" }\n    }\n  }\n}\n```\n\nWorks in Claude Desktop, Claude Code, Cursor and Cline. Transport is streamable-http. Auth is\n`Authorization: Bearer edgr_...`, or OAuth 2.1 — the server is its own provider. Discovery\n(`initialize`, `tools/list`) is open, so you can inspect the tool list without a key; `tools/call`\nneeds one.\n\nThe MCP surface is wider than the skills in this repo: alongside fundamentals and filings it covers\nForm 4 insider trades with cluster-buy detection, typed 8-K material events, 13F fund holdings\ndiffed quarter-over-quarter, 13D/13G >5% activist stakes, XBRL-to-JSON, shares outstanding, entity\nresolution, and full-text search across every filing since 2001. For the live list, call\n`tools/list` or read the [server card](https://api.edgrapi.com/.well-known/mcp/server-card.json) —\nboth are generated from the server itself, so neither goes stale.\n\n## Skills in this repo\n\n| Skill | Purpose |\n|---|---|\n| [`edgrapi-full`](skills/edgrapi-full) | Complete toolkit — fundamentals, ratios, company profile, and filings |\n| [`edgrapi-fundamentals`](skills/edgrapi-fundamentals) | Normalized financial statements + computed ratios |\n| [`edgrapi-filings`](skills/edgrapi-filings) | Company profiles + recent SEC filings (10-K/10-Q/8-K) |\n\nInstall the bundled `edgrapi-full` for agents that need broad coverage. Install the focused variants when you want minimum tool surface.\n\n## Tools\n\n| Tool | Returns |\n|---|---|\n| `get_fundamentals(ticker, period, limit)` | Income statement, balance sheet, cash flow — periodized, USD |\n| `get_ratios(ticker)` | Margins, returns (ROE/ROA), leverage, liquidity |\n| `get_company(ticker)` | CIK, legal name, SIC industry, fiscal-year end, exchanges, website |\n| `get_filings(ticker, limit, form)` | Recent filings with filing/report dates and document links |\n\n## Authentication\n\nSet the `EDGRAPI_KEY` environment variable to your Edgrapi key (format `edgr_...`). It's sent as the `X-API-Key` header — the base URL is hardcoded, so the key never reaches any other host.\n\n```bash\nexport EDGRAPI_KEY=\"edgr_...\"\n```\n\n**[Get a free key](https://edgrapi.com/app)** — 100 free credits every month, no card required. The same key works for these skills and direct REST calls.\n\n## Pricing\n\nCredits are weighted by endpoint, not one per request: company, filings, events, entity resolution\nand full-text search cost 1; fundamentals, ratios and XBRL cost 3; sections, insider, holdings and\nactivist cost 5. Credits never expire. All data is from public SEC EDGAR.\n\n| Plan | Price | Credits |\n|---|---|---|\n| Free | $0 | 100 / month |\n| Starter | $10/mo | 10,000 / month |\n| Pro (monthly) | $29/mo | 30,000 / month |\n| Pro (annual) | $290/yr | 360,000 up front |\n\nTop-up packs (one-time, never expire): 5,000 / $7 · 15,000 / $18 · 50,000 / $55.\n\nManage plans at <https://edgrapi.com/pricing>. Also available metered on RapidAPI.\n\n## Source\n\n- Docs: <https://edgrapi.com/docs> · OpenAPI: <https://edgrapi.com/openapi.json>\n- Quickstart: get a key at <https://edgrapi.com/app>, then call any tool\n\n## Issues and contributions\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md). Security reports: [SECURITY.md](SECURITY.md).\n\n## License\n\n[MIT No Attribution](LICENSE). Fork, ship, sublicense — no attribution required.\n\n## Independence\n\nEdgrapi is an independent service and is not affiliated with, endorsed by, or sponsored by the U.S. Securities and Exchange Commission. All data originates from the SEC's public EDGAR system. \"EDGAR\" is a system operated by the U.S. SEC.\n",
  "bytes": 5080,
  "sha": "7c97d650ea3a9560acd5d0373d02c8078442d88f927d0ad556965af2fd487a77",
  "repo_slug": "paperandbeyond23-gif/edgrapi-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_paperandbeyond23_gif_edgrapi_s_68399a06/readme"
}