MCP Radar
MCP-Server

ESG Hub MCP Server

io.github.simonmak-ascent/esg-hub
Wissen & Dokumentation Recht & Compliance Suche & Recherche Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Searches and manages an ESG knowledge base covering articles, reporting frameworks, glossary terms, industries, external resources and related content.

Funktionen

Tools

15 Tools
flag_content
Flag Content for Curation
Queue one ESG Hub page for human curation — delist, remove, or review — with a reason. Nothing changes immediately: the call records a pending request and returns a `proposal_id`; the page is not modified until a curator approves it. Use it when an article is outdated, duplicated, or inaccurate; to edit its facet tags instead use tag_content. `action` controls the requested outcome: `delist` hides the page from listings, `remove` deletes it, and `review` (the default) flags it for a curator to decide. Give `page_id` as a permalink, slug, or record ID (resolved server-side) and a `reason` of at least 10 characters. Requires ESG_HUB_WRITE_TOKEN; rate-limited.
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['page_id', 'reason'], 'properties': {'action': {'enum': ['delist', 'remove', 'review'], 'type': 'string', 'default': 'review', 'description': 'Requested outcome: delist (hide from listings), remove (delete), or review (default)'}, 'reason': {'type': 'string', 'maxLength': 1000, 'minLength': 10, 'description': 'Why the page should be curated (min 10 characters)'}, 'page_id': {'type': 'string', 'minLength': 1, 'description': "Page permalink, slug, or record ID (e.g., 'page:abc123')"}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['proposal_id', 'status'], 'properties': {'status': {'type': 'string'}, 'proposal_id': {'type': 'string'}}, 'additionalProperties': False}
get_esg_metadata
Get Knowledge Base Stats
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.
Nur Lesen Idempotent
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['stats', 'sections', 'pillars', 'domains'], 'properties': {'stats': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'number'}}, 'domains': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'pillars': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}, 'sections': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}, 'additionalProperties': False}
get_esg_page
Get ESG Article
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.
Nur Lesen Idempotent
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['page_id'], 'properties': {'page_id': {'type': 'string', 'minLength': 1, 'description': "Page identifier â\x80\x94 permalink path, slug, or record ID (e.g., 'page:abc123')"}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['page'], 'properties': {'page': {'type': 'object', 'properties': {'id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pillar': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'section': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'permalink': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': False}
get_related
Get Related Content
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.
Nur Lesen
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['record_id'], 'properties': {'edge_type': {'type': 'string', 'description': 'Optional filter: only return edges of this type'}, 'record_id': {'type': 'string', 'minLength': 1, 'description': "Page record ID (e.g., 'page:abc123') or permalink/slug"}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['record_id', 'total', 'edge_types', 'edges_grouped'], 'properties': {'total': {'type': 'number'}, 'record_id': {'type': 'string'}, 'edge_types': {'type': 'array', 'items': {'type': 'string'}}, 'edges_grouped': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pillar': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'section': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'permalink': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}}}, 'additionalProperties': False}
get_server_info
Get Server Info
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.
Nur Lesen Idempotent
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'version', 'api_base', 'tool_count', 'healthy'], 'properties': {'name': {'type': 'string'}, 'healthy': {'type': 'boolean'}, 'version': {'type': 'string'}, 'api_base': {'type': 'string'}, 'tool_count': {'type': 'number'}}, 'additionalProperties': False}
get_term
Get Glossary Term
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.
Nur Lesen Idempotent
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['term_id'], 'properties': {'term_id': {'type': 'string', 'minLength': 1, 'description': "Term identifier â\x80\x94 slug/name (e.g., 'materiality') or record ID (e.g., 'term:abc123')"}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['term'], 'properties': {'term': {'type': 'object', 'properties': {'id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pillar': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'section': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'permalink': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': False}
list_esg_pages
List ESG Articles
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.
Nur Lesen
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Results per page'}, 'query': {'type': 'string', 'description': 'Filter by title substring'}, 'offset': {'type': 'number', 'default': 0, 'minimum': 0, 'description': 'Pagination offset â\x80\x94 pass the previous next_offset'}, 'pillar': {'type': 'string', 'description': "Filter by pillar (e.g., 'Environmental', 'Standards')"}, 'section': {'type': 'string', 'description': "Filter by section (e.g., 'environmental', 'standards')"}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items', 'pagination'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pillar': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'section': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'permalink': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'pagination': {'type': 'object', 'required': ['count', 'total', 'offset', 'has_more', 'next_offset'], 'properties': {'count': {'type': 'number'}, 'total': {'type': 'number'}, 'offset': {'type': 'number'}, 'has_more': {'type': 'boolean'}, 'next_offset': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': False}
list_esg_resources
List External Resources
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.
Nur Lesen
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Results per page'}, 'query': {'type': 'string', 'description': 'Filter by title substring'}, 'domain': {'type': 'string', 'description': "Filter by source domain (e.g., 'ghgprotocol.org')"}, 'offset': {'type': 'number', 'default': 0, 'minimum': 0, 'description': 'Pagination offset â\x80\x94 pass the previous next_offset'}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items', 'pagination'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pillar': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'section': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'permalink': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'pagination': {'type': 'object', 'required': ['count', 'total', 'offset', 'has_more', 'next_offset'], 'properties': {'count': {'type': 'number'}, 'total': {'type': 'number'}, 'offset': {'type': 'number'}, 'has_more': {'type': 'boolean'}, 'next_offset': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': False}
list_frameworks
List Reporting Frameworks
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.
Nur Lesen
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Results per page'}, 'offset': {'type': 'number', 'default': 0, 'minimum': 0, 'description': 'Pagination offset â\x80\x94 pass the previous next_offset'}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items', 'pagination'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pillar': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'section': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'permalink': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'pagination': {'type': 'object', 'required': ['count', 'total', 'offset', 'has_more', 'next_offset'], 'properties': {'count': {'type': 'number'}, 'total': {'type': 'number'}, 'offset': {'type': 'number'}, 'has_more': {'type': 'boolean'}, 'next_offset': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': False}
list_industries
List Industries
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.
Nur Lesen Idempotent
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['count', 'industries'], 'properties': {'count': {'type': 'number'}, 'industries': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pillar': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'section': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'permalink': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}}, 'additionalProperties': False}
list_terms
List Glossary Terms
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.
Nur Lesen
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Results per page'}, 'query': {'type': 'string', 'maxLength': 200, 'description': 'Filter by name substring (case-insensitive)'}, 'offset': {'type': 'number', 'default': 0, 'minimum': 0, 'description': 'Pagination offset â\x80\x94 pass the previous next_offset'}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['items', 'pagination'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pillar': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'section': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'permalink': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'pagination': {'type': 'object', 'required': ['count', 'total', 'offset', 'has_more', 'next_offset'], 'properties': {'count': {'type': 'number'}, 'total': {'type': 'number'}, 'offset': {'type': 'number'}, 'has_more': {'type': 'boolean'}, 'next_offset': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': False}
propose_term
Propose Glossary Term
Submit a new glossary term for human review. Nothing is published immediately: the call creates a pending proposal and returns a `proposal_id`; a reviewer decides whether it goes live, and only an approved term later appears in get_term. Use it only when the user explicitly wants to contribute a term; to look one up use get_term. `name` is the display name and `definition` must be at least 10 characters; `facets` is optional and its values should come from get_esg_metadata / list_industries vocabularies. Requires a write token in ESG_HUB_WRITE_TOKEN — a missing or invalid token returns 401 — and calls are rate-limited.
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'definition'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "The glossary term name (e.g., 'Materiality Assessment')"}, 'facets': {'type': 'object', 'properties': {'topic': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic areas'}, 'industry': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Relevant industries'}, 'framework': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Related frameworks/standards'}, 'stakeholder': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Affected stakeholder groups'}, 'content_type': {'type': 'string', 'description': 'Content classification'}, 'jurisdiction': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Relevant jurisdictions'}}, 'description': 'Optional metadata facets for the term'}, 'definition': {'type': 'string', 'maxLength': 5000, 'minLength': 10, 'description': 'Full definition of the term (min 10 characters)'}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['proposal_id', 'status'], 'properties': {'status': {'type': 'string'}, 'proposal_id': {'type': 'string'}}, 'additionalProperties': False}
search_content
Search ESG (hybrid)
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.
Nur Lesen
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'number', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results'}, 'query': {'type': 'string', 'minLength': 1, 'description': "Search query (e.g., 'carbon emissions', 'board diversity')"}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'mode', 'total', 'count', 'items'], 'properties': {'mode': {'type': 'string'}, 'count': {'type': 'number'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pillar': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'section': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'permalink': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'query': {'type': 'string'}, 'total': {'type': 'number'}}, 'additionalProperties': False}
search_esg
Search ESG (keyword)
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.
Nur Lesen
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'limit': {'type': 'number', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results'}, 'query': {'type': 'string', 'minLength': 1, 'description': "Search query (e.g., 'carbon emissions', 'GRI standards')"}, 'source': {'enum': ['all', 'pages', 'external'], 'type': 'string', 'default': 'all', 'description': 'Filter by source type'}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query', 'total', 'count', 'items'], 'properties': {'count': {'type': 'number'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pillar': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'section': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'permalink': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'relevance': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'query': {'type': 'string'}, 'total': {'type': 'number'}}, 'additionalProperties': False}
tag_content
Tag Content Facets
Replace the facet tags on one existing ESG Hub page: `topic`, `industry`, `framework`, `jurisdiction`, `stakeholder`, and `content_type`. The supplied `facets` object replaces the page's facet set, so any facet key you omit is cleared; the page body and title are never changed or deleted. The response echoes the page's new `facets` and `updated_at`. The array facets (`topic`, `industry`, `framework`, `jurisdiction`, `stakeholder`) each accept multiple values, while `content_type` is a single string; values are validated against the vocabulary from get_esg_metadata / list_industries, and an unrecognised value or key is rejected with 400. Give `page_id` as a permalink, slug, or record ID — permalinks are resolved to the underlying record server-side. Use it to curate tags; to read a page use get_esg_page, and to queue a removal use flag_content. Requires ESG_HUB_WRITE_TOKEN; rate-limited.
Eingabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['page_id', 'facets'], 'properties': {'facets': {'type': 'object', 'properties': {'topic': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic classifications'}, 'industry': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Relevant industry sectors'}, 'framework': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Related ESG frameworks/standards'}, 'stakeholder': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Stakeholder groups affected'}, 'content_type': {'type': 'string', 'description': "Content type (e.g., 'guide', 'reference')"}, 'jurisdiction': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Applicable jurisdictions'}}, 'description': 'Facet tags to apply to the page'}, 'page_id': {'type': 'string', 'minLength': 1, 'description': "Page permalink, slug, or record ID (e.g., 'page:abc123')"}}}
Ausgabeschema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['page_id', 'title', 'facets', 'updated_at'], 'properties': {'title': {'type': 'string'}, 'facets': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'page_id': {'type': 'string'}, 'updated_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}
Verlauf

Letzte Tool-Änderungen

Hinzugefügt
flag_content
4. October 2026 02:40
Hinzugefügt
tag_content
4. October 2026 02:40
Hinzugefügt
propose_term
4. October 2026 02:40
Hinzugefügt
list_terms
4. October 2026 02:40
Hinzugefügt
list_industries
4. October 2026 02:40
Hinzugefügt
list_frameworks
4. October 2026 02:40
Hinzugefügt
get_related
4. October 2026 02:40
Hinzugefügt
get_term
4. October 2026 02:40
Hinzugefügt
get_esg_metadata
4. October 2026 02:40
Hinzugefügt
list_esg_resources
4. October 2026 02:40
Hinzugefügt
list_esg_pages
4. October 2026 02:40
Hinzugefügt
get_esg_page
4. October 2026 02:40
Hinzugefügt
search_content
4. October 2026 02:40
Hinzugefügt
search_esg
4. October 2026 02:40
Hinzugefügt
get_server_info
4. October 2026 02:40
Entdecken

Ähnliche MCP-Server

BNM Data Shop

io.github.bnmbnmai/bnm-data-shop

Sells access to cached official reports, enforcement orders, regulatory documents, inspection records, and other public-source te…

OpenHelvetia Gateway

swiss.openhelvetia/gateway

Provides sourced access to Swiss federal legislation and political data, including law metadata, versions, amendments, citations,…

Court Listener

io.github.pipeworx-io/court-listener

Searches and retrieves US court opinions, case citations, federal docket filings, and related legal documents.

Gov Uk Content

io.github.pipeworx-io/gov-uk-content

Searches and retrieves GOV.UK content, government organisations, and HMRC manuals, sections, and revision histories.

OpenCaseLaw — Swiss Caselaw, Statutes & Doctrine

ch.opencaselaw/swiss-caselaw

Searches and analyzes Swiss court decisions, statutes, doctrine, legislation, legal scholarship, citation graphs, and administrat…

Epstein

io.github.pipeworx-io/epstein

Searches, inventories, and retrieves documents from the House Oversight Committee’s Epstein investigation corpus, including fligh…

Crs Reports

io.github.pipeworx-io/crs-reports

Searches, retrieves, and summarizes Congressional Research Service reports, topics, legislation analysis, and recent publications.

Eu Parliament

io.github.pipeworx-io/eu-parliament

Provides European Parliament open data on MEPs, plenary documents, sessions, and related parliamentary records.