playbooks

home / mcp / imf data mcp server

IMF Data MCP Server

This MCP server integrates with the free IMF data API to provide a set of tools and resources for retrieving and processing economic data. It enables users to query datasets, fetch time series data, and list available indicators and countries, making it easier to work with IMF data in a structured and programmatic way.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "c-cf-imf-data-mcp": {
      "command": "uvx",
      "args": [
        "imf-data-mcp"
      ]
    }
  }
}

You have an IMF Data MCP Server that exposes IMF data tools as an MCP endpoint. It lets you list datasets, inspect dataset structures, fetch time series data, list indicators and countries, and guide your queries with a ready-made prompt template. This enables programmatic access to IMF data from your MCP-enabled client or workflow.

How to use

You will run the IMF Data MCP Server through your MCP client, then query it to retrieve datasets, indicators, and time series. Use the server to fetch data from various IMF datasets like CDIS, CPIS, MFS, IFS, and more. You can request data structures, list available indicators for a dataset, and obtain country lists to help shape your queries. A predefined query prompt template helps you craft effective data requests.

How to install

Prerequisites you need before starting are installed runtimes for your environment and access to an MCP runtime to run servers.

# Using the MCP runtime uvx (recommended)
uvx imf-data-mcp

# Alternative: run via Python if you prefer a Python entrypoint
python -m imf_data_mcp

# If you want to run a debug inspector on uvx
npx @modelcontextprotocol/inspector uvx imf-data-mcp

Configuration

You configure the IMF Data MCP Server with a standard MCP servers block. The server is run locally via the MCP runtime using a short, explicit command.

{
  "mcpServers": {
    "imf": {
      "command": "uvx",
      "args": ["imf-data-mcp"]
    }
  }
}

Available tools

listDatasets

Retrieve a list of all available IMF datasets using the Dataflow API.

getDatasetStructure

Fetch the structure of a specified dataset via the DataStructure API.

fetchTimeSeries

Retrieve time series data for various IMF datasets (e.g., CDIS, CPIS, MFS, IFS) using the CompactData API.

listIndicators

List all available indicators for a specific dataset using the DataMapper API.

listCountries

Retrieve a list of available countries for a specific dataset.

queryPromptTemplate

Provide a query prompt template to guide users on how to query data with indicators and intents.