ESG Hub MCP Server

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "ESG Hub MCP Server": {
      "url": "https://esg-hub.ascent.partners/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (12)

• get_server_info read-only

  Use this first to confirm the ESG Hub MCP server is reachable and see its version and API base. It performs one liveness round-trip and returns only server metadata — name, version, API base, tool_count, and healthy — and never fails on an unreachable API: it returns healthy=false rather than an error. For sections, pillars, source domains, or totals use get_esg_metadata.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• search_esg read-only

  Exact keyword (BM25) search across ESG Hub articles and curated external resources. Use when the user supplies a specific term, identifier, or phrase (e.g., 'GRI 305', 'Scope 3'); for paraphrased or conceptual questions prefer search_content, which adds semantic similarity. Terms are matched individually, not as one exact phrase, and `source` narrows to 'pages' (ESG Hub articles) or 'external' (curated third-party URLs). Returns one ranked page of up to `limit` (max 50) items — there is no pagination, so raise `limit` to widen; zero matches returns an empty item list, not an error. Reads are cached ~2 minutes and rate-limited per IP; a 5xx means the API is redeploying — retry shortly.

  Parameters:

  • query (required) — string — Search query (e.g., 'carbon emissions', 'GRI standards')
  • limit — number — Maximum number of results
  • source — string — Filter by source type

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• search_content read-only

  Hybrid search that fuses 384-dim semantic similarity with BM25 and ESG re-ranking across ESG Hub articles and external resources. Use for conceptual or paraphrased questions — natural-language phrases work better than single tokens because `query` is embedded; when the user gives an exact identifier or phrase prefer the cheaper search_esg. `query` must be non-empty and `limit` defaults to 10 and is capped at 50. Returns one ranked page of up to `limit` items, each carrying a fused relevance score (higher is better); there is no pagination, so raise `limit` to widen, and unlike search_esg there is no `source` filter. Zero matches returns an empty item list, not an error. Cached ~2 minutes; rate-limited per IP; retry on 5xx.

  Parameters:

  • query (required) — string — Search query (e.g., 'carbon emissions', 'board diversity')
  • limit — number — Maximum number of results

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• get_esg_page read-only

  Read one ESG Hub article in full, addressed by permalink (e.g., 'standards/gri-101'), bare slug, or record ID ('page:abc123'). Use it once search_esg, search_content, or list_esg_pages has returned an identifier; to fetch a page's neighbours rather than its content use get_related. Returns the complete article body plus section, pillar, keywords, and canonical URL. It resolves only `page` records — a resource URL returns NOT_FOUND — and a redirect-only record resolves to its target; an unknown identifier returns NOT_FOUND. Cached ~10 minutes; rate-limited per IP; retry on 5xx.

  Parameters:

  • page_id (required) — string — Page identifier — permalink path, slug, or record ID (e.g., 'page:abc123')

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• list_esg_pages read-only

  Enumerate ESG Hub articles, optionally filtered by `section`, `pillar`, or a title substring (`query` — an exact substring, not fuzzy). Use it to browse a whole section; to find articles by meaning use search_content. Results are ordered by section then title and returned one page at a time: pass the response's `next_offset` back as `offset` until `has_more` is false. `section` and `pillar` values must be taken from get_esg_metadata, and `offset` is a raw row count so advance it by `limit`; `limit` caps at 100 (default 20). A filter that matches nothing, or an `offset` past the end, returns an empty item list with `has_more=false`. Cached ~5 minutes; rate-limited per IP; retry on 5xx.

  Parameters:

  • limit — number — Results per page
  • query — string — Filter by title substring
  • offset — number — Pagination offset — pass the previous next_offset
  • pillar — string — Filter by pillar (e.g., 'Environmental', 'Standards')
  • section — string — Filter by section (e.g., 'environmental', 'standards')

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• list_esg_resources read-only

  Enumerate curated external ESG resources (standards bodies, regulators, tools, databases) with their source URLs, optionally filtered by exact source `domain` or a title substring (`query` — an exact substring, not fuzzy). Use it to assemble authoritative references; for ESG Hub's own articles use list_esg_pages. Results are ordered by title and paged: pass `next_offset` back as `offset`, advancing it by `limit` (a raw row count). `domain` must be a host from get_esg_metadata's domain list; `limit` caps at 100 (default 20). A filter that matches nothing, or an `offset` past the end, returns an empty item list with `has_more=false`. Cached ~5 minutes; rate-limited per IP; retry on 5xx.

  Parameters:

  • limit — number — Results per page
  • query — string — Filter by title substring
  • domain — string — Filter by source domain (e.g., 'ghgprotocol.org')
  • offset — number — Pagination offset — pass the previous next_offset

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• get_esg_metadata read-only

  Discover the filter vocabulary for the knowledge base: total counts plus the exact `section`, `pillar`, and source-`domain` values with their counts. Call it before list_esg_pages or list_esg_resources so filters match real values; for server version and health use get_server_info. It takes no parameters, returns a single object (never paginated), and the lists are seeded reference values that change only on deploy, so they can be cached within a session. Cached ~10 minutes; rate-limited per IP; retry on 5xx.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• get_term read-only

  Look up one glossary term by record ID ('term:abc123'), permalink, or exact name and return its full definition and facets. Use it when the user asks 'what is <term>'; to find terms by topic, or across all content, use search_esg or search_content, and to survey the glossary use list_terms. Name matching is exact (case-insensitive) with no fuzzy or partial matching, and it returns a single term, never a list. The `definition` field is the authoritative text and `facets` carries the topic/content_type classification; an unknown identifier returns NOT_FOUND. Cached ~10 minutes; rate-limited per IP; retry on 5xx.

  Parameters:

  • term_id (required) — string — Term identifier — slug/name (e.g., 'materiality') or record ID (e.g., 'term:abc123')

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• get_related read-only

  Traverse the ESG Hub knowledge graph one hop from a page and return every connected record grouped by edge type. Use it after get_esg_page when you need neighbouring concepts; to read a page's own content use get_esg_page. Returns at most 15 related pages and, today, only `related_pages` edges; a page with no links returns an empty group list, not an error. There is no pagination. `record_id` accepts a `page:` record ID or a permalink; `edge_type` filters the result to one edge type (default: all). Cached ~10 minutes; rate-limited per IP; retry on 5xx.

  Parameters:

  • record_id (required) — string — Page record ID (e.g., 'page:abc123') or permalink/slug
  • edge_type — string — Optional filter: only return edges of this type

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• list_frameworks read-only

  Enumerate the ESG reporting frameworks and standards the knowledge base covers (GRI, SASB/ISSB, TCFD, ESRS, CDP, TNFD, …), with each framework's abbreviation, description, and official website. Use it to discover coverage; for the ESG Hub articles that explain a standard use list_esg_pages with section='standards'. Results are ordered by name and paged: pass `next_offset` back as `offset`, a raw row count so advance it by `limit`; `limit` defaults to 20 and is capped at 100. An `offset` past the end returns an empty `items` list with `has_more=false`. Cached ~10 minutes; rate-limited per IP; retry on 5xx.

  Parameters:

  • limit — number — Results per page
  • offset — number — Pagination offset — pass the previous next_offset

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• list_industries read-only

  Return the ESG Hub industry taxonomy (IFRS/SASB-style): every industry with its stable `industry_id`, English/Chinese names, and the `sector_id` it belongs to. Use it to obtain valid industry values for tag_content or to group coverage by sector; for article sections and source domains use get_esg_metadata. It takes no parameters and returns the complete taxonomy in one response (no pagination). The taxonomy is seeded reference data, not derived from articles, so it is stable across sessions and cached ~10 minutes; rate-limited per IP; retry on 5xx.

  Hints: read-only yes · destructive not declared · idempotent yes · open-world no

• list_terms read-only

  Enumerate glossary terms, optionally filtered by an exact name substring (`query` — case-insensitive, not fuzzy). Use it to survey the glossary or page through terminology; to fetch one term's definition use get_term, and to search all content use search_esg or search_content. Results are ordered by name and paged: pass `next_offset` back as `offset` (a raw row count, so advance it by `limit`); `limit` defaults to 20 and is capped at 100. A query that matches nothing, or an `offset` past the end, returns an empty item list with `has_more=false`. Cached ~10 minutes; rate-limited per IP; retry on 5xx.

  Parameters:

  • limit — number — Results per page
  • query — string — Filter by name substring (case-insensitive)
  • offset — number — Pagination offset — pass the previous next_offset

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.