This is documentation for the next version of Grafana documentation. For the latest stable release, go to the latest version.

Documentation Grafana documentation Developer resources Grafana MCP server Troubleshooting Grafana version

Grafana version compatibility

Some datasource API paths exist only in newer Grafana releases. This article explains a common error on Grafana before 9.0.

What you’ll achieve

You can confirm whether an upgrade fixes datasource-related MCP errors.

Before you begin

• Access to upgrade or validate the Grafana version for your stack.

Recognize the error

If you see an error like this when using datasource-related tools:

Copy

get datasource by uid : [GET /datasources/uid/{uid}][400] getDataSourceByUidBadRequest {"message":"id is invalid"}

you are likely on Grafana before 9.0. The /datasources/uid/{uid} API was added in Grafana 9.0; datasource operations that rely on it fail on older versions.

Resolve the issue

Upgrade Grafana to 9.0 or later. The MCP server requires Grafana 9.0 or later for full functionality.

Next steps

• Introduction
• Client configuration examples