io.github.paperandbeyond23-gif/edgrapi-skills

edgrapi-skills

US government data for AI agents — five official sources, one key, one JSON schema.

SAM.gov contract opportunities, USAspending awards, Grants.gov funding, US House STOCK Act trades, and SEC EDGAR filings, served as a hosted MCP server plus drop-in Python skills, over the Edgrapi API.

Every one of those sources is free and public. Each also ships its own headache: SAM.gov takes ncode where you'd expect naics and silently ignores unknown filters, its dates are MM/dd/yyyy and its query window caps at a year; USAspending's hasNext goes false at record 10,000 while real rows continue to 50,000; EDGAR gives you XBRL tag drift. Edgrapi normalises all of it into one schema so your agent gets numbers it can trust in one call.

Free to start — grab a key, 50 free credits to start, no card.

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

Fastest path: the hosted MCP server

Nothing to install, no local process. Point any MCP client at one URL:

{
  "mcpServers": {
    "edgrapi": {
      "url": "https://api.edgrapi.com/mcp",
      "headers": { "Authorization": "Bearer edgr_YOUR_KEY" }
    }
  }
}

Works in Claude Desktop, Claude Code, Cursor and Cline. Transport is streamable-http. Auth is a bearer edgr_ key or OAuth 2.1 with PKCE — the server is its own provider and supports dynamic client registration. Discovery (initialize, tools/list) is open, so you can inspect the full tool list before you have a key; tools/call needs one.

Other ways in

# Python client
pip install edgrapi

# Docker — the MCP server as a container
docker run -e EDGRAPI_API_KEY=edgr_... ghcr.io/paperandbeyond23-gif/edgrapi-mcp:latest

# Python skills from this repo, via the skills CLI
npx skills add paperandbeyond23-gif/edgrapi-skills --all
npx skills add paperandbeyond23-gif/edgrapi-skills --skill edgrapi-full

Also listed in the Official MCP Registry as io.github.paperandbeyond23-gif/edgrapi-skills.

What the MCP server covers

19 tools, all read-only.

For the live list, call tools/list or read the server card — both are generated from the server, so neither goes stale.

Skills in this repo

Drop-in Python, pure standard library. Install all of them or just the one you need.

Authentication

Set EDGRAPI_KEY to your key (format edgr_...). It is sent as the X-API-Key header, and the base URL is hardcoded, so the key never reaches any other host.

export EDGRAPI_KEY="edgr_..."

Get a free key — 50 credits to start, no card. The same key works for the skills, the MCP server and direct REST.

Pricing

Credits are weighted by endpoint, not one per request. Government endpoints cost 2. On the SEC side, company, filings, events, entity resolution and full-text search cost 1; fundamentals, ratios and XBRL cost 3; sections, insider, holdings and activist cost 5. The exact cost of a call comes back in the X-Credits-Cost header.

Top-up packs, one-time and never expiring: 5,000 / $7 · 15,000 / $18 · 50,000 / $55. Paid-plan credits roll over. Full details at https://edgrapi.com/pricing. Also available metered on RapidAPI.

Limits, stated plainly

• Congressional trades are US House only, reported as dollar ranges, and lag up to 45 days by law.
• No state or local (SLED) procurement. Federal only.
• Contract alerts poll daily, not in realtime, so a notice can be up to a day old when it lands.
• Freshness is each source's own cadence. Edgrapi normalises the official feeds; it does not hold or restate anything.
• USAspending search cannot reach before 2007-10-01, and EDGAR full-text search covers 2001 onward.

Source

• Docs: https://edgrapi.com/docs · OpenAPI 3.1: https://edgrapi.com/openapi.json
• Agent guide: https://edgrapi.com/agents · Status: https://edgrapi.com/status

Issues and contributions

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

License

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

Independence

Edgrapi is an independent service, not affiliated with, endorsed by or sponsored by the U.S. Securities and Exchange Commission, the General Services Administration, SAM.gov, USAspending.gov, Grants.gov, or the U.S. House of Representatives. All data originates from those bodies' public systems and is in the public domain.