Data Commons is an open knowledge repository that provides a unified view across multiple public data sets and statistics. This server allows any MCP-enabled agent or client to query the Data Commons knowledge graph.

Features

MCP-Compliant: Implements the Model Context Protocol for seamless agent integration.
Data Commons Access: Fetches public statistics and data from the base datacommons.org knowledge graph.
Custom Instance Support: Can be configured to work with Custom Data Commons instances.
Flexible Serving: Runs over both streamable HTTP and stdio.

Quickstart

Prerequisites

You must have a Data Commons API key; create one at apikeys.datacommons.org.
Install uv by following the official installation instructions.

Configuration

Set the following required environment variable in your shell:

export DC_API_KEY=<your API key>

Start the server

Run the server from your command line in one of two modes:

Streamable HTTP

This runs the server with Streamable HTTP.

# Runs on default port 8080
uvx un-datacommons-mcp serve http [--port <PORT>]

The server will be available at http://localhost:<port>/mcp.

stdio

This transport mode is intended for local integrations and is programmatically configured within a client (like Gemini CLI settings) to communicate over stdio.

uvx un-datacommons-mcp serve stdio

Clients

You can use any MCP-enabled agent or client to connect to your running server. For example, see the Data Commons MCP documentation for guides on connecting:

Or see your preferred client's documentation for how to configure it, using the commands listed above.

Advanced Configuration

Using MCP Tools with a Custom Data Commons

Follow the Guide for using MCP Tools with Custom Data Commons to set additional environment variables required for custom configuration.

FAQs

What is un-datacommons-mcp?

Is un-datacommons-mcp well maintained?

un-datacommons-mcp

Data Commons MCP Server