Monitly

Official21 tools

by ContentWriterco

Official statistics for AI agents: Eurostat, World Bank, OECD, IMF and WHO data for 150+ countries.

io.github.ContentWriterco/monitly MCP Server

The io.github.ContentWriterco/monitly MCP server provides official statistics for AI agents, aggregating data sources including Eurostat, World Bank, OECD, IMF, and WHO. Coverage includes statistics for 150+ countries, with content focused on delivering these datasets for use by AI-driven applications.

🛠️ Key Features

Official statistics for AI agents
Data sources: Eurostat, World Bank, OECD, IMF, WHO
Country coverage: 150+ countries

🚀 Use Cases

Supplying AI agents with official, cross-organization statistical data
Supporting analytics or information retrieval about countries using public institutional sources

⚡ Developer Benefits

Consolidates multiple institutional datasets into a single server interface

⚠️ Limitations

The provided information does not specify available tools, query methods, or output formats.

Topics

claudecursoreconomicseurostatimfmcpmcp-servermodel-context-protocoloecdopen-dataremote-mcpstatisticsworld-bankgemini-cli-extensionclaude-code-pluginclaude-plugin

Captured live from the server via tools/list.

search_catalog

Find statistical datasets in the catalog (Eurostat, World Bank, OECD, etc.). Index-backed hybrid search (name/code + embeddings). Optional country and source_name filters. Use this instead of SELECT … FROM main ILIKE. Returns compact cards, not series values.

Parameters4

query	string	required	What to find, e.g. 'GDP annual current prices' or 'unemployment rate'.
country	string	optional	Optional country name to prefer datasets that include this geo (e.g. 'Germany').
source_name	string	optional	Optional source filter, e.g. 'Eurostat', 'World Bank' (World Development Indicators), 'OECD', 'IMF'.
limit	integer	optional	Max cards (default 8, max 16).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to find, e.g. 'GDP annual current prices' or 'unemployment rate'."
    },
    "country": {
      "type": "string",
      "description": "Optional country name to prefer datasets that include this geo (e.g. 'Germany')."
    },
    "source_name": {
      "type": "string",
      "description": "Optional source filter, e.g. 'Eurostat', 'World Bank' (World Development Indicators), 'OECD', 'IMF'."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 16,
      "description": "Max cards (default 8, max 16)."
    }
  },
  "required": [
    "query"
  ]
}

search_datasets

Alias of search_catalog. Find statistical datasets by query, optional country and source_name.

Parameters4

query	string	required	What to find, e.g. 'GDP annual current prices'.
country	string	optional	Optional country name (e.g. 'Germany').
source_name	string	optional	Optional source filter, e.g. 'Eurostat'.
limit	integer	optional	Max cards (default 8, max 16).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to find, e.g. 'GDP annual current prices'."
    },
    "country": {
      "type": "string",
      "description": "Optional country name (e.g. 'Germany')."
    },
    "source_name": {
      "type": "string",
      "description": "Optional source filter, e.g. 'Eurostat'."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 16,
      "description": "Max cards (default 8, max 16)."
    }
  },
  "required": [
    "query"
  ]
}

inspect_dataset

Peek one dataset by main.id: default slice, whether a country is in the series, dataId, and the last few values. Uses indexed main_id lookup — do not scan the data table yourself for discovery.

Parameters2

id	integer	required	Dataset id (main.id) from search_catalog.
country	string	optional	Optional country to resolve in the format header (e.g. 'Germany').

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Dataset id (main.id) from search_catalog."
    },
    "country": {
      "type": "string",
      "description": "Optional country to resolve in the format header (e.g. 'Germany')."
    }
  },
  "required": [
    "id"
  ]
}

get_dataset

Get one dataset metadata row from main by id (includes dimensions, default_view, geos).

Parameters1

integer

required

Dataset id (main.id).

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Dataset id (main.id)."
    }
  },
  "required": [
    "id"
  ]
}

execute_sql

Run a read-only SELECT (or WITH … SELECT) against tables main and data only. Use after search_catalog + inspect_dataset to pull the time series for a known data.id / main_id.

Parameters1

query

string

required

SQL SELECT against main / data only.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "SQL SELECT against main / data only."
    }
  },
  "required": [
    "query"
  ]
}

list_plans

List Monitly plans (Essential, Pro, Enterprise) with prices and limits.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_plan

Current plan of the key owner: name, status, period end and limits (API/day, MCP/month, watchlist, API keys).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_usage

MCP queries this billing period, REST API requests today and watchlist slots — used, limit, remaining.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

upgrade_plan

Create a Stripe Checkout session for the Pro plan and return checkout_url. Open it in the browser for the user to pay.

Parameters1

plan_id

string

optional

Target plan (default 'pro').

Raw schema

{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string",
      "enum": [
        "pro"
      ],
      "description": "Target plan (default 'pro')."
    }
  }
}

list_watchlist

Datasets the user follows (watchlist) with source, latest period and alert status. Paginate with limit/offset.

Parameters2

limit	integer	optional	Max rows (default 20).
offset	integer	optional	Pagination offset (default 0).

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Max rows (default 20)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Pagination offset (default 0)."
    }
  }
}

