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