MCP server: One MCP server.

ESG Hub MCP Server

@ascent-partnersRun by its publisher: served from their own domain, namespace checked by the registry.MCP server · External

ESG knowledge base for AI agents: hybrid search, glossary, frameworks, industries, graph traversal.

v1.4.3MITTypeScript
Freeno charge per call

One address for any MCP client. No sign-in needed on this server.

What it does

12 read1 act2 other

Grouped by tool name. At most: creates or changes data: records, files, settings.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Tools

15 · grouped by tool name · checked 15 Oct 2026

Read · 12Look things up

  • get_server_info
  • search_esg
  • search_content
  • get_esg_page
  • list_esg_pages
  • list_esg_resources
  • get_esg_metadata
  • get_term
  • get_related
  • list_frameworks
  • list_industries
  • list_terms

Act · 1Change something

  • propose_term

Other · 2Neither hinted nor named

  • tag_content
  • flag_content
Try it in the Inspector
README3 min read

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.

Deploy to Vercel MCP Registry Glama License: MIT (code) Content: CC BY-SA 4.0

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

mermaid
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

mermaid
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

mermaid
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

mermaid
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:

bash
git clone https://github.com/simonmak-ascent/esg-hub.git
cd esg-hub
pnpm install        # note: requires sibling repo ../tool_package (private)
cp .env.example .env  # fill in your own values
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:

text
use library /simonmak-ascent/esg-hub for API and docs

License

  • Code: MIT
  • Encyclopedia content: CC BY-SA 4.0 by Ascent Partners Foundation

An Ascent Partners Foundation project.

If this saves you time, a ⭐ on GitHub helps others find it.

Similar modules