What is Imf Data Mcp

imf-data-mcp is an MCP server that integrates with the free IMF data API, providing tools and resources for retrieving and processing economic data in a structured and programmatic manner.

Use cases

Use cases include academic research, economic forecasting, financial analysis, and developing applications that require access to IMF economic datasets.

How to use

You can run the server using ‘uvx’ directly or install it via pip. After installation, start the server with ‘python -m imf_data_mcp’. Configuration options are available for integration with specific applications.

Key features

Key features include listing datasets, fetching dataset structures, retrieving time series data, listing available indicators, and countries, as well as providing a query prompt template for user guidance.

Where to use

imf-data-mcp can be used in various fields such as economics, finance, research, and data analysis where IMF economic data is relevant.

IMF Data MCP

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.

Features

• List Datasets: Retrieve a list of all available IMF datasets using the Dataflow API.
• Get Dataset Structure: Fetch the structure of a specified dataset via the DataStructure API.
• Fetch Time Series Data: Retrieve time series data for various datasets (e.g., CDIS, CPIS, MFS, IFS, etc.) using the CompactData API.
• List Indicators: List all available indicators for a specific dataset using the DataMapper API.
• List Countries: Retrieve a list of available countries for a specific dataset.
• Query Prompt Template: Provide a query prompt template to guide users on how to query data with indicators and intentions.

Installation and Usage Guide

Using uv (Recommended)

You can run the server directly using uvx without additional installation:

uvx imf-data-mcp

Using PIP

Alternatively, you can install the server using pip:

pip install imf-data-mcp

After installation, run the server with:

python -m imf_data_mcp

Configuration

You can configure the server to suit different use cases. For example, to integrate with a specific application, you might add the following configuration:

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

Debugging

To debug the server, you can use the MCP Inspector. For installations using uvx, run:

npx @modelcontextprotocol/inspector uvx imf-data-mcp

Contribution Guide

We welcome contributions to the imf-data-mcp project. Whether it’s adding new tools, enhancing existing features, or improving documentation, your input is highly valuable. Please feel free to submit pull requests or open issues.

License

This project is licensed under the Apache 2.0 License. See the LICENSE file for details.

``