GRESB Server

MCP server for the GRESB Real Estate ESG Benchmarking API.

Requires GRESB Official Partner API access.

Auth

Pass your GRESB API token as a Bearer token:

Authorization: Bearer <your-gresb-api-token>

Tools

Tool	Description
list_entities	List all GRESB entities accessible with your API key
get_entity	Get entity details (name, type, country, total assets)
get_assessment_scores	Total/management/performance scores + green star rating
get_benchmark	Entity scores vs peer group median and top quartile
get_indicators	Indicator-level scores for management, performance, or all
get_peer_comparison	Entity rank among peers + scores vs peer average
submit_indicator	Submit survey indicator responses programmatically

All tools accept an optional year parameter (default: current assessment year).

Endpoints

• POST /mcp — MCP protocol endpoint
• GET /health — Health check

Getting API Access

Apply at gresb.com as an Official Data Partner.

Local Development

npm install
npm run dev

Deployment

Configured for Railway via railway.toml. Set no env vars required at start — credentials are passed per-request via the Authorization header.