US Census Bureau (census.gov, data.census.gov) MCP server for AI agents
Let Claude, ChatGPT or your own agent read US Census Bureau (census.gov, data.census.gov): 14 typed functions through one MCP server. No US Census Bureau (census.gov, data.census.gov) API key needed.
- Site
- census.gov
- Functions
- 14
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for US Census Bureau (census.gov, data.census.gov) alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/censusOne MCP server for US Census Bureau (census.gov, data.census.gov) and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
geographyLevelsLists the geography levels US Census data is published at: Nation, State, County, Census Tract, ZIP Code Tabulation Area and more.Arguments
Name Type Required args{ query?: string }No Returns
{ code: string; name: string }[]HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/geographyLevelsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.geographyLevels({ query: "population" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.geographyLevels({"query": "population"}))curl -X POST https://api.bowmark.ai/v1/sites/census/geographyLevels \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"population"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.geographyLevels({ query: "population" });locationsResolves US Census geography ids to their place names.Arguments
Name Type Required args{ geoIds: string[] }Yes Returns
CensusProfileRef[]interface CensusProfileRef { label: string; geoId: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/locationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.locations({ geoIds: ["040XX00US06"] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.locations({"geoIds": ["040XX00US06"]}))curl -X POST https://api.bowmark.ai/v1/sites/census/locations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"geoIds":["040XX00US06"]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.locations({ geoIds: ["040XX00US06"] });populationClockReads the US Census Bureau population clock: the current estimated US and world population.Arguments
None.
Returns
{ us: number | null; world: number | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/populationClockCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.populationClock();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.populationClock())curl -X POST https://api.bowmark.ai/v1/sites/census/populationClock \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.populationClock();profileReads the data.census.gov profile of a US geography: name, parent geographies, area description and highlight statistics like population and median…Arguments
Name Type Required geoIdstringYes Returns
CensusProfileinterface CensusHighlight { label: string; value: string | null; format: string | null; topic: string | null; source: string | null; sourceLink: string | null; tableId: string | null; } interface CensusProfile { geoId: string; name: string | null; type: string | null; parents: { geoId: string; name: string | null }[]; subtitle: string | null; description: string | null; highlights: CensusHighlight[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/profileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.profile({ geoId: "040XX00US06" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.profile({"geoId": "040XX00US06"}))curl -X POST https://api.bowmark.ai/v1/sites/census/profile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"geoId":"040XX00US06"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.profile({ geoId: "040XX00US06" });profileHighlightsReads the highlight statistics of a US geography Census profile (population, median household income, housing units), each with its source table.Arguments
Name Type Required geoIdstringYes Returns
{ label: string | null; highlights: CensusHighlight[] }interface CensusHighlight { label: string; value: string | null; format: string | null; topic: string | null; source: string | null; sourceLink: string | null; tableId: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/profileHighlightsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.profileHighlights({ geoId: "010XX00US" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.profileHighlights({"geoId": "010XX00US"}))curl -X POST https://api.bowmark.ai/v1/sites/census/profileHighlights \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"geoId":"010XX00US"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.profileHighlights({ geoId: "010XX00US" });searchTablesSearches data.census.gov for US Census data tables on a topic, returning each table and its dataset instances with ids like DECENNIALPL2020.P1.Arguments
Name Type Required args{ query: string; limit?: number }Yes Returns
CensusTableSearchinterface CensusTableInstance { id: string; dataset: string | null; program: string | null; vintage: string | null; universe: string | null; description: string | null; provider: string | null; type: string | null; } interface CensusTableHit { tableId: string | null; title: string | null; program: string | null; instances: CensusTableInstance[]; } interface CensusTableSearch { query: string; total: number | null; tables: CensusTableHit[]; trending: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/searchTablesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.searchTables({ query: "population", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.searchTables({"query": "population", "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/census/searchTables \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"population","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.searchTables({ query: "population", limit: 3 });siteMenuReads the census.gov site navigation menu: topic and data sections with their links.Arguments
None.
Returns
CensusMenuSection[]interface CensusMenuSection { section: string; title: string; description: string | null; links: { text: string; url: string }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/siteMenuCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.siteMenu();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.siteMenu())curl -X POST https://api.bowmark.ai/v1/sites/census/siteMenu \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.siteMenu();suggestReturns data.census.gov search suggestions for partial text: matching Census topics and geography profiles with their ids.Arguments
Name Type Required args{ text: string }Yes Returns
CensusSuggestionsinterface CensusSuggestions { text: string; options: { title: string; type: string | null; facets: Record<string, unknown> }[]; profiles: { label: string; level: string | null; geoId: string | null; teaser: string | null }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/suggestCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.suggest({ text: "populat" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.suggest({"text": "populat"}))curl -X POST https://api.bowmark.ai/v1/sites/census/suggest \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"text":"populat"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.suggest({ text: "populat" });tableDataReads the values of a US Census data table for a geography, one row per geography keyed by variable code.Arguments
Name Type Required argsCensusTableArgs & { raw?: boolean }Yes interface CensusTableArgs { id: string; geoId?: string; }Returns
CensusTableDatainterface CensusTableData { id: string; columns: string[]; rows: Record<string, string | null>[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/tableDataCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.tableData({ id: "DECENNIALPL2020.P1", geoId: "040XX00US06" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.tableData({"id": "DECENNIALPL2020.P1", "geoId": "040XX00US06"}))curl -X POST https://api.bowmark.ai/v1/sites/census/tableData \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"DECENNIALPL2020.P1","geoId":"040XX00US06"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.tableData({ id: "DECENNIALPL2020.P1", geoId: "040XX00US06" });tableDownloadPrepares a download of a US Census data table for a geography and returns its download URL.Arguments
Name Type Required idstringYes geoIdstringNo Returns
{ downloadId: string | null; url: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/tableDownloadCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.tableDownload({ id: "DECENNIALPL2020.P1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.tableDownload({"id": "DECENNIALPL2020.P1"}))curl -X POST https://api.bowmark.ai/v1/sites/census/tableDownload \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"DECENNIALPL2020.P1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.tableDownload({ id: "DECENNIALPL2020.P1" });tableLinksResolves a US Census table id to its data and metadata access URLs.Arguments
Name Type Required args{ id: string }Yes Returns
CensusTableLinksinterface CensusTableLinks { objectId: string | null; tableId: string | null; dataUri: string | null; metadataUri: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/tableLinksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.tableLinks({ id: "DECENNIALPL2020.P1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.tableLinks({"id": "DECENNIALPL2020.P1"}))curl -X POST https://api.bowmark.ai/v1/sites/census/tableLinks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"DECENNIALPL2020.P1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.tableLinks({ id: "DECENNIALPL2020.P1" });tableMetadataReads a US Census data table title, universe and every variable with its label.Arguments
Name Type Required args{ id: string }Yes Returns
CensusTableMetadatainterface CensusMeasure { id: string; label: string | null; unitType: string | null; classification: string | null; annotations: string[]; } interface CensusTableMetadata { id: string | null; title: string | null; dataset: string | null; universe: string | null; apiUrl: string | null; measures: CensusMeasure[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/tableMetadataCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.tableMetadata({ id: "DECENNIALPL2020.P1" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.tableMetadata({"id": "DECENNIALPL2020.P1"}))curl -X POST https://api.bowmark.ai/v1/sites/census/tableMetadata \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"DECENNIALPL2020.P1"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.tableMetadata({ id: "DECENNIALPL2020.P1" });vintagesLists the data years (vintages) data.census.gov offers.Arguments
None.
Returns
string[]HTTP endpoint
POST https://api.bowmark.ai/v1/sites/census/vintagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.census.vintages();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.census.vintages())curl -X POST https://api.bowmark.ai/v1/sites/census/vintages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.census.vintages();
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/census/<function> - OpenAPI
/v1/sites/census/openapi.json