# census-mcp-server

MCP server for querying U.S. Census Bureau demographic, economic, and housing data. Searches datasets and variables, converts addresses to FIPS codes, compares estimates across geographies.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 9002 installs · ★ 3 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/census-mcp-server
- Updated: 2026-10-17
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/census-mcp-server

## What it does

The server provides access to American Community Survey (ACS5, ACS1), Population Estimates, Decennial 2020, County Business Patterns, and Economic Census datasets. Eight tools: `census_list_datasets` returns dataset codes and years, `census_search_variables` looks up variables by keywords or table codes, `census_resolve_geography` converts place names or addresses to FIPS identifiers via TIGERweb and Census Geocoder, `census_query_data` fetches estimates with margins of error for one or multiple geographies, `census_compare_geographies` ranks variables across states or counties.

Dataset codes are case-insensitive, two-part codes work by their last segment (`acs5`), three-part codes (`acs/acs5/profile`) must be given in full. For ACS, returns estimate (E) and margin-of-error (M) codes together. Without a Census API key, the server runs via public hosting at `https://census-mcp-server--cyanheads.run.tools`; STDIO deployment requires Node.js or Bun.

## Requirements
- Remote server: `https://census-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http census-mcp-server https://census-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add census-mcp-server --url https://census-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "census-mcp-server": {
            "url": "https://census-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "census-mcp-server": {
            "type": "http",
            "url": "https://census-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http census-mcp-server https://census-mcp-server--cyanheads.run.tools
```

## When to use it
- Fetch median income or population data by county FIPS code
- Convert a street address or place name to a Census FIPS identifier
- Compare employment metrics across all states or counties within a state
- Search ACS variables by keyword or table code with margins of error

## Example prompts
- Find ACS5 2022 variables matching the keywords median income
- Convert the place name King County, WA to a FIPS code
- Query variable `B19013_001E` for all counties in California and sort descending

## Similar
- [Morocco communes](https://affpapa.org/en/nevibecode/mcp/morocco-communes.md) — MCP server · ★ 51 repo stars
- [scb-mcp](https://affpapa.org/en/nevibecode/mcp/scb-mcp.md) — MCP server · ★ 9 repo stars
- [IBGE Brasil MCP](https://affpapa.org/en/nevibecode/mcp/ibge-brasil-mcp.md) — MCP server · ★ 14 repo stars
- [The Local Intel](https://affpapa.org/en/nevibecode/mcp/the-local-intel.md) — MCP server · 2761 installs
- [cellxgene-census](https://affpapa.org/en/nevibecode/skills/cellxgene-census.md) — skill · 2100 installs
- [fcc-broadband-mcp-server](https://affpapa.org/en/nevibecode/mcp/fcc-broadband-mcp-server.md) — MCP server · 588 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
