# Primary Sources

> Open-source (MIT) MCP server exposing free primary-source APIs for AI agents: SEC EDGAR, World Bank, GDELT, DATA.GOV.HK, HKMA, the official MCP Registry, UK Companies House, FRED and Jina Reader. 12 tools, 10 of them keyless; every result is wrapped in a `{ source, retrievedAt, data }` provenance envelope. Zero runtime dependencies; Node >= 20.

## Connect

- Hosted MCP endpoint (Streamable HTTP, no API key): https://primary-sources-mcp.vercel.app/mcp
- Local stdio server: `npx -y @simonmak-ascent/primary-sources-mcp`
- Official MCP Registry name: `io.github.simonmak-ascent/primary-sources-mcp`
- Glama listing: https://glama.ai/mcp/servers/simonmak-ascent/primary-sources-mcp

## MCP tools

All tools are read-only and return a provenance envelope. Optional free keys: `COMPANIES_HOUSE_API_KEY`, `FRED_API_KEY` (`RESEARCH_CONTACT` recommended for polite API use).

- `sec_edgar_fulltext`, `sec_edgar_company`: US SEC EDGAR full-text search and registrant profile + recent filings (no key)
- `world_bank_indicator`: World Bank development indicators (no key)
- `gdelt_news`: GDELT DOC 2.0 global news article search and trends (no key)
- `hk_open_data_search`, `hk_open_data_filter`: DATA.GOV.HK catalogue search and resource filtering (no key)
- `hkma`: Hong Kong Monetary Authority public API (no key)
- `mcp_registry_search`: Official MCP Registry search (no key)
- `jina_read`: fetch any URL as clean markdown via Jina Reader (no key)
- `companies_house_search`, `companies_house_company`: UK Companies House (free key)
- `fred_series`: FRED economic series observations (free key)

## Docs

- [Website](https://primary-sources-mcp.vercel.app/)
- [Source code](https://github.com/simonmak-ascent/primary-sources-mcp)
- [npm package](https://www.npmjs.com/package/@simonmak-ascent/primary-sources-mcp)

## Author
Simon Mak — https://simonmak.com