odp-fastmcp

A FastMCP server that provides LLM-friendly access to the U.S. Department of Labor Open Data Portal.

Tools

Tool	Description
list_datasets	Browse the DOL Data Catalog (no API key required)
get_metadata	Retrieve field names, types, and descriptions for a dataset
query_data	Query records with filtering, sorting, and pagination

Resources

Resource	Description
dol://filter-help	Complete filter syntax reference with examples

Setup

1. Get a free API key

Register at https://dataportal.dol.gov/registration. The key is required for get_metadata and query_data.

2. Clone and install

git clone https://github.com/mthelm85/odp-fastmcp
cd odp-fastmcp
python -m venv .venv
.venv\Scripts\activate      # Windows
# source .venv/bin/activate  # macOS / Linux
pip install fastmcp httpx python-dotenv

3. Add your API key

Create a .env file in the project root:

DOL_API_KEY=your-key-here

Running the server

fastmcp run main.py

By default this uses stdio transport, which is suitable for most MCP clients. For HTTP-based clients:

fastmcp run main.py --transport streamable-http --port 8000

Refer to the FastMCP documentation for all available transport and configuration options.