Primary Sources

io.github.simonmak-ascentv1.1.1更新于 Oct 3, 2026

Free primary-source APIs across 8 categories, with provenance envelopes.

已验证Streamable HTTP可网页运行Web Search & ScrapingData & AnalyticsKnowledge & Memory

概览

AI 生成的概览

为助手提供 50 个只读工具，覆盖免费的公共一手数据 API，包括 SEC 文件、公司注册、宏观、新闻、研究与开放数据。

功能
提供八大类共 50 个工具：filings（SEC EDGAR、HKEXnews）、registries（英国 Companies House、GLEIF、ACRA、EU VIES）、macro（世界银行、FRED、HKMA、DBnomics、ECB、美国财政部、联合国、WHO）、news（GDELT、Hacker News、Wikimedia 页面浏览量）、open-data（DATA.GOV.HK、CKAN、data.europa.eu）、research（Crossref、OpenAlex、arXiv、PubMed、Europe PMC、DataCite、DOAJ、Zenodo、Semantic Scholar）、knowledge（Wikidata、Wikipedia、Open Library、Internet Archive、地理编码、天气、地震、GBIF、PubChem、openFDA、ClinicalTrials.gov、NASA APOD）以及 tools（MCP Registry 搜索、Jina Reader）。每个结果都带有 source、retrievedAt 和 data 的来源信息封装，便于助手引用出处和时间。
适用场景
当助手需要可引用的原始来源而非一般网页答案时适用：公司文件与注册记录、经济与发展指标、学术文献、官方开放数据目录或参考事实。大多数工具无需密钥，便于试用。
运行要求
可作为远程 Streamable HTTP 端点使用，也可通过 npx 在本地运行，需要 Node.js 20 或更高版本，无运行时依赖。50 个工具中有 47 个无需密钥；COMPANIES_HOUSE_API_KEY 启用两个英国 Companies House 工具，FRED_API_KEY 启用一个 FRED 工具。NCBI_API_KEY 和 NASA_API_KEY 为可选的速率限制提升，RESEARCH_CONTACT 为可选的礼貌联系字符串。需要访问上游公共 API 的网络连接。
安装前请注意
所有工具看起来都是只读的，服务器本身未声明身份验证。可选的密钥 COMPANIES_HOUSE_API_KEY、FRED_API_KEY、NCBI_API_KEY 和 NASA_API_KEY 会发送给服务器或进程，应按凭据对待。查询和抓取的 URL 会发往第三方公共 API，且各来源许可不同：Wikipedia 为 CC BY-SA 需要署名，而 HKEXnews、GDELT 和 SEC 文件为按需抓取、不再分发。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Primary Sources，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "primary-sources-mcp": {
      "type": "http",
      "url": "https://primary-sources-mcp.vercel.app/mcp"
    }
  }
}

README

primary-sources-mcp

Free primary-source APIs for AI agents. 50 tools across 8 categories — filings, registries, macro, news, open-data, research, knowledge and tools. SEC EDGAR, HKEXnews, World Bank, GDELT, DATA.GOV.HK, HKMA, the official MCP Registry, UK Companies House, FRED and Jina Reader — as MCP tools, each result wrapped in a { source, retrievedAt, data } provenance envelope.

[CI] [Secret Scan] [MCP Tool Definition Quality] [MCP Registry] [Glama] [License: MIT]

Overview

Zero runtime dependencies. Node >= 20. 50 tools, 47 of them keyless.

Quick start

json
{  "mcp": {    "primary-sources": {      "type": "local",      "command": ["npx", "-y", "@simonmak-ascent/primary-sources-mcp"],      "enabled": true,      "timeout": 120000    }  }}

Hosted (Streamable HTTP): https://primary-sources-mcp.vercel.app/mcp.

Tools by category

filings

ToolSourceKey
sec_edgar_fulltextSEC EDGAR full-text search (US filings)none
sec_edgar_companySEC EDGAR registrant + recent filingsnone
hkex_announcementsHKEXnews listed-company announcement search (HK)none
hkex_companyHKEXnews listed-company resolve + recent filingsnone

registries

