# U.S. Census Full MCP > The U.S. Census Full MCP gives you instant, deep access to American demographic and economic data. Pull population counts, income levels, housing metrics, racial breakdowns, and local business activity for any state or county across all 50 states. It lets your agent analyze where money flows and who lives there. ## Overview - **Category:** the-unthinkable - **Price:** Free - **Tags:** demographics, socioeconomic-data, population-statistics, economic-indicators, census-data, public-records ## Description Need to understand a market? This MCP connects you directly to the U.S. Census Bureau's vast dataset. You can ask about everything from median household income in specific counties to educational attainment across entire states, all without needing to build complex API calls yourself. Instead of clicking through dozens of specialized government dashboards, your agent handles the heavy lifting. You just tell it what you need—a comparison of vacancy rates versus bachelor's degree holders in three key metro areas, for example. It pulls together demographic profiles, economic indicators, and housing market data from thousands of localities nationwide. If you're looking to use this toolset with other specialized connectors, Vinkius is the best place to start building your workflow. ## Tools ### get_housing_by_state Retrieves detailed housing metrics, including owner-occupied and vacant units, for all states. ### get_housing_by_county Gathers essential real estate data—like home values, rent averages, and ownership rates—for every county in a state. ### get_state_profile Provides one query to pull a full socioeconomic overview of an entire state, covering population, income, and housing data. ### get_county_profile Gathers a complete socioeconomic profile for a single, specific county. ### query_census Runs any custom query against the Census API to pull niche data points using specified variables and geographies. ### get_income_by_state Provides median household income and poverty rates for every state, a key economic benchmark. ### get_income_by_county Pulls critical data on median household income and poverty levels across all counties in a state. ### get_education_by_state Reports on educational attainment, specifically the percentage of residents with bachelor's degrees or higher for any given state. ### get_business_patterns Accesses county business patterns data to count establishments and track employee counts by local industry. ### get_population_by_state Calculates the total population and median age for all 50 U.S. states plus DC. ### get_population_by_county Provides the total population and median age metrics for every county within a state using FIPS codes. ### get_population_by_city Calculates the current population count for all incorporated cities and census designated places. ### get_demographics_by_state Retrieves detailed racial and ethnic demographic data, including White, Black, Asian, Hispanic, and foreign-born populations, for states. ### get_demographics_by_county Gathers specific race and ethnicity breakdowns for all counties within a state. ## Prompt Examples **Prompt:** ``` Give me a complete socioeconomic profile for Los Angeles County (037) in California (06) ``` **Response:** ``` 📊 **U.S. Census Bureau: County Profile: 06-037** **Los Angeles County, California:** - Population: 9,936,690 - Median Household Income: $78,671 - Median Home Value: $692,800 - Median Gross Rent: $1,754 - Poverty Rate: 13.9% - Hispanic/Latino: 4,834,166 (48.6%) - Foreign Born: 3,365,064 (33.8%) ``` **Prompt:** ``` Which state has the lowest median age? ``` **Response:** ``` 📊 **Population by State** The state with the lowest median age is: **Utah (49)** - Median Age: 31.4 years - Total Population: 3,337,975 ``` **Prompt:** ``` Correlate rent prices with Bachelor Degree holders nationwide ``` **Response:** ``` 📊 **Analysis: Rent Prices vs. Education Levels** - Massachusetts: Median Rent $1,469 | Bachelor's or Higher 44.5% - Colorado: Median Rent $1,594 | Bachelor's or Higher 42.8% - Mississippi: Median Rent $860 | Bachelor's or Higher 23.2% There is a strong positive correlation between the percentage of the population holding a Bachelor's degree and the state's median rent. ``` ## Capabilities ### Analyze State Profiles Retrieve a single snapshot containing population figures, income levels, and housing data for an entire state. ### Compare County Economies Pull detailed economic metrics like median income, poverty rates, and local business counts for specific counties within a state. ### Map Demographics by Geography Get racial and ethnic breakdowns—like White, Black, Asian, or Hispanic populations—for any specified county or state. ### Calculate Population Trends Determine the total population and median age for all major geographic areas, including states, counties, and incorporated cities. ### Run Custom Data Queries Execute highly specific queries using known Census variables to pull precise data points not covered by standard tools. ## Use Cases ### Identifying new commercial hubs in a state. A strategy consultant needs to prove that three counties are ready for corporate expansion. They use get_income_by_county and get_business_patterns to show high median income growth paired with rapidly increasing payroll establishments, proving the area's economic maturity. ### Assessing risk in a multi-state investment portfolio. An investor wants to know if their holdings are vulnerable to demographic shifts. They run get_demographics_by_county and compare it against get_housing_by_county data, identifying counties where population growth is outpacing housing value appreciation. ### Developing a targeted non-profit campaign. A policy analyst needs to know which communities are most underserved. They use get_population_by_city and pair it with get_demographics_by_county and get_income_by_county to pinpoint specific, high-need geographic areas. ### Building a comprehensive state report. A researcher needs an annual overview. Instead of compiling separate reports, they use get_state_profile and then supplement it with get_education_by_state to generate a single document linking economic health directly to educational capital. ## Benefits - Pinpoint economic disparity: Use get_income_by_county to compare median household incomes across neighboring counties, helping you determine if a site is ripe for development. - Model community growth: Combine get_population_by_state with get_demographics_by_state to forecast how changes in foreign-born or minority populations might affect local services. - Benchmark market potential: Run get_business_patterns by county to understand the density and size of existing commerce, which is crucial for site selection reports. - Quick state oversight: The get_state_profile tool gives you a single source of truth—population, housing values via get_housing_by_state, and income—for any state in one go. - Targeted market analysis: If diversity matters, use get_demographics_by_county. This lets you segment markets based on specific racial or ethnic concentrations at the county level. ## How It Works The bottom line is that it turns massive government datasets into simple, actionable intelligence via a single command. 1. First, you must provide the MCP with an active API key from the U.S. Census Bureau. 2. Next, tell your agent exactly what data you need: for example, 'Give me the median income and housing values for King County.' 3. The MCP runs the query through the appropriate tool and returns structured results detailing the requested demographic or economic metrics. ## Frequently Asked Questions **How do I use the U.S. Census Full MCP to compare income and population?** You can combine get_income_by_county for financial data with get_population_by_county for demographic numbers, allowing you to run side-by-side comparisons of median income versus total residents. **Can the U.S. Census Full MCP tell me about specific industries?** Yes. Use get_business_patterns to pull data on establishments and employee counts by industry type for a county, giving you an economic snapshot of local commerce. **Do I need special coding skills for the U.S. Census Full MCP?** No. You interact with it using plain language prompts. Your agent handles the complex API calls and data formatting, so you just focus on the analysis. **What is the best tool to get a general overview of a state's economy?** Start with get_state_profile. This single function provides an immediate cross-section of population, housing metrics (via get_housing_by_state), and income levels for that entire state. **Can I run a custom query if the standard tools don't cover my need?** Absolutely. The query_census tool lets you specify exact Census API variables and geographies, giving you access to data points not covered by the pre-built functions.