# GRESB MCP Server

MCP server for the [GRESB](https://www.gresb.com/) 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](https://gresb.com) as an Official Data Partner.

## Local Development

```bash
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.