Skip to main content
Glama
artifacthub-mcp

artifacthub-mcp

by Ankur1911

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 transport

Add 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

search_packages

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 next_offset.

package_details

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.

security_report

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.

changelog

Release notes with trimmed change lines. Pass since_version for only the releases newer than the one you run.

chart_values

Default values.yaml of a chart. Without search: outline of top-level keys with line numbers. With search: matching lines plus context, including the publisher's inline comments.

find_repositories

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

ARTIFACTHUB_BASE_URL

https://artifacthub.io/api/v1

API root (for a self-hosted instance or proxy)

ARTIFACTHUB_TIMEOUT

30

Request timeout in seconds

ARTIFACTHUB_RETRIES

2

Retries on HTTP 429, 502, 503, 504 and timeouts

ARTIFACTHUB_MAX_CHARS

20000

Responses longer than this are cut with a notice

MCP_TRANSPORT

stdio

stdio or streamable-http

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.

  • changelog depends on the publisher providing one (for Helm, the artifacthub.io/changes annotation). Many charts do not.

  • chart_values works on the raw file with plain text matching; it does not parse YAML, so the outline lists only unindented keys.

  • search_packages returns at most 60 rows per call.

Development

uv sync
uv run pytest

Tests 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 tools
changelogA
Read-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_valuesA
Read-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_repositoriesA
Read-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_detailsA
Read-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_packagesA
Read-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_reportA
Read-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

    A4.1/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers