Supercharge your AI with Census Population. Map ethnic diversity and headcount across US geography.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
U.S. Census Population — Demographics, Age & Diversity accesses American Community Survey data for precise demographic modeling. You can get total population counts, median age, and detailed breakdowns of race and ethnicity—including White, Black, Asian, Hispanic, and Foreign-born populations—for any U.S.
state, county, or incorporated city.
What your AI can do
Get population by state
Provides the total population and median age for all 50 U.S. states plus DC using ACS data.
Get population by county
Gets the total population count and median age for specific counties in a state, requiring the county's FIPS code.
Get population by city
Retrieves population counts for incorporated cities and Census Designated Places within a state.
You can compare the total population and median age of multiple U.S. states using get_population_by_state.
The agent uses get_demographics_by_county to map out the racial and ethnic breakdown for every county in a given state.
Use get_population_by_city to get headcount data specifically for small towns or incorporated places, separate from county averages.
Run get_demographics_by_state to generate a comprehensive list of how racial groups (like Asian or Hispanic) are distributed across the entire country.
The tool get_population_by_county provides population totals and median ages for specific counties, which is useful when you only care about headcounts, not ethnicity.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 Compatible Gemini Waiting for input…
U.S. Census Population: 5 Tools for Demographics
Analyze U.S. demographics by state, county, or city using five specialized tools to retrieve population counts, median age, and full ethnic breakdowns.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using U.S. Census Population — Demographics, Age & Diversity on VinkiusGet Population By State
Provides the total population and median age for all 50 U.S. states plus DC using ACS data.
Get Population By County
Gets the total population count and median age for specific counties in a state...
Get Population By City
Retrieves population counts for incorporated cities and Census Designated Places...
Get Demographics By State
Gets the full racial and ethnic breakdown (White, Black, Asian, Hispanic...
Get Demographics By County
Retrieves racial and ethnic demographics for every county within a state.
Connect to your AI in seconds. Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token from
cloud.vinkius.com. For OAuth-protected servers, expand Advanced
settings to add credentials.
Start a conversation
Open a new chat. The Census Population integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with U.S. Census Population — Demographics, Age & Diversity, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by U.S. Census Bureau. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 5 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Manually compiling U.S. demographic reports is a huge time sink.
Today, running a basic comparison—say, comparing median age and ethnic breakdown between California and Texas—means navigating the Census website multiple times. You download zip files for state totals, then download separate CSVs for county data, and finally pull in another set just for city populations. Then you spend hours opening Excel and reconciling which code belongs where.
With this MCP server, your agent handles the whole mess. You tell it what you need—'Compare CA and TX.' The agent calls `get_population_by_state` and then runs `get_demographics_by_state`. You get a single, structured output with all the numbers side-by-side.
U.S. Census Population — Demographics, Age & Diversity MCP Server
The manual process of cross-referencing county data is particularly brutal. You have to pull the total population count from one source and then find the ethnic breakdown from another, even if they refer to the same geographic area. This introduces risk every time a number doesn't match up.
Now it’s simple. The tools let you combine `get_population_by_county` with `get_demographics_by_county`. You don't just get two separate lists; you get one cohesive record that shows both the headcount and the full ethnic breakdown for a specific county.
What your AI can actually do with this
This server gives your agent direct access to granular American Community Survey (ACS) data from the U.S. Census Bureau. You don't have to click through a dozen government websites just to get reliable demographic numbers; you run an operation and get clean, structured metrics back.
When you need to compare headcounts across multiple states, use get_population_by_state. It pulls the total population count and median age for all fifty U.S. states plus D.C., letting you benchmark those national-level figures instantly.
To analyze diversity nationwide, run get_demographics_by_state. This tool generates a full breakdown of race and ethnicity—White, Black, Asian, Hispanic, and Foreign-born populations—across every single state, giving you a country-wide view of how these groups are distributed. You’ll get that data for all fifty states plus D.C.
Drilling down into county details is where this server shines. If you want to map out the racial and ethnic breakdown for every county within a single state, use get_demographics_by_county. This gives you granular segmentation—it’s far more specific than just knowing the total number of people in an area.
When your focus is strictly on population totals and median age for specific counties, not the full ethnic breakdown, you gotta use get_population_by_county. It requires the county's FIPS code as input, but it gives you exactly the headcount and median age data you need for that particular jurisdiction.
If your work involves small towns or designated non-county areas, like incorporated cities or Census Designated Places (CDPs), use get_population_by_city. This tool retrieves headcounts specifically for those smaller places, separating their population from the broader county averages. It’s key when you're analyzing specific market centers.
Understanding these differences is everything: if you want a pure count of residents in a city, use get_population_by_city; if you need to compare total headcounts and median ages across multiple states, stick with get_population_by_state. Conversely, if you're mapping out how different ethnic groups are spread county by county within one state—say, tracking the distribution of Asian or Hispanic residents across every county in California—you’ll want the detailed breakdown from get_demographics_by_county.
You can combine these calls to build sophisticated models. You might run get_population_by_state first for a high-level comparison, then use that knowledge to drill down on two key counties using get_population_by_county, and finish by checking the specific demographics of a single major city using get_demographics_by_city. It's about having access to every level of administrative data—from the national aggregate down to the smallest recognized CDP.
You won't find this depth of structured Census access anywhere else.
019d756b-7130-727a-8d1a-de1ab2eda3ab 
Here's how it actually works
The bottom line is: you get clean, structured census data without having to manually navigate or download multiple CSV files from the Census Bureau website.
You specify the geographic scope (e.g., 'California') and the level of detail needed (e.g., 'county demographics').
Your AI client invokes the appropriate tool—like get_demographics_by_county—passing the necessary parameters, such as the state's FIPS code.
The server returns structured JSON data containing the requested population metrics and ethnic breakdowns directly to your agent.
Who is this actually for?
This tool is for market researchers and policy analysts who can't afford inaccurate, incomplete reports. If your job involves comparing population shifts across different U.S. regions or modeling where a business should expand next, you need this. It’s built for people tired of reconciling data pulled from five different government web portals.
They use get_demographics_by_county to compare the ethnic composition of potential new markets, ensuring their product speaks to the local population.
The planner runs get_population_by_city and get_population_by_county together to understand density variations between small towns and larger county seats.
They rely on get_demographics_by_state to track the national distribution of specific groups, informing federal policy recommendations.
What Changes When You Connect
Compare multiple state totals instantly. Using get_population_by_state lets you run a direct comparison of median age and total population between, say, Texas and Florida—no spreadsheet needed.
Drill down into local communities. If your target is a specific suburb, use get_population_by_city. This provides focused headcount data that often differs from the larger county average.
Understand deep regional diversity. The combination of get_demographics_by_county and get_demographics_by_state lets you see how race and ethnicity shift dramatically, even across neighboring counties.
Isolate population metrics only. If your goal is just knowing the total count or median age for a county, use get_population_by_county. This keeps your data clean by excluding unnecessary demographic fields.
Build comprehensive reports quickly. The tools let you build complex reports—for example, comparing state-level diversity (get_demographics_by_state) against the specific population of major metro areas using get_population_by_city.
See it in action
Planning a National Marketing Rollout
A brand manager needs to know where their primary target demographic (e.g., Asian or Hispanic) is concentrated across the country. They ask the agent to run get_demographics_by_state, which returns a state-by-state breakdown of ethnic populations, instantly identifying the top five markets for immediate focus.
Analyzing Suburban Growth
A real estate developer needs to compare two adjacent suburbs. They use get_population_by_county and get_demographics_by_county on both counties, allowing them to analyze population growth rates alongside the specific median age of the local populace.
Tracking Localized Infrastructure Needs
A municipal government needs to fund new facilities. They use get_population_by_city and get_population_by_county to calculate total headcount across multiple smaller towns, ensuring funding matches the actual residential count.
Comparing State Health Risks
A public health official wants to see how median age correlates with overall population in different states. They run get_population_by_state first, then use the resulting state codes to pull specific demographic data for risk analysis.
The honest tradeoffs
Assuming one tool handles everything.
A user tries to run a general 'get all demographics' query, expecting it to cover both population and race breakdowns across three different levels of granularity (city, county, state) in one call.
You must segment your request. Use get_population_by_state for total headcount and median age. Then, run get_demographics_by_state separately to get the full ethnic breakdown. Combining these two tools gives you both metrics.
Forgetting FIPS codes.
The user tries to query a county using only its name ('Kings County'). The API rejects it because it requires the specific numeric identifier (FIPS code) for accurate location targeting.
When querying counties, always provide the correct State FIPS code and the County FIPS code. For example, use get_population_by_county with the required state and county identifiers.
Mixing up data scopes.
A user pulls population counts using get_population_by_city, but then tries to analyze racial demographics on that set of results, expecting the ethnicity breakdown provided by the county tool.
Understand the scope. Population totals for small places come from get_population_by_city. For ethnic breakdowns, you must use a specific demographic tool like get_demographics_by_county or get_demographics_by_state.
When It Fits, When It Doesn't
Use this server if your core need is quantitative data about U.S. population distribution and ethnic makeup, requiring granular precision (city to state). Don't use it if you are looking for economic indicators like GDP per capita or job market rates—those require different data sources. If you only need general census information without specific demographic breakdowns, get_population_by_state is sufficient. However, if the analysis requires knowing how many people of a certain race live in an area, you must use one of the specialized demographic tools: get_demographics_by_county or get_demographics_by_state. Never assume that population counts and racial breakdowns are housed in the same tool; treat them as two separate data streams for accurate results.
Questions you might have
Can I use get_population_by_state to compare multiple states? +
Yes, absolutely. You can ask the agent to compare two or more states using get_population_by_state. It returns the total population and median age for each state you list in a single response.
Do I need FIPS codes for get_population_by_county? +
Yes, the tool requires specific FIPS codes. You can't just use the county name; you must provide both the State FIPS code and the County FIPS code to pinpoint the correct data set.
Does get_demographics_by_state cover all racial groups? +
Yes, get_demographics_by_state pulls the key breakdowns: White, Black, Asian, Hispanic, and Foreign-born populations across all 50 states plus DC.
How do I get data for a small town that isn't a major county center? +
Use get_population_by_city. This tool specifically targets incorporated cities and Census Designated Places, giving you localized population numbers separate from the broader county statistics.
Do I need to handle authentication for get_population_by_state? +
Yes, you must include a free API key from the Census Bureau. You pass this key as an authorization token in your request headers or during the initial setup phase. The service won't return data without valid credentials.
What fields does get_demographics_by_county actually return? +
It returns a structured object containing race and ethnic counts for all counties in a state. Key metrics include population totals, along with specific breakdowns for White, Black, Asian, Hispanic, and Foreign-born groups.
Can I combine results from get_population_by_county and get_demographics_by_county? +
You must run two separate calls. Use get_population_by_county for age and median population figures, then use get_demographics_by_county. Crucially, you pass the same county FIPS code to both tools to align the results.
What should I do if get_population_by_city fails or returns no data? +
The server will return a specific API error code and an empty payload. Don't assume missing data means zero population; instead, check the response body for null values or defined API errors to handle the failure gracefully.
What are FIPS codes? +
FIPS (Federal Information Processing Standard) codes are numbers used by the government to uniquely identify states, counties, and places. E.g., California is 06, Los Angeles County is 037.
Which census survey do you use? +
We use the American Community Survey (ACS) 5-Year estimates, which provide the most reliable, detailed, and broad demographic data annually.
Are undocumented immigrants counted? +
Yes, the Census Bureau attempts to count all residents regardless of immigration status, though this group is historically harder to count accurately.
We've already built the connector for Census Population. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 5 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.