# Gresb MCP

> Access GRESB Real Estate Assessment data via API — retrieve entity scores, management and performance component breakdown, benchmark against peer groups, query indicator-level responses, and submit survey data. Use when asked about GRESB scores, ESG benchmarking, peer comparison, assessment preparation, or programmatic GRESB data submission. Requires GRESB Official Partner API key.

- Skill: `soapboxbuild/gresb-mcp` (Agent Skill)
- Install (CLI): `npx skillmds@latest add soapboxbuild/gresb-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/soapboxbuild/gresb-mcp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: soapboxbuild (https://skillmd.com/u/soapboxbuild)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/soapboxbuild/gresb-mcp

---


# GRESB API MCP

## Available Tools
- `list_entities` — list all GRESB entities your API key can access
- `get_entity` — entity details (name, type, country, total assets)
- `get_assessment_scores` — total/management/performance scores + Green Star rating by year
- `get_benchmark` — entity scores vs peer group median and top quartile
- `get_indicators` — indicator-level responses for management or performance components
- `get_peer_comparison` — entity rank among peers, percentile, number of peers
- `submit_indicator` — submit a survey indicator response programmatically

## Score Structure
- **Total**: Management (30%) + Performance (70%)
- **Green Star**: ≥50 score + top 3 quintiles
- **5-Star Green Star**: top quintile AND score ≥70

## Authentication
GRESB Official Partner API key — set `GRESB_API_KEY` or pass as Bearer token.
Apply at gresb.com for Official Data Partner status.
In Soapbox: Settings → Plugins → GRESB Reporting → Add key.