Disease Stats

live Health

COVID-19 global and country statistics, historical timelines, and vaccination coverage from disease.sh

4 tools
0ms auth
free tier 50 calls/day

Tools

get_global_stats

Get global COVID-19 statistics. Returns total cases, deaths, recovered, active cases, and today's new cases and deaths.

No parameters required.

▶ Try it
get_country_stats required: country

Get COVID-19 statistics for a specific country. Returns cases, deaths, recovered, active, today's new cases/deaths, and population.

Parameters
Name Type Description
country req string Country name or ISO code (e.g., "USA", "germany", "gb")
▶ Try it
get_historical

Get historical COVID-19 timeline data for a country or globally. Returns daily timeline of cases, deaths, and recoveries.

Parameters
Name Type Description
country opt string Country name or "all" for global data (default: "all")
days opt number Number of days of history to return (default: 30)
▶ Try it
get_vaccine_stats

Get COVID-19 vaccination coverage timeline. Returns daily cumulative vaccine doses administered over the last 30 days.

Parameters
Name Type Description
country opt string Country name to get vaccine data for. Omit for global totals.
▶ Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash 
curl -X POST https://gateway.pipeworx.io/disease/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash 
curl -X POST https://gateway.pipeworx.io/disease/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_global_stats","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript 
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get_global_stats", {});
ask_pipeworx 
// Or ask in plain English:
const answer = await px.ask("covid-19 global and country statistics, historical timelines, and vaccination coverage from disease");