dhis2-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@dhis2-mcp Search for malaria indicators and query the last 12 months of confirmed cases for the district"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
dhis2-mcp
A read-only MCP server for DHIS2 health data. It runs on stdio.
The server is built for small local models. Each tool returns compact JSON, not the raw DHIS2 response. A small context window is a budget — the tools spend as little of it as possible.
Tools
Tool | What it does |
| Search DHIS2 indicators by name. Returns id, name, and description. |
| Get aggregated values for one indicator, split by period, for one organisation unit. |
Run search_indicators first to get an indicator id. Then pass the id to query_analytics.
Related MCP server: WHO MCP Server
Requirements
Node.js 20 or later.
A DHIS2 instance. The default is the public play demo, so you can start with no setup.
Install and build
git clone https://github.com/brianmituka/dhis2-mcp.git
cd dhis2-mcp
npm install
npm run buildConfiguration
Set these environment variables. All three are optional.
Variable | Default | Meaning |
|
| Base URL of the DHIS2 instance |
|
| Basic auth username |
|
| Basic auth password |
The play demo resets every night. Use the host play.im.dhis2.org, not play.dhis2.org —
the old host redirects to an HTML page.
Use with LM Studio
LM Studio 0.3.17 or later supports MCP. Open the Program tab, then edit mcp.json.
Add this entry:
{
"mcpServers": {
"dhis2": {
"command": "node",
"args": ["/absolute/path/to/dhis2-mcp/dist/index.js"],
"env": {
"DHIS2_BASE_URL": "https://play.im.dhis2.org/stable-2-43-1",
"DHIS2_USERNAME": "admin",
"DHIS2_PASSWORD": "district"
}
}
}
}Replace the path with your clone location. Restart the model chat after you edit the file.
Use with other MCP clients
Any stdio MCP client works. For Claude Code:
claude mcp add dhis2 -- node /absolute/path/to/dhis2-mcp/dist/index.jsTest with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.jsThe Inspector does not reload the server after a rebuild. Click Restart in the
Inspector after every npm run build.
License
MIT. See LICENSE.
Available Tools
2 toolsquery_analyticsQuery DHIS2 analyticsA
Get aggregated values for one indicator, split by period, for one organisation unit. Run search_indicators first to get the indicator id.
Inputs: indicator_id (required), period, org_unit.
search_indicatorsSearch DHIS2 indicatorsA
Search DHIS2 indicators by name. Returns id, name, and description for each match.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools are clearly distinct: search_indicators handles metadata discovery while query_analytics retrieves aggregated data. The explicit dependency between them removes any ambiguity.
Both tools follow the same verb_noun pattern with snake_case naming (search_indicators, query_analytics), making the naming perfectly consistent and predictable.
Two tools feels very thin for a DHIS2 server, which typically covers a broad health information system domain. The server only exposes a small analytics niche, so the count does not match the implied scope.
The core workflow of searching for indicators then querying analytics is present, but there is no way to discover organization units, periods, or other metadata within the server. This forces agents to obtain those identifiers from outside the tool surface.
Maintenance
Related MCP Connectors
Read-only Google Search Console and Google Analytics for AI agents.
Query 29,500+ World Bank development indicators for 200+ countries across 60+ years.
Search and query 1,500+ OECD statistical datasets via SDMX. Keyless.
US healthcare public data, one endpoint: prices, Medicare, MA benefits, Stars, Medicaid, providers.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables comprehensive interaction with DHIS2 health information systems through 40+ tools covering complete Web API functionality. Supports data management, tracker programs, analytics, and bulk operations for DHIS2 development and administration.477MIT
- AlicenseBqualityDmaintenanceProvides access to the World Health Organization's Global Health Observatory data, enabling AI assistants to search, retrieve, and analyze comprehensive health indicators, country statistics, disease burden data, and regional health trends through WHO's OData API.1MIT
- AlicenseAqualityDmaintenanceConnects DHIS2 health information systems to AI assistants via the Model Context Protocol, enabling natural language queries for analytics, metadata, and tracker data.13MIT
- AlicenseAqualityBmaintenanceEnables AI agents to query Kenya health facilities, maternal health indicators, immunization coverage, and disease surveillance data via the DHIS2 public API.3208 PyPIMIT