Edgrapi — Sec Edgar Financials

by paperandbeyond23-gif

189 downloads

Not rated

GitHub

About

Clean SEC EDGAR company financials, ratios, filings, and 10-K/10-Q sections as normalized JSON — a hosted MCP server with 5 tools and a free tier.

Details

Author: paperandbeyond23-gif
Downloads: 189
Categories: Finance, Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Edgrapi — Sec Edgar Financials

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

From the repository

{
  "mcpServers": {
    "edgrapi": {
      "url": "https://api.edgrapi.com/mcp",
      "transport": "streamable-http"
    }
  }
}

`get_fundamentals`

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.

`get_ratios`

Margins, returns (ROE/ROA), leverage and liquidity ratios for a ticker, derived from SEC EDGAR fundamentals. Price-based ratios (P/E, P/B) excluded.

`get_company`

CIK, legal name, SIC industry, fiscal-year end, exchanges and website for a ticker, resolved from SEC EDGAR submissions.

`get_filings`

Recent SEC filings for a ticker (10-K/10-Q/8-K) with filing/report dates and document links.

`get_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.

`get_insider`

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. 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 (the cluster-buy signal).

`get_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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "edgrapi \u2014 sec edgar financials": {
            "edgrapi": {
                "url": "https://api.edgrapi.com/mcp",
                "transport": "streamable-http"
            }
        }
    }
}

McpServers

{
    "edgrapi": {
        "url": "https://api.edgrapi.com/mcp",
        "transport": "streamable-http"
    }
}

Clean SEC EDGAR company financials, ratios, filings, and 10-K/10-Q sections as normalized JSON — a hosted MCP server with 5 tools and a free tier.

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 theEdgrapi REST API.

EDGAR 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.

Free to start —grab a key(100 free credits, no card required) and you're pulling fundamentals from Claude, ChatGPT, Cursor, or your own agent loop in under two minutes.

Pure Python standard library. No dependencies. MIT-0 licensed.

# Claude Code, Cursor, Cline, etc. — skills CLI, installs straight from this repo npx skills add paperandbeyond23-gif/edgrapi-skills --all # or pick one: npx skills add paperandbeyond23-gif/edgrapi-skills --skill edgrapi-full # OpenClaw / ClawHub — published to the ClawHub registry npx clawhub@latest install edgrapi-full # also: edgrapi-fundamentals, edgrapi-filings

Install the bundlededgrapi-fullfor agents that need broad coverage. Install the focused variants when you want minimum tool surface.

Set theEDGRAPI_KEYenvironment variable to your Edgrapi key (formatedgr_...). It's sent as theX-API-Keyheader — the base URL is hardcoded, so the key never reaches any other host.

Get a free key— 100 free credits, no card required. The same key works for these skills and direct REST calls.

1 credit = 1 request. Credits never expire. All data is from public SEC EDGAR.

Top-up packs (one-time, never expire): 10,000 / $7 · 30,000 / $18 · 100,000 / $55.

Manage plans at https://edgrapi.com/pricing. Also available metered on RapidAPI.

- Docs:https://edgrapi.com/docs· OpenAPI:https://edgrapi.com/openapi.json
- Quickstart: get a key at https://edgrapi.com/app, then call any tool

See CONTRIBUTING.md. Security reports:SECURITY.md.

MIT No Attribution. Fork, ship, sublicense — no attribution required.

Edgrapi 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.

English background checks on Korean (KRX) stocks from DART filings: dilution history, delisting-risk flags, every claim linked to the original filing.

Access and analyze Federal Reserve (FOMC) statements.

SEC EDGAR filings, treasury rates, labor statistics, and economic indicators for financial research

Access ROIC.AI financial data from AI tools, including company financials, ratios, prices, transcripts, and market research data.

Hosted MCP server for AI-enriched financial news — full-text and ticker-scoped news search, trending stories, and SEC Form 4 insider activity, each story scored 1–10 for relevance (OAuth 2.1, free tier 100 calls/hour).

Read-only MCP for U.S. household financial distress data: 96 indicators, the American Distress Index (ADI), and county-level distress scores for all 3,144 U.S. counties.

Hosted MCP server for Chinese A-share and ETF market data, including prices, fundamentals, capital flows, financial statements, real-time quotes, and news.

Free crypto address labels. Identify known addresses on major networks with a free API.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_fundamentals

get_ratios

get_company

get_filings

get_sections

get_insider

get_events

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`get_fundamentals`

`get_ratios`

`get_company`

`get_filings`

`get_sections`

`get_insider`

`get_events`