census-mcp-server — Claude Code MCP server: U.S. Census data access
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.
Apache-2.0 9,002 installs ★ 3 updated 2026-10-17
claude mcp add --transport http census-mcp-server https://census-mcp-server--cyanheads.run.toolsWhat census-mcp-server 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.
What it helps with
- 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 for the agent
- Find ACS5 2022 variables matching the keywords median income
- Convert the place name King County, WA to a FIPS code
- Query variable
B19013_001Efor all counties in California and sort descending
How to install census-mcp-server
Platform CLI: remote server
claude mcp add --transport http census-mcp-server https://census-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add census-mcp-server --url https://census-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"census-mcp-server": {
"url": "https://census-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"census-mcp-server": {
"type": "http",
"url": "https://census-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http census-mcp-server https://census-mcp-server--cyanheads.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about census-mcp-server
How do I install census-mcp-server in Claude Code?
Run claude mcp add --transport http census-mcp-server https://census-mcp-server--cyanheads.run.tools in your terminal.
What does census-mcp-server do?
The server connects agents to U.S. Census Bureau data: demographics, economics, housing. It searches variables, converts addresses to codes, queries and ranks estimates across geographies.
Which datasets does census-mcp-server support?
ACS5 and ACS1 with all profiles, Population Estimates, Decennial 2020, County Business Patterns, Economic Census, and Nonemployer Statistics. Use census_list_datasets to list datasets and years.