# Build with your AI agent on Cadastre

> Connect Claude Code, Codex, Cursor, GitHub Copilot in VS Code, Claude, ChatGPT, Gemini CLI, or OpenCode to Cadastre's metro-level real-estate data through its remote MCP server or its API.

Cadastre is the data source for real-estate data, except listings: public market, labor, demographic, infrastructure, hazard and health data for every U.S. metro area, each figure with its source. Connect your agent once and ask in plain words.

**One command. No sign-up for the public data; sign in for higher limits.**

## Connect

Add Cadastre's remote MCP server (`https://getcadastre.com/mcp`, Streamable HTTP). The public datasets need no account and no sign-in; for higher limits, sign in with OAuth 2.1 in the browser at `https://getcadastre.com/mcp?auth=required`. In Claude Code:

```sh
claude mcp add --transport http cadastre https://getcadastre.com/mcp
```

Or paste this into an agent that can add MCP servers itself:

```text
Connect to Cadastre's MCP server at https://getcadastre.com/mcp and find metros with population over 500K, manufacturing share of GDP over 8% and unemployment under 5.5%. Rank them on manufacturing share and cite the sources.
```

Or install the Cadastre CLI (no sign-in needed; `cadastre login` for higher limits); `cadastre mcp add` prints your agent's setup (with `--write`, it makes it) ([CLI docs](https://getcadastre.com/docs/cli.md)):

```sh
curl -fsSL https://raw.githubusercontent.com/waratuman/cadastre-cli/main/install.sh | sh
cadastre metros --state TX
cadastre mcp add claude-code
```

## Agents directory

### Claude Code

Anthropic · Terminal. Anthropic's agentic coding tool, in the terminal.

- Works with Cadastre through: the MCP server, the API with a key, and the Cadastre CLI
- Setup: One command
- Guide: [Claude Code + Cadastre](https://getcadastre.com/agents/claude-code.md)

### Codex

OpenAI · Terminal, IDE. OpenAI's coding agent: the Codex CLI, the IDE extension and the ChatGPT desktop app share one MCP configuration.

- Works with Cadastre through: the MCP server, the API with a key, and the Cadastre CLI
- Setup: One command, or `~/.codex/config.toml`
- Guide: [Codex + Cadastre](https://getcadastre.com/agents/codex.md)

### Cursor

Anysphere · IDE. An AI code editor with an agent that can call MCP tools.

- Works with Cadastre through: the MCP server, the API with a key, and the Cadastre CLI
- Setup: `~/.cursor/mcp.json`
- Guide: [Cursor + Cadastre](https://getcadastre.com/agents/cursor.md)

### GitHub Copilot in VS Code

Microsoft and GitHub · IDE, Extension. Copilot's agent in Visual Studio Code.

- Works with Cadastre through: the MCP server, the API with a key, and the Cadastre CLI
- Setup: One command, MCP: Add Server, or `.mcp.json`
- Guide: [GitHub Copilot in VS Code + Cadastre](https://getcadastre.com/agents/vscode.md)

### Claude

Anthropic · Desktop, Web. Anthropic's assistant on claude.ai and in the Claude desktop app, through a custom connector.

- Works with Cadastre through: the MCP server
- Setup: Add custom connector
- Guide: [Claude + Cadastre](https://getcadastre.com/agents/claude.md)

### ChatGPT

OpenAI · Web. OpenAI's assistant, through a custom MCP server added as a plugin on the web.

- Works with Cadastre through: the MCP server
- Setup: Add custom MCP server
- Guide: [ChatGPT + Cadastre](https://getcadastre.com/agents/chatgpt.md)

### Gemini CLI

Google · Terminal. Google's open-source AI agent for the terminal.

- Works with Cadastre through: the MCP server, the API with a key, and the Cadastre CLI
- Setup: One command
- Guide: [Gemini CLI + Cadastre](https://getcadastre.com/agents/gemini-cli.md)

### OpenCode

OpenCode · Terminal. An open-source AI coding agent for the terminal.

- Works with Cadastre through: the MCP server, the API with a key, and the Cadastre CLI
- Setup: `opencode.json`
- Guide: [OpenCode + Cadastre](https://getcadastre.com/agents/opencode.md)

## How each agent connects

| Agent | Kind | Add the server | Sign in (optional) | API with a key |
| --- | --- | --- | --- | --- |
| Claude Code | Terminal | One command | `/mcp` or `claude mcp login` | Yes |
| Codex | Terminal, IDE | One command, or `~/.codex/config.toml` | `codex mcp login` | Yes |
| Cursor | IDE | `~/.cursor/mcp.json` | OAuth, from Cursor's MCP settings | Yes |
| GitHub Copilot in VS Code | IDE, Extension | One command, MCP: Add Server, or `.mcp.json` | Browser opens on first use | Yes |
| Claude | Desktop, Web | Add custom connector | When you add it | No |
| ChatGPT | Web | Add custom MCP server | When you create it | No |
| Gemini CLI | Terminal | One command | Automatic, or `/mcp auth` | Yes |
| OpenCode | Terminal | `opencode.json` | `opencode mcp auth` | Yes |

## What agents can do with Cadastre

- **Screen every US metro.** Apply requirements such as population, manufacturing share, unemployment and industrial power price to all 393 metro areas, and see how many each one leaves. (`POST /api/v1/screen`)
- **Rank on weighted criteria.** Score and rank the survivors on the measures that matter, with each criterion's value, score and contribution, as the app ranks them. (`POST /api/v1/rank`)
- **Read a metro's profile.** Every measure served for one metro, with its vintage and whether Cadastre computed it from county figures. (`GET /api/v1/metros/{ref}`)
- **Compare metros.** Up to 25 metros side by side on up to 50 measures, or on the register's standard figures. (`GET /api/v1/metros/compare`)
- **Find the right measure.** Search the measures by name, label or unit, and read each dataset's publisher, licence, vintages and geographies. (`GET /api/v1/measures`)
- **Carry the sources.** Every answer lists the credit, licence and retrieval date its sources require, so the agent can cite them where the figures go. (`GET /api/v1/datasets`)

## Not available

- **Listings.** Cadastre does not carry property listings.
- **Parcels.** The launch is metro-level; parcel data is not available yet.
- **Geometry.** Answers carry names and codes, never boundaries, points or lines.
- **Restricted sources.** Sources whose terms do not allow it (County Health Rankings, the HIFLD archive, OpenStreetMap-derived values) are not served.

## Start

- [Join now](https://getcadastre.com/signup): an account, for higher limits than without one; the API is free while in beta, and the higher limits need API access turned on for the account (write to support@getcadastre.com to ask for it)
- [MCP server](https://getcadastre.com/docs/mcp.md): the server, its sign-in and its tools
- [API](https://getcadastre.com/docs/api.md): endpoints, keys, rate limits and attribution
- [CLI](https://getcadastre.com/docs/cli.md): the `cadastre` command line, for the terminal, scripts and setting up agents
- [llms.txt](https://getcadastre.com/llms.txt): every page for agents, by section