Use Edgrapi from your AI agent
Two ways to give an agent access to the data: install the skill, or connect the hosted MCP server. Either way you get the same four tools and the same API key, and it works with Claude, Cursor, Cline or anything else that speaks MCP.
Option A: the agent skill
Installs four tools into your agent (get_fundamentals, get_ratios,
get_company, get_filings) from the public repo. It's pure standard library,
with no dependencies to install.
npx skills add paperandbeyond23-gif/edgrapi-skills --skill edgrapi-fullFocused variants: edgrapi-fundamentals (statements + ratios) and
edgrapi-filings (profile + filings). Set your key first:
export EDGRAPI_KEY=edgr_...Option B: the hosted MCP server
A remote MCP server speaking JSON-RPC 2.0 over Streamable HTTP. Point any MCP client at it and authenticate with a Bearer key.
Endpoint: https://api.edgrapi.com/mcp
Transport: streamable-http
Auth: Authorization: Bearer edgr_...Discovery (initialize, tools/list) is open; your key is required on
tools/call and meters against your plan exactly like the REST API.
The four tools
| Tool | Returns |
|---|---|
get_fundamentals | Income statement, balance sheet, cash flow (annual/quarterly) |
get_ratios | Margins, ROE/ROA, leverage, liquidity, growth |
get_company | CIK, legal name, SIC industry, exchange, fiscal-year end |
get_filings | Recent 10-K/10-Q/8-K filings with document links |
Example prompts
- "What were Apple's revenue and net income the last four years?" → get_fundamentals
- "Compute NVIDIA's margins, ROE and debt-to-equity." → get_ratios
- "List Tesla's most recent 10-K filings with links." → get_filings
- "What industry and exchange is MSFT on, and its fiscal-year end?" → get_company
edgr_ key works for the skill,
the MCP server, and direct REST calls. Get one free at the dashboard.