check_package_version
Retrieve the latest version of a package from npm or PyPI by specifying the package name and optional registry.
Instructions
Check the latest version of a package on npm or PyPI.
Args: package_name: The package name — e.g. "react", "express", "flask", "requests" registry: "npm" or "pypi" (defaults to "npm")
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| package_name | Yes | ||
| registry | No | npm |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/grounded_mcp/server.py:59-67 (handler)The main handler for the 'check_package_version' tool. It is decorated with @mcp.tool() and delegates to _query_fact(registry, package_name, 'latest_version').
@mcp.tool() async def check_package_version(package_name: str, registry: str = "npm") -> str: """Check the latest version of a package on npm or PyPI. Args: package_name: The package name — e.g. "react", "express", "flask", "requests" registry: "npm" or "pypi" (defaults to "npm") """ return await _query_fact(registry, package_name, "latest_version") - src/grounded_mcp/server.py:59-60 (registration)The tool is registered via the @mcp.tool() decorator on the check_package_version function.
@mcp.tool() async def check_package_version(package_name: str, registry: str = "npm") -> str: - src/grounded_mcp/server.py:18-44 (helper)The _query_fact helper function that check_package_version delegates to. It makes an HTTP request to the Grounded API and formats the result.
async def _query_fact(source: str, entity: str, field: str) -> str: """Query the Grounded API and return a formatted result.""" headers = {} if API_KEY: headers["X-API-Key"] = API_KEY async with httpx.AsyncClient() as client: resp = await client.get( f"{API_BASE}/v1/fact", params={"source": source, "entity": entity, "field": field}, headers=headers, timeout=10.0, ) if resp.status_code == 200: data = resp.json() return ( f"Value: {data['value']}\n" f"Source: {data['source_url']}\n" f"Fetched at: {data['fetched_at']}\n" f"Hash: {data['raw_response_hash']}\n" f"Tier: {data['tier']} (TTL: {data['ttl_seconds']}s)" ) elif resp.status_code == 404: detail = resp.json().get("detail", "Not found") return f"Not found: {detail}" else: return f"Error: HTTP {resp.status_code}"