imf-mcp-server

Imf List Databases

imf_list_databases

Read-onlyIdempotent

List IMF SDMX dataflows available on the portal. Entry point for every query: imf_get_database and imf_query_dataset both require a dataflow id obtained here. Vintage (historical snapshot) dataflows such as WEO_2025_OCT_VINTAGE are excluded by default; set include_vintages=true to include them. Results are paged — 50 per call by default and at most 200, adjustable with limit and offset — and total_count reports how many dataflows matched. Descriptions are shortened here; imf_get_database returns the full text for a single dataflow.

Input Schema

TableJSON Schema

Name	Required	Description
`limit`	No	Maximum dataflows to return in this call. Default 50; one call returns at most 200, so a larger limit (up to 1,000) returns 200 and echoes requested_limit and applied_limit. total_count reports how many matched, so a partial page is always recognizable as one.
`filter`	No	Optional words to filter results by, split on spaces and commas. A dataflow matches when every word appears, case-insensitively, somewhere in its ID, name, or full description. Example: "exchange rate" returns ER and related dataflows; "WEO outlook" returns WEO and the regional outlooks built on it.
`offset`	No	Number of matching dataflows to skip before this page. Combine with limit to page through a broad or unfiltered catalog.
`include_vintages`	No	Include vintage (historical snapshot) dataflows such as WEO_2025_OCT_VINTAGE. Default false — vintages are excluded to keep the discovery surface clean.

Output Schema

TableJSON Schema

Name	Required	Description
`cap`	No	The limit that bounded this page.
`error`	No	Present when the call failed. Absent on success.
`shown`	No	Dataflows returned in this page.
`notice`	No	Populated when the filter matches nothing, or when matches remain beyond this page — explains why and names the next offset to request.
`offset`	No	Number of matching dataflows skipped before this page.
`dataflows`	No	This page of matching dataflows; pass the id to imf_get_database to resolve dimension codelists.
`truncated`	No	True when matching dataflows remain beyond this page.
`total_count`	No	Dataflows matching filter and include_vintages, before limit and offset are applied. Exceeds returned_count when more pages remain.
`applied_limit`	No	The limit this page was cut to — the per-call maximum of 200 — echoed beside requested_limit.
`returned_count`	No	Dataflows in this page — the length of dataflows.
`requested_limit`	No	The limit requested, echoed only when it exceeded the per-call maximum of 200.

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedOct 16, 2026

changedInput schema / properties / limit / description

Previous value: -"Maximum dataflows to return in this call. Default 50, ceiling 200; total_count reports how many matched, so a partial page is always recognizable as one."New value: +"Maximum dataflows to return in this call. Default 50; one call returns at most 200, so a larger limit (up to 1,000) returns 200 and echoes requested_limit and applied_limit. total_count reports how many matched, so a partial page is always recognizable as one."

changedInput schema / properties / limit / maximum
```
Previous value: -200New value: +1000
```

addedOutput schema / properties / applied_limit

Added value: +{
+  "description": "The limit this page was cut to — the per-call maximum of 200 — echoed beside requested_limit.",
+  "type": "number"
+}

addedOutput schema / properties / requested_limit

Added value: +{
+  "description": "The limit requested, echoed only when it exceeded the per-call maximum of 200.",
+  "type": "number"
+}

Changed1 schema field changedSep 30, 2026

changedInput schema / properties / filter / description

Previous value: -"Optional name, ID, or description substring to filter results. Case-insensitive. Example: \"exchange rate\" returns ER and related dataflows."New value: +"Optional words to filter results by, split on spaces and commas. A dataflow matches when every word appears, case-insensitively, somewhere in its ID, name, or full description. Example: \"exchange rate\" returns ER and related dataflows; \"WEO outlook\" returns WEO and the regional outlooks built on it."

Changed1 schema field changedSep 19, 2026

changedOutput schema / properties / error / properties / data / properties / reason / description

