US Census Data API
US Census Data API for retrieving official demographic, economic, geographic, and population statistics by dataset, geography, variable, and time.
Connect this API to an AI agent Browse all specs
What you can do with US Census Data API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /{year}/acs/acs5 |
get_year_acs_acs5 | Retrieve American Community Survey data Method: GET Path: /{year}/acs/acs5 IMPORTANT: This function has 3 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - year: Census data year Query Parameters: REQUIRED: - get: Comma-separated variables - for: Geography selector OPTIONAL: - in: Parent geography selector - key: Optional Census API key |
| GET | /{year}/dec/pl |
get_year_dec_pl | Retrieve Decennial Census PL data Method: GET Path: /{year}/dec/pl IMPORTANT: This function has 3 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - year: Census data year Query Parameters: REQUIRED: - get: Comma-separated variables - for: Geography selector OPTIONAL: - key: Optional Census API key |
| GET | /data.json |
get_data_json | List available Census datasets Method: GET Path: /data.json IMPORTANT: This function has 0 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - sort: Sort field - get: Dataset metadata fields |
| GET | /{year}/timeseries/eits/marts |
get_year_timeseries_eits_marts | Retrieve economic indicator time series Method: GET Path: /{year}/timeseries/eits/marts IMPORTANT: This function has 2 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - year: Census data year Query Parameters: REQUIRED: - get: Comma-separated variables OPTIONAL: - time: Time filter - key: Optional Census API key |
Usage guide
Most US Census API datasets are publicly readable without an API key. Some datasets require a Census API key; request one through the official developer portal and send it as the `key` query parameter. Always use the documented dataset-specific variables and geography syntax. Official documentation: https://www.census.gov/data/developers/guidance/api-user-guide.html
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “US Census Data API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.