Datacommons

liveGeography

Data Commons MCP — harmonised public statistics for places, from Google Data Commons (REST v2).

4tools
0msauth
free tier50 calls/day

Tools

datacommons_find_place

Find the Google Data Commons place id (dcid) for a place name — country, state, county, city, region. Returns candidates with name and place type, e.g. "California" -> geoId/06, "India" -> country/IND

No parameters required.

▶Try it
datacommons_find_variable

Search Google Data Commons statistical variables by plain-language indicator, e.g. "median household income" -> Median_Income_Household, "unemployment rate" -> UnemploymentRate_Person. Returns variabl

No parameters required.

▶Try it
datacommons_observation

Get the value of one Google Data Commons statistical variable for one place: the latest value (default), the value at a date, or the whole time series. Each value names its original publisher (US Cens

No parameters required.

▶Try it
datacommons_child_places

Compare one Google Data Commons statistical variable across every child place of a parent — e.g. population of all US states, median income of every county in Texas (geoId/48, County), GDP of every co

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/datacommons/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/datacommons/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"datacommons_find_place","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("datacommons_find_place", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("data commons mcp — harmonised public statistics for places, from google data commons (rest v2)");