ESG Hub
An open-access encyclopedia of Environmental, Social, and Governance (ESG) knowledge by Ascent Partners Foundation โ 350+ articles, 240+ curated resources, books, courses, AI search, a public REST API, and an MCP server. Available in English, Chinese, and Hindi.

Live site: esg-hub.ascent.partners
Overview
- Knowledge base โ 350+ ESG articles across standards (GRI, IFRS S1/S2, TCFD, TNFD, ESRS), regulations, frameworks, ratings, and regional (HK/APAC) guidance
- AI search โ ask questions in natural language; answers grounded in the knowledge base (SurrealDB BM25 + vector search, DeepSeek, Brave Search across authoritative ESG domains)
- Public REST API โ open access to all content:
/api/v1
- MCP server โ connect AI agents directly:
@esg-hub/mcp-server
- Learning resources โ free courses, books, and a curated video library
- i18n โ English, Chinese, Hindi
Architecture
flowchart TB
U["User / AI agent"] --> WEB["Next.js 15 App Router ยท React 19<br/>next-intl (en / zh / hi)"]
WEB --> DB[("SurrealDB Cloud<br/>BM25 + vector search")]
WEB --> AI["DeepSeek + Brave Search<br/>grounded answers"]
WEB --> API["Public REST API ยท /api/v1"]
API --> MCP["MCP server<br/>@simonmak-ascent/esg-hub-mcp"]
V["Vercel"] --> WEB
How a query is answered
sequenceDiagram
autonumber
actor U as User
participant W as Next.js app (App Router)
participant API as /api/ai-search ยท /api/ai-chat
participant S as search.ts
participant DB as SurrealDB (page ยท section ยท embedding)
participant AI as DeepSeek
participant X as Brave / OpenAlex
U->>W: ask a question
W->>API: POST query (+ locale)
API->>S: search(query)
S->>DB: BM25 keyword + vector (embedding) hybrid ranking
DB-->>S: ranked pages / sections + citations
API->>AI: synthesize answer from ranked context
API->>X: enrich (web + research)
X-->>API: references
API-->>W: streamed answer + citations
W-->>U: grounded response
Data model
erDiagram
PAGE ||--o{ SECTION : contains
SECTION ||--o{ EMBEDDING : "vectorised as"
FRAMEWORK ||--o{ PAGE : classifies
INDUSTRY ||--o{ PAGE : tags
TERM ||--o{ PAGE : defines
PAGE {
string id
string slug
string title
string lang
}
SECTION {
string id
string heading
text body
}
EMBEDDING {
vector vector
string model
}
FRAMEWORK, INDUSTRY and TERM are the facets exposed by the /api/v1/* REST
resources; page, section and embedding are the core SurrealDB tables.
Deployment
flowchart LR
DEV["git push / PR"] --> CI["GitHub Actions<br/>lint ยท test ยท e2e ยท health-check"]
CI --> PREV["Vercel Preview deployment"]
PREV -->|merge to main| PROD["Vercel Production<br/>esg-hub.ascent.partners"]
PROD --> SURF["/api/mcp ยท /api/v1<br/>MCP + REST surfaces"]
Tech Stack
Next.js 15 (App Router, React 19) ยท SurrealDB Cloud ยท Tailwind CSS v4 ยท next-intl ยท Vitest + Playwright ยท Vercel
Quick Start (โค 5 minutes)
Fastest path โ nothing to install: use the live site and the open API.
Run a local copy:
git clone https://github.com/simonmak-ascent/esg-hub.git
cd esg-hub
pnpm install
cp .env.example .env
pnpm dev
Useful commands: pnpm lint ยท npx tsc --noEmit ยท npx vitest run ยท pnpm verify:db
Note: the app renders content from a SurrealDB database โ you need your own instance and content to run a full copy. The public site and API are freely accessible without running anything.
API & MCP
- REST API: open, no auth โ
GET /api/v1/pages, /api/v1/search?q=..., /api/v1/resources, /api/v1/meta (docs)
- MCP server: see
mcp-server/ โ gives AI agents tools to search and read the knowledge base
Contributing
Use with Context7
Up-to-date ESG Hub documentation is indexed on Context7, so coding agents can pull it into context on demand. With the Context7 MCP server or ctx7 CLI installed, name the library in your prompt:
use library /simonmak-ascent/esg-hub for API and docs
License
An Ascent Partners Foundation project.
If this saves you time, a โญ on GitHub helps others find it.