ESG knowledge base for AI agents: hybrid search, glossary, frameworks, industries, graph traversal.
One address for any MCP client. No sign-in needed on this server.
12 read1 act2 other
Grouped by tool name. At most: creates or changes data: records, files, settings.
Odel charges nothing per call. The publisher may charge for its own service.
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
/api/v1@esg-hub/mcp-serverflowchart 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
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
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.
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"]
Next.js 15 (App Router, React 19) · SurrealDB Cloud · Tailwind CSS v4 · next-intl · Vitest + Playwright · Vercel
Fastest path — nothing to install: use the live site and the open API.
GET https://esg-hub.ascent.partners/api/v1/pagesRun a local copy:
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.
GET /api/v1/pages, /api/v1/search?q=..., /api/v1/resources, /api/v1/meta (docs)mcp-server/ — gives AI agents tools to search and read the knowledge baseUp-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
An Ascent Partners Foundation project.
If this saves you time, a ⭐ on GitHub helps others find it.