Skip to content
MCP server

packagecloud MCP by usefulapi

Read packagecloud repos, packages, versions and download stats; create repos, promote…

Install
Runs
Remotely
Version
1.27.0
Listing updated
4 days ago

About packagecloud MCP by usefulapi

packagecloud MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read packagecloud repos, packages, versions and download stats; create repos, promote and delete.

Install

Run in a terminal

claude mcp add --transport http packagecloud https://packagecloud.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://packagecloud.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "packagecloud": {
      "url": "https://packagecloud.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "packagecloud": {
      "type": "http",
      "url": "https://packagecloud.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "packagecloud": {
      "serverUrl": "https://packagecloud.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "packagecloud": {
      "type": "http",
      "url": "https://packagecloud.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (18)

Read directly from the server.

packagecloud_list_repositories
List the package repositories of this account: name, fqname (user/repo, used by every other tool), privacy, package count and last push. include_collaborations adds repositories you collaborate on. GET /repos.
packagecloud_get_repository
One repository: name, fqname, url, privacy, package count and last push. GET /repos/{user}/{repo}.
packagecloud_create_repository
WRITE: create a new, empty package repository in this account (the plan limits how many private ones). Returns the URL of the new repository. POST /repos.
packagecloud_list_distributions
The Linux distributions and versions packagecloud supports for deb, dsc and rpm packages, with their index_name (for example ubuntu / jammy) and numeric version ids. GET /distributions.
packagecloud_list_packages
List every package file in a repository (not grouped), newest data first as the server orders it. Each item carries ready-made URLs: package_url, versions_url, downloads_*_url, promote_url, destroy_url and download_url; pass those to the other package tools. Paged. GET /repos/{user}/{repo}/packages.json.
packagecloud_search_packages
Search a repository by package file name. An empty q returns every package. filter limits by type (rpms, debs, dscs, gem, python, node); dist (for example ubuntu or el/6) overrides filter; arch applies to Alpine/RPM/Debian only. Items carry the same ready-made URLs as list_packages. Paged. GET /repos/{user}/{repo}/search.json.
packagecloud_list_package_groups
List the packages of one type, grouped by name with a versions_count and a versions_url (pass that to packagecloud_list_package_versions). Narrow by distro, then version, then arch (each needs the previous one; '*' matches any). Examples: type rpm; type deb + distro ubuntu + version jammy + arch amd64; type gem. GET /repos/{user}/{repo}/packages/{type}[/{distro}[/{version}[/{arch}]]].json.
packagecloud_get_package
Details of one package file (size, checksums, dependencies, licenses, download counts and its other URLs). Pass the package_url of an item from list_packages, search_packages or list_package_versions. GET {package_url}.
packagecloud_list_package_versions
All versions of one package name (for deb/rpm: per distro, version and architecture). Pass the versions_url of an item from list_package_groups, or derive it from a package object. Paged. GET {versions_url}.
packagecloud_get_package_downloads
Download statistics of one package version: a count, a time series, or (repository owners only) the detail of each download. Default range is the last 7 days; pass start_date=19700101Z for all time. Pass the package_url of the package; Java and generic files have no download stats. GET {package_url minus .json}/stats/downloads/{count|detail|series/<interval>}.json.
packagecloud_get_repository_installs
How often a repository was installed (set up on a machine): a count, a time series, or (owners only) the detail of each install, optionally for one distro or distro+version. Default range is the last 7 days; pass start_date=19700101Z for all time. GET /repos/{user}/{repo}/stats/installs[/{distro}[/{version}]]/{count|detail|series/<interval>}.json.
packagecloud_list_gpg_keys
The GPG keys of a repository (repository signing keys and package signing keys): name, fingerprint, type and the public key download URL. GET /repos/{user}/{repo}/gpg_keys.json.
packagecloud_get_gpg_key
One GPG key of a repository by its key name (as returned by list_gpg_keys, for example user-repo-85D7FBF915DFCBC6.pub.gpg). GET /repos/{user}/{repo}/gpg_keys/{keyname}.json.
packagecloud_get_readme
The Markdown README of a repository. GET /repos/{user}/{repo}/readme.json.
packagecloud_create_readme
WRITE: create the Markdown README of a repository. Use append_readme to add to an existing one. POST /repos/{user}/{repo}/readme.json.
packagecloud_append_readme
WRITE: append Markdown to the existing README of a repository (existing text is kept). Not idempotent: calling it twice appends twice. PATCH /repos/{user}/{repo}/readme.json.
packagecloud_promote_package
WRITE, DESTRUCTIVE: MOVE a package file to another repository (for example staging -> production). It no longer exists in the source repository afterwards, and its download statistics are cleared. Pass the promote_url of the package object and the destination as user/repo. POST {promote_url}.
packagecloud_delete_package
WRITE, DESTRUCTIVE AND IRREVERSIBLE: delete one package file from its repository (a gem is yanked). Clients that depend on it will break. Pass the destroy_url of the package object and repeat its file name (the last path segment, for example jake-1.0-2.el6.x86_64.rpm) as confirm_filename. DELETE {destroy_url}.

packagecloud MCP by usefulapi FAQ

How do I add packagecloud MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http packagecloud https://packagecloud.usefulapi.io/mcp