ToolSourceKey
companies_house_searchUK Companies House searchCOMPANIES_HOUSE_API_KEY
companies_house_companyUK Companies House recordCOMPANIES_HOUSE_API_KEY
gleif_leiGLEIF Legal Entity Identifier records (CC0)none
acra_sg_companyACRA Singapore corporate registry (data.gov.sg)none
vies_vatEU VIES VAT validationnone

macro

ToolSourceKey
world_bank_indicatorWorld Bank development indicatorsnone
fred_seriesSt. Louis Fed FRED seriesFRED_API_KEY
hkmaHong Kong Monetary Authority public APInone
dbnomics_seriesDBnomics (World Bank, IMF, OECD, Eurostat, ECB, BIS, …)none
ecb_seriesECB Data Portal (SDMX-JSON)none
treasury_fiscalUS Treasury Fiscal Datanone
un_sdgUN Sustainable Development Goal indicatorsnone
un_comtradeUN Comtrade trade statisticsnone
who_ghoWHO Global Health Observatorynone

news

ToolSourceKey
gdelt_newsGDELT DOC 2.0 global newsnone
hn_searchHacker News (Algolia)none
wikimedia_pageviewsWikimedia pageview metrics (CC0)none

open-data

ToolSourceKey
hk_open_data_searchDATA.GOV.HK catalogue searchnone
hk_open_data_filterDATA.GOV.HK filter APInone
ckan_searchCKAN portals (data.gov.uk, data.gov.au)none
data_europa_searchdata.europa.eu EU open-data cataloguenone

research

ToolSourceKey
crossref_worksCrossref DOI metadatanone
openalex_worksOpenAlex scholarly worksnone
arxiv_searcharXiv preprintsnone
pubmed_searchPubMed (NCBI E-utilities)none (optional NCBI_API_KEY)
europepmc_searchEurope PMCnone
datacite_doisDataCite research-data DOIsnone
doaj_articlesDirectory of Open Access Journalsnone
zenodo_recordsZenodo research outputsnone
semantic_scholar_worksSemantic Scholar (rate-limited keyless)none

knowledge

ToolSourceKey
wikidata_searchWikidata entities (CC0)none
wikipedia_summaryWikipedia summaries (CC BY-SA)none
open_library_searchOpen Library booksnone
gutendex_booksProject Gutenberg via Gutendexnone
internet_archive_searchInternet Archivenone
world_bank_countryWorld Bank country reference metadatanone
nominatim_geocodeOpenStreetMap Nominatim geocodingnone
open_meteo_forecastOpen-Meteo current weathernone
usgs_earthquakesUSGS earthquake cataloguenone
gbif_speciesGBIF taxonomic backbonenone
pubchem_compoundPubChem compound datanone
openfda_drugopenFDA drug adverse eventsnone
clinicaltrials_studyClinicalTrials.gov studiesnone
nasa_apodNASA Astronomy Picture of the Daynone (optional NASA_API_KEY)

tools

ToolSourceKey
mcp_registry_searchOfficial MCP Registrynone
jina_readJina Reader (URL → markdown)none (free tier)

Environment

VariableRequiredPurpose
RESEARCH_CONTACTnoUser-Agent contact string (politeness for SEC/GDELT/OpenAlex).
COMPANIES_HOUSE_API_KEYfor 2 toolsFree key from Companies House.
FRED_API_KEYfor 1 toolFree key from the St. Louis Fed.
NCBI_API_KEYnoRaises PubMed (NCBI) rate limits.
NASA_API_KEYnoRaises NASA APOD limits (falls back to shared DEMO_KEY).

Provenance & attribution

Every data tool returns text of the form:

json
{ "source": "World Bank Indicators", "retrievedAt": "2026-10-02T16:00:00.000Z", "data": { } }

so an agent can cite the origin and time of every fact.

Source licences vary: GLEIF and Wikidata are CC0; World Bank, Crossref, OpenAlex, DataCite, DOAJ, Zenodo, GBIF, openFDA, ClinicalTrials.gov and US government data are public-domain/open; ACRA is under the Singapore Open Data Licence; Wikipedia is CC BY-SA (attribution required); HKEXnews, GDELT and SEC filings are retrieved link-first and fetched on demand, not redistributed.

Development

bash
npm installnpm run typechecknpm testnpm run buildnode dist/index.js   # stdio MCP server

License

MIT — see LICENSE.

来源：README.md，提交 c9c3a95

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.1.1最新Oct 3, 2026