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.

Functions
14
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just US Census Bureau (census.gov, data.census.gov)

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/census
Every site

One 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/mcp
Set it up in your client

Both 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.

Read 14
  • geographyLevelsLists the geography levels US Census data is published at: Nation, State, County, Census Tract, ZIP Code Tabulation Area and more.

    Arguments

    NameTypeRequired
    args{ query?: string }No

    Returns { code: string; name: string }[]

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/census/geographyLevels

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.census.geographyLevels({ query: "population" });
  • locationsResolves US Census geography ids to their place names.

    Arguments

    NameTypeRequired
    args{ geoIds: string[] }Yes

    Returns CensusProfileRef[]

    interface CensusProfileRef { label: string; geoId: string | null; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/census/locations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/populationClock

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    geoIdstringYes

    Returns CensusProfile

    interface 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/profile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/profileHighlights

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.census.profileHighlights({ geoId: "010XX00US" });
  • relatedProfilesLists geographies related to a US Census geography, such as neighbouring states, with their geography ids.

    Arguments

    NameTypeRequired
    geoIdstringYes

    Returns { label: string | null; related: CensusProfileRef[] }

    interface CensusProfileRef { label: string; geoId: string | null; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/census/relatedProfiles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.census.relatedProfiles({ geoId: "040XX00US06" });
  • 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

    NameTypeRequired
    args{ query: string; limit?: number }Yes

    Returns CensusTableSearch

    interface 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/searchTables

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/siteMenu

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.census.siteMenu();
  • suggestReturns data.census.gov search suggestions for partial text: matching Census topics and geography profiles with their ids.

    Arguments

    NameTypeRequired
    args{ text: string }Yes

    Returns CensusSuggestions

    interface 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/suggest

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    argsCensusTableArgs & { raw?: boolean }Yes
    interface CensusTableArgs { id: string; geoId?: string; }

    Returns CensusTableData

    interface CensusTableData { id: string; columns: string[]; rows: Record<string, string | null>[]; }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/census/tableData

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    idstringYes
    geoIdstringNo

    Returns { downloadId: string | null; url: string | null }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/census/tableDownload

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.census.tableDownload({ id: "DECENNIALPL2020.P1" });
  • tableMetadataReads a US Census data table title, universe and every variable with its label.

    Arguments

    NameTypeRequired
    args{ id: string }Yes

    Returns CensusTableMetadata

    interface 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/tableMetadata

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/vintages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.census.vintages();

Use it from code