add_to_watchlist

Follow a dataset by id (from search_catalog). The user gets alerts when it updates. Respects the plan's watchlist limit.

Parameters1

dataset_id

integer

required

Dataset id (main.id) from search_catalog.

Raw schema

{
  "type": "object",
  "properties": {
    "dataset_id": {
      "type": "integer",
      "description": "Dataset id (main.id) from search_catalog."
    }
  },
  "required": [
    "dataset_id"
  ]
}

add_watchlist_batch

Follow up to 100 datasets in one call. Skips duplicates and stops at the plan limit (reported in skipped_limit).

Parameters1

dataset_ids

array

required

Dataset ids (main.id).

Raw schema

{
  "type": "object",
  "properties": {
    "dataset_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Dataset ids (main.id)."
    }
  },
  "required": [
    "dataset_ids"
  ]
}

remove_from_watchlist

Unfollow a dataset by id.

Parameters1

dataset_id

integer

required

Dataset id (main.id) from search_catalog.

Raw schema

{
  "type": "object",
  "properties": {
    "dataset_id": {
      "type": "integer",
      "description": "Dataset id (main.id) from search_catalog."
    }
  },
  "required": [
    "dataset_id"
  ]
}

set_notification_preferences

action='get' returns e-mail/Slack alert settings. action='set' changes email_notifications / slack_notifications, or turns alerts for one followed dataset on/off (dataset_id + dataset_notifications).

Parameters5

action	string	required	'get' or 'set'.
email_notifications	boolean	optional	E-mail alerts for followed datasets.
slack_notifications	boolean	optional	Slack alerts (webhook is configured in Settings).
dataset_id	integer	optional	Followed dataset to change.
dataset_notifications	boolean	optional	Alerts for that dataset on/off.

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "get",
        "set"
      ],
      "description": "'get' or 'set'."
    },
    "email_notifications": {
      "type": "boolean",
      "description": "E-mail alerts for followed datasets."
    },
    "slack_notifications": {
      "type": "boolean",
      "description": "Slack alerts (webhook is configured in Settings)."
    },
    "dataset_id": {
      "type": "integer",
      "description": "Followed dataset to change."
    },
    "dataset_notifications": {
      "type": "boolean",
      "description": "Alerts for that dataset on/off."
    }
  },
  "required": [
    "action"
  ]
}

list_api_keys

Active REST API keys (mon_…) of the account: id, name, prefix, created/last used.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

create_api_key

Create a REST API key (mon_…) for /api endpoints. The raw key is returned once. Limit: 3 (Essential) / 10 (Pro).

Parameters1

name

string

optional

Label (max 100 chars).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Label (max 100 chars)."
    }
  }
}

delete_api_key

Revoke a REST API key by id. The last remaining key cannot be deleted.

Parameters1

key_id

string

required

Key id (uuid) from the list call.

Raw schema

{
  "type": "object",
  "properties": {
    "key_id": {
      "type": "string",
      "description": "Key id (uuid) from the list call."
    }
  },
  "required": [
    "key_id"
  ]
}

list_mcp_keys

Active MCP keys (mcpk_…). The key used for this session is marked current=true.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

create_mcp_key

Create another MCP key (mcpk_…), e.g. for a second client. The raw key is returned once.

Parameters1

name

string

optional

Label (max 100 chars).

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Label (max 100 chars)."
    }
  }
}

delete_mcp_key

Revoke an MCP key by id. The key used for the current session cannot be revoked here.

Parameters1

key_id

string

required

Key id (uuid) from the list call.

Raw schema

{
  "type": "object",
  "properties": {
    "key_id": {
      "type": "string",
      "description": "Key id (uuid) from the list call."
    }
  },
  "required": [
    "key_id"
  ]
}

export_dataset

Return a CSV download URL for a dataset, optionally filtered by countries and dimension values (dim1…dim8 from inspect_dataset).

Parameters3

dataset_id	integer	required	Dataset id (main.id) from search_catalog.
countries	array	optional	Country names, e.g. ['Poland','Germany'].
dimensions	object	optional	Dimension filters, e.g. {"dim1": ["Annual"], "dim2": ["Percentage"]}.

Raw schema

{
  "type": "object",
  "properties": {
    "dataset_id": {
      "type": "integer",
      "description": "Dataset id (main.id) from search_catalog."
    },
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Country names, e.g. ['Poland','Germany']."
    },
    "dimensions": {
      "type": "object",
      "description": "Dimension filters, e.g. {\"dim1\": [\"Annual\"], \"dim2\": [\"Percentage\"]}."
    }
  },
  "required": [
    "dataset_id"
  ]
}

README.md5 KBView on GitHub

📊 Monitly MCP Server – Official Statistics for AI Agents

Monitly MCP is a remote Model Context Protocol server that gives Claude, Cursor, Windsurf, VS Code and any MCP-compatible agent direct access to official statistics and economic indicators – Eurostat, World Bank, OECD, IMF, WHO and national statistical offices – for 150+ countries.