Previous value: -"Machine-readable failure mode. Declared by this tool: `dataflow_list_unavailable`: The IMF SDMX structure endpoint that backs the dataflow catalog did not return a usable response Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `dataflow_list_unavailable`: The IMF SDMX structure endpoint that backs the dataflow catalog did not return a usable response. Other values are possible when a failure originates below the handler."

Changed1 schema field changedAug 31, 2026
- addedInput schema / properties / filter / minLength
```
Added value: +1
```

Changed6 schema fields changedAug 25, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

addedInput schema / additionalProperties
```
Added value: +false
```

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

addedOutput schema / anyOf

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "dataflows",
+      "total_count",
+      "returned_count",
+      "offset"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

addedOutput schema / properties / error

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `dataflow_list_unavailable`: The IMF SDMX structure endpoint that backs the dataflow catalog did not return a usable response Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "dataflow_list_unavailable"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

removedOutput schema / required

Removed value: -[
-  "dataflows",
-  "total_count",
-  "returned_count",
-  "offset"
-]

Changed12 schema fields changedAug 6, 2026

addedInput schema / properties / limit

Added value: +{
+  "default": 50,
+  "description": "Maximum dataflows to return in this call. Default 50, ceiling 200; total_count reports how many matched, so a partial page is always recognizable as one.",
+  "maximum": 200,
+  "minimum": 1,
+  "type": "integer"
+}

addedInput schema / properties / offset

Added value: +{
+  "default": 0,
+  "description": "Number of matching dataflows to skip before this page. Combine with limit to page through a broad or unfiltered catalog.",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

addedOutput schema / properties / cap

Added value: +{
+  "description": "The limit that bounded this page.",
+  "type": "number"
+}

changedOutput schema / properties / dataflows / description

Previous value: -"Matching dataflows; pass the id to imf_get_database to resolve dimension codelists."New value: +"This page of matching dataflows; pass the id to imf_get_database to resolve dimension codelists."

changedOutput schema / properties / dataflows / items / properties / description / description

Previous value: -"Extended description of the dataflow, if available."New value: +"Short description, cut to 200 characters and ended with … when longer. imf_get_database and the imf://database/{dataflow_id} resource return the full text."

changedOutput schema / properties / notice / description

Previous value: -"Populated when the filter matches nothing — explains why and suggests next steps."New value: +"Populated when the filter matches nothing, or when matches remain beyond this page — explains why and names the next offset to request."

addedOutput schema / properties / offset

Added value: +{
+  "description": "Number of matching dataflows skipped before this page.",
+  "type": "number"
+}

addedOutput schema / properties / returned_count

Added value: +{
+  "description": "Dataflows in this page — the length of dataflows.",
+  "type": "number"
+}

addedOutput schema / properties / shown

Added value: +{
+  "description": "Dataflows returned in this page.",
+  "type": "number"
+}

changedOutput schema / properties / total_count / description

Previous value: -"Total number of matching dataflows returned."New value: +"Dataflows matching filter and include_vintages, before limit and offset are applied. Exceeds returned_count when more pages remain."

addedOutput schema / properties / truncated

Added value: +{
+  "description": "True when matching dataflows remain beyond this page.",
+  "type": "boolean"
+}

changedOutput schema / required

Previous value: -[
-  "dataflows",
-  "total_count"
-]New value: +[
+  "dataflows",
+  "total_count",
+  "returned_count",
+  "offset"
+]

Changed1 schema field changedJun 10, 2026

changedInput schema / properties / filter / description

Previous value: -"Optional name or ID substring to filter results. Case-insensitive. Example: \"exchange rate\" returns ER and related dataflows."New value: +"Optional name, ID, or description substring to filter results. Case-insensitive. Example: \"exchange rate\" returns ER and related dataflows."

First observedJun 7, 2026

TDQS

Score is being calculated.

All imf-mcp-server tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.