README.md
Real-time package versions, download counts, and service status tracking.
grounded-mcp
MCP server for real-time package versions, download counts, and service status — powered by Grounded.
Tracks 1,000+ npm and PyPI packages and 76 cloud services. No signup required.
Install
Claude Code
claude mcp add grounded -- uvx grounded-mcp
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"grounded": {
"command": "uvx",
"args": ["grounded-mcp"]
}
}
}
Cursor
Add to your MCP settings:
{
"grounded": {
"command": "uvx",
"args": ["grounded-mcp"]
}
}
Tools
| Tool | Description | Example |
|---|---|---|
check_package_version |
Latest version of an npm or PyPI package | check_package_version("react") |
check_downloads |
Weekly download count | check_downloads("flask", registry="pypi") |
check_service_status |
Cloud service operational status | check_service_status("github") |
lookup_fact |
General-purpose fact lookup | lookup_fact("npm", "react", "license") |
Available fields
For npm/PyPI packages: latest_version, license, deprecated, dep_count, required_runtime, weekly_downloads
For services: status
Configuration
Works out of the box with no API key (50 lookups/day per IP).
For higher limits, set GROUNDED_API_KEY:
claude mcp add grounded -e GROUNDED_API_KEY=your_key -- uvx grounded-mcp
Sign up for a free API key (1,000 req/day) at https://grounded-api.dev.
Example
Ask your AI assistant:
"What's the latest version of React?"
The assistant calls check_package_version("react") and gets:
Value: 19.2.4
Source: https://registry.npmjs.org/react
Fetched at: 2026-03-06T12:00:00Z
Hash: sha256:a1b2c3...
Tier: warm (TTL: 300s)
Links
Tools (4)
check_package_versionGet the latest version of an npm or PyPI package.check_downloadsGet the weekly download count for a package.check_service_statusCheck the operational status of a cloud service.lookup_factGeneral-purpose fact lookup for packages.Environment Variables
GROUNDED_API_KEYAPI key for higher request limits (1,000 req/day).Configuration
claude_desktop_config.json
{"mcpServers": {"grounded": {"command": "uvx", "args": ["grounded-mcp"]}}}Try it
→What is the latest version of React?
→How many weekly downloads does the flask package have on PyPI?
→Is GitHub currently experiencing any service outages?
→What is the license for the lodash npm package?