Ask in plain language: the agent finds the right dataset, checks the country coverage and pulls the time series.

Quick start

Create a free account at monit.ly and generate an MCP key in Settings → Integrations → MCP (direct link). MCP keys start with mcpk_.
Add the server to your client.

Cursor / Windsurf / VS Code / Claude Desktop (mcp.json / claude_desktop_config.json):

json

{
  "mcpServers": {
    "monitly": {
      "url": "https://monit.ly/api/mcp",
      "headers": {
        "Authorization": "Bearer mcpk_YOUR_KEY_HERE"
      }
    }
  }
}

Claude Code:

bash

claude mcp add --transport http monitly https://monit.ly/api/mcp \
  --header "Authorization: Bearer mcpk_YOUR_KEY_HERE"

Clients that only support stdio (via mcp-remote):

json

{
  "mcpServers": {
    "monitly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://monit.ly/api/mcp",
               "--header", "Authorization: Bearer mcpk_YOUR_KEY_HERE"]
    }
  }
}

Field	Value
Endpoint	`POST https://monit.ly/api/mcp`
Transport	Streamable HTTP (JSON-RPC 2.0)
Authentication	`Authorization: Bearer mcpk_…` or `X-API-Key: mcpk_…`
MCP version	`2024-11-05`
Documentation	monit.ly/mcp-docs

Example prompts

Compare HICP inflation in Poland, Germany and Czechia over the last ten years.
Rank EU countries by the latest unemployment rate.
Which EU country had the fastest real GDP growth last year?
Show government debt as % of GDP for the Baltic states since 2010.
Give me a macro snapshot of Poland: GDP, inflation, unemployment and interest rates.
How has the Polish current account balance changed quarter by quarter?

Tools

Data tools (count toward the monthly `mcp_queries` quota)

Tool	What it does
`search_catalog`	Find statistical datasets (Eurostat, World Bank, OECD, IMF…) with hybrid search (name/code + embeddings). Optional `country` and `source_name` filters. Returns compact dataset cards.
`search_datasets`	Alias of `search_catalog`.
`inspect_dataset`	Peek one dataset: default slice, whether a country is covered, `dataId` and the latest values.
`get_dataset`	Full metadata for one dataset: description, source and metadata URLs, dimensions, period range, geographies.
`execute_sql`	Read-only `SELECT` against the `main` and `data` tables to pull a full time series.
`export_dataset`	CSV download URL for a dataset, optionally filtered by countries and dimension values.

Account tools (free)

Tool	What it does
`list_plans`, `get_plan`, `get_usage`	Plans, current plan and limits, usage this billing period.
`upgrade_plan`	Returns a Stripe Checkout URL for the Pro plan.
`list_watchlist`, `add_to_watchlist`, `add_watchlist_batch`, `remove_from_watchlist`	Follow datasets and get alerts when they update.
`set_notification_preferences`	E-mail / Slack alert settings.
`list_api_keys`, `create_api_key`, `delete_api_key`	REST API keys (`mon_…`).
`list_mcp_keys`, `create_mcp_key`, `delete_mcp_key`	MCP keys (`mcpk_…`).

initialize, tools/list and ping are never metered and work without a key, so clients can list tools before you add one.

Data sources

Eurostat · World Bank · OECD · IMF · WHO · national statistical offices (e.g. Statistics Poland – BDL). Browse the catalog at monit.ly.

Monitly REST API – OpenAPI spec: openapi/v1.yaml
Compabase MCP – 3M+ Polish companies (KRS, CEIDG)

License

MIT for this repository (documentation and configuration). The Monitly service is subject to the Monitly terms.

Gemini CLI

bash

gemini extensions install https://github.com/ContentWriterco/Monitly-MCP

No account or key needed.

Claude Code plugin

This repository is also a Claude Code plugin (MCP server + skill):

code

/plugin marketplace add ContentWriterco/Monitly-MCP
/plugin install monitly@monitly-plugins

Setup guides

Step-by-step setup guides for Claude, ChatGPT, Gemini, Grok, Le Chat, Perplexity, Cursor, VS Code and Claude Code: https://monit.ly/mcp/connect

Install

Tools (21)

search_catalogsearch_datasetsinspect_datasetget_datasetexecute_sqllist_plansget_planget_usage

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://monit.ly/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "monitly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://monit.ly/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.ContentWriterco/monitly MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

search_catalog

search_datasets

inspect_dataset

get_dataset

execute_sql

list_plans

get_plan

get_usage

upgrade_plan

list_watchlist

add_to_watchlist

add_watchlist_batch

remove_from_watchlist

set_notification_preferences

list_api_keys

create_api_key

delete_api_key

list_mcp_keys

create_mcp_key

delete_mcp_key

export_dataset

📊 Monitly MCP Server – Official Statistics for AI Agents

Quick start

Example prompts

Tools

Data tools (count toward the monthly mcp_queries quota)

Account tools (free)

Data sources

Related

License

Gemini CLI

Claude Code plugin

Setup guides

Install

Remote endpoint

Related servers

Data tools (count toward the monthly `mcp_queries` quota)