artifacthub-mcp
Provides read-only tools for querying the Artifact Hub package index, including searching cloud-native packages, retrieving package details, summarizing published security reports and changelogs, inspecting Helm chart values, and finding repositories/publishers.
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., "@artifacthub-mcp find the ingress-nginx helm chart and show its security report"
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.
artifacthub-mcp
A Model Context Protocol server for Artifact Hub, the public index of cloud-native packages: Helm charts, operators, kubectl plugins, policies (Kyverno, OPA, Gatekeeper), container images and more. It needs no API key and is read-only.
The tools are shaped around questions people ask when choosing or upgrading a package, not one tool per endpoint. Package ids are resolved internally, security reports and changelogs are summarised, large values.yaml files are searchable instead of dumped, readmes are left out, and failures come back as readable messages.
Setup
Requires Python 3.12+ and uv.
git clone https://github.com/Ankur1911/artifacthub-mcp && cd artifacthub-mcp
uv sync
uv run artifacthub-mcp # stdio transportAdd it to any MCP client that launches stdio servers:
{
"mcpServers": {
"artifacthub": {
"command": "uv",
"args": ["run", "--directory", "/path/to/artifacthub-mcp", "artifacthub-mcp"]
}
}
}For HTTP instead of stdio: MCP_TRANSPORT=streamable-http MCP_HOST=127.0.0.1 MCP_PORT=8000 uv run artifacthub-mcp.
Related MCP server: mcp-deezer
Tools
All tools are read-only. Start with search_packages; it returns the kind, repo and name that the other tools take.
Tool | What it returns |
| Compact rows for a text query: kind, repo, name, version, app version, stars, last update, deprecated/signed/verified/official flags and a non-zero vulnerability summary. Filters for kind, organization, verified publisher, official repos; sorting; paging with |
| One-call profile: description, install reference, chart dependencies, container images, recent versions with dates and security-update flags, source links, maintainers (names only), signing, vulnerability summary, stars and production-usage count. |
| Resolves the package id, fetches the published Trivy scan, and returns per-image counts by severity with how many are fixable, then the worst findings (critical first, fixable first) with installed and fixed versions. A missing report is explained rather than raised. |
| Release notes with trimmed change lines. Pass |
| Default |
| Repositories (publishers) by name: kind, URL, organization, verified/official flags, last tracked date. |
Supported kinds: helm, olm, krew, container, kyverno, opa, gatekeeper, falco, backstage, keda-scaler, tekton-task, tekton-pipeline, argo-template, kubewarden, kcl, headlamp and the other kinds Artifact Hub lists (see KINDS in src/artifacthub_mcp/client.py).
Configuration
All optional environment variables:
Variable | Default | Meaning |
|
| API root (for a self-hosted instance or proxy) |
|
| Request timeout in seconds |
|
| Retries on HTTP 429, 502, 503, 504 and timeouts |
|
| Responses longer than this are cut with a notice |
|
|
|
Limits
Only unauthenticated endpoints are used. Starring, subscriptions, webhooks and repository management are not exposed.
Artifact Hub applies its own rate limits to anonymous clients; the server retries politely but does not queue requests.
Security reports are the scans Artifact Hub publishes for the images a chart references. They can lag the newest vulnerability data, and a clean result does not mean a package is safe. Not every kind has images to scan.
changelogdepends on the publisher providing one (for Helm, theartifacthub.io/changesannotation). Many charts do not.chart_valuesworks on the raw file with plain text matching; it does not parse YAML, so the outline lists only unindented keys.search_packagesreturns at most 60 rows per call.
Development
uv sync
uv run pytestTests mock all HTTP traffic with respx; no network access is needed.
Licence
MIT. Author: Ankur Kapuriya. Not affiliated with or endorsed by Artifact Hub, the CNCF or the Helm project.
Available Tools
6 toolschangelogARead-onlyIdempotent
Release notes for a package. Pass since_version to get only the releases newer than the version you run (the upgrade delta); otherwise the newest entries are returned. Each entry has the date, a security-update flag and trimmed change lines. Not every publisher provides a changelog; that case is reported.
Inputs: kind (required), name (required), repo (required), limit, +1 more.
chart_valuesARead-onlyIdempotent
Inspect a chart's default values.yaml without downloading all of it (they are often thousands of lines). Without search it returns an outline of top-level keys with line numbers. With search it returns matching lines with surrounding lines, which keeps the publisher's inline comments, e.g. search='persistence' or 'resources'.
Inputs: name (required), repo (required), kind, search, +3 more.
find_repositoriesARead-onlyIdempotent
Find package repositories (publishers) by name, for example to see whether a vendor has a verified or official repo, which kind it hosts, its URL and when Artifact Hub last tracked it.
Inputs: query (required), org, kind, limit.
package_detailsARead-onlyIdempotent
One-call profile of a package: description, versions (latest plus recent releases with dates and security-update flags), install reference, chart dependencies, container images, vulnerability summary, source links, maintainers, signing, publisher trust flags, stars and production-usage count. Readme text is left out on purpose.
Inputs: kind (required), name (required), repo (required), version, +1 more.
search_packagesARead-onlyIdempotent
Search Artifact Hub packages by free text (websearch syntax: quoted phrases, -exclusions, 'or'). Returns compact rows with kind, repo, name, version, app version, stars, last update, publisher trust flags and a non-zero vulnerability summary, plus the total count and next_offset for paging. Use the kind/repo/name values with the other tools.
Inputs: query (required), org, kind, sort, +5 more.
security_reportARead-onlyIdempotent
Vulnerability scan summary for a package version's container images (Trivy results published on Artifact Hub). Resolves the package id itself. Returns per-image counts by severity and how many have a fix, then the worst findings (critical first, fixable first) with installed and fixed versions. An absent report is explained, not an error.
Inputs: kind (required), name (required), repo (required), top, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct facet of the Artifact Hub workflow: discovery (search_packages, find_repositories), package profiling (package_details), and deep-dives (security_report, changelog, chart_values). The only near-overlap — vulnerability summaries in package_details vs. the detailed scan in security_report — is explicitly clarified in the descriptions as summary vs. per-image findings.
All names are consistent snake_case, but the style is mixed between verb_noun (search_packages, find_repositories) and bare noun phrases (package_details, security_report, changelog, chart_values). Terminology also drifts slightly between 'packages' and 'chart' (chart_values), which is a minor deviation from an otherwise predictable pattern.
Six tools is well-scoped for a read-only registry-inspection server, with no filler: search, profile, security, changelog, values and repo lookup each cover a distinct user need. Nothing feels thin or padded.
The surface covers the natural read lifecycle: discover packages and repos, get full package metadata, inspect security posture, review release notes, and examine chart defaults. Minor gaps exist (e.g. no way to list all versions of a package independently, no signature/verification or compare-versions helper), but agents can work around these via the existing tools.
Maintenance
Related MCP Connectors
Read-only search and page retrieval from the public Atisbo documentation corpus. No authentication.
Read-only CodeAtlas service catalog: list, get and search services. No authentication.
Anonymous read-only access to source-backed public SHAR Production knowledge.
Public, read-only: search Splice docs and list models, live prices and templates. No sign-in.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with the dev.to platform through its public API. Allows users to retrieve articles, user profiles, tags, comments, and perform article searches without requiring authentication.46MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching and retrieving metadata from Deezer's public catalog including tracks, albums, artists, and charts without authentication.100 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables read-only access to Pocket Agent's product information, public persona templates, and app catalog. No authentication required.53 npm1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to search repositories, inspect files and code, list issues and commits, check releases, and look up GitHub user profiles through the GitHub public REST API without authentication.516 npmMIT