Servers Playground How we check Add a server Log in

packagecloud MCP by usefulapi

Working · 524 ms

io.usefulapi/packagecloudv1.4.0 Domain verified

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

Developer Tools

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://packagecloud.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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.

bodystring, required

Markdown to append to the README.

repositorystring, required

The repository as "user/repo" (the fqname returned by packagecloud_list_repositories).

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

packagecloud MCP by usefulapi MCP server | mcptry

Tools (18)

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.

Argument	Type	Description
body*	string	Markdown to append to the README.
repository*	string	The repository as "user/repo" (the fqname returned by packagecloud_list_repositories).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "repository",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "maxLength": 100000,
      "minLength": 1,
      "description": "Markdown to append to the README."
    },
    "repository": {
      "type": "string",
      "maxLength": 201,
      "minLength": 3,
      "description": "The repository as \"user/repo\" (the fqname returned by packagecloud_list_repositories)."
    }
  }
}

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.

Argument	Type	Description
body*	string	The README, as Markdown.
repository*	string	The repository as "user/repo" (the fqname returned by packagecloud_list_repositories).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "repository",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "maxLength": 100000,
      "minLength": 1,
      "description": "The README, as Markdown."
    },
    "repository": {
      "type": "string",
      "maxLength": 201,
      "minLength": 3,
      "description": "The repository as \"user/repo\" (the fqname returned by packagecloud_list_repositories)."
    }
  }
}

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.

Argument	Type	Description
name*	string	The new repository name.
private	boolean	Create a private repository (default true) or a public one.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
      "description": "The new repository name."
    },
    "private": {
      "type": "boolean",
      "default": true,
      "description": "Create a private repository (default true) or a public one."
    }
  }
}

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

destructive

Argument	Type	Description
scope	string	Only for a scoped Node.js package: the scope including the @, for example @example.
destroy_url*	string	The destroy_url of a package object, exactly as returned by the API (a /api/v1/repos/... path).
confirm_filename*	string	The package file name, exactly as in the last segment of destroy_url (the 'filename' field of the package).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "destroy_url",
    "confirm_filename"
  ],
  "properties": {
    "scope": {
      "type": "string",
      "pattern": "^@[A-Za-z0-9._-]{1,100}$",
      "description": "Only for a scoped Node.js package: the scope including the @, for example @example."
    },
    "destroy_url": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 10,
      "description": "The destroy_url of a package object, exactly as returned by the API (a /api/v1/repos/... path)."
    },
    "confirm_filename": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1,
      "description": "The package file name, exactly as in the last segment of destroy_url (the 'filename' field of the package)."
    }
  }
}

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.

read-only

Argument	Type	Description
key_name*	string	The GPG key name.
repository*	string	The repository as "user/repo" (the fqname returned by packagecloud_list_repositories).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "repository",
    "key_name"
  ],
  "properties": {
    "key_name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "The GPG key name."
    },
    "repository": {
      "type": "string",
      "maxLength": 201,
      "minLength": 3,
      "description": "The repository as \"user/repo\" (the fqname returned by packagecloud_list_repositories)."
    }
  }
}

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

read-only

Argument	Type	Description
package_url*	string	The package_url of a package object, exactly as returned by the API (a /api/v1/repos/... path).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "package_url"
  ],
  "properties": {
    "package_url": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 10,
      "description": "The package_url of a package object, exactly as returned by the API (a /api/v1/repos/... path)."
    }
  }
}

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.

read-only

Argument	Type	Description
kind	string	count = total, series = per interval, detail = one record per download (owners only).
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
source	string	Only downloads from the "web" or the "cli".
end_date	string	An ISO 8601 date, for example 20260101Z or 2026-01-01.
interval	string	Series interval, "daily" (default) or "weekly".
per_page	integer	Results per page (default 30; the server caps it at its own Max-Per-Page).
start_date	string	An ISO 8601 date, for example 20260101Z or 2026-01-01.
user_agent

packagecloud_get_readme

The Markdown README of a repository. GET /repos/{user}/{repo}/readme.json.

read-only

Argument	Type	Description
repository*	string	The repository as "user/repo" (the fqname returned by packagecloud_list_repositories).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "repository"
  ],
  "properties": {
    "repository": {
      "type": "string",
      "maxLength": 201,
      "minLength": 3,
      "description": "The repository as \"user/repo\" (the fqname returned by packagecloud_list_repositories)."
    }
  }
}

packagecloud_get_repository

One repository: name, fqname, url, privacy, package count and last push. GET /repos/{user}/{repo}.

read-only

Argument	Type	Description
repository*	string	The repository as "user/repo" (the fqname returned by packagecloud_list_repositories).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "repository"
  ],
  "properties": {
    "repository": {
      "type": "string",
      "maxLength": 201,
      "minLength": 3,
      "description": "The repository as \"user/repo\" (the fqname returned by packagecloud_list_repositories)."
    }
  }
}

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.

read-only

Argument	Type	Description
kind	string	count = total, series = per interval, detail = one record per install (owners only; includes host names and IP addresses).
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
distro	string	Only installs on this distribution, for example ubuntu.
version	string	Only installs on this distribution version, for example jammy (needs distro).
end_date	string	An ISO 8601 date, for example 20260101Z or 2026-01-01.
interval	string	Series interval, "daily" (default) or "weekly".
per_page	integer	Results per page (default 30; the server caps it at its own Max-Per-Page).

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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.

read-only

Argument	Type	Description
repository*	string	The repository as "user/repo" (the fqname returned by packagecloud_list_repositories).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "repository"
  ],
  "properties": {
    "repository": {
      "type": "string",
      "maxLength": 201,
      "minLength": 3,
      "description": "The repository as \"user/repo\" (the fqname returned by packagecloud_list_repositories)."
    }
  }
}

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.

read-only

Argument	Type	Description
arch	string	Architecture, for example amd64 or x86_64.
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
type*	string	Package type: deb, rpm, gem, python, node, java, helm, alpine ...
distro	string	Distribution name, for example ubuntu or el.
version	string	Distribution version name, for example jammy or 7.
per_page	integer	Results per page (default 30; the server caps it at its own Max-Per-Page).
repository*	string	The repository as "user/repo" (the fqname returned by packagecloud_list_repositories).

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

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	Results per page (default 30; the server caps it at its own Max-Per-Page).
versions_url*	string	The versions_url of a package object, exactly as returned by the API (a /api/v1/repos/... path).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "versions_url"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page (default 30; the server caps it at its own Max-Per-Page).",
      "exclusiveMinimum": 0
    },
    "versions_url": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 10,
      "description": "The versions_url of a package object, exactly as returned by the API (a /api/v1/repos/... path)."
    }
  }
}

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	Results per page (default 30; the server caps it at its own Max-Per-Page).
repository*	string	The repository as "user/repo" (the fqname returned by packagecloud_list_repositories).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "repository"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page (default 30; the server caps it at its own Max-Per-Page).",
      "exclusiveMinimum": 0
    },
    "repository": {
      "type": "string",
      "maxLength": 201,
      "minLength": 3,
      "description": "The repository as \"user/repo\" (the fqname returned by packagecloud_list_repositories)."
    }
  }
}

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
per_page	integer	Results per page (default 30; the server caps it at its own Max-Per-Page).
include_collaborations	boolean	Also list repositories that belong to other accounts but that you collaborate on.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page (default 30; the server caps it at its own Max-Per-Page).",
      "exclusiveMinimum": 0
    },
    "include_collaborations": {
      "type": "boolean",
      "description": "Also list repositories that belong to other accounts but that you collaborate on."
    }
  }
}

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

destructive

Argument	Type	Description
scope	string	Only for a scoped Node.js package: the scope including the @, for example @example.
destination*	string	The destination repository as "user/repo" (it must already exist).
promote_url*	string	The promote_url of a package object, exactly as returned by the API (a /api/v1/repos/... path).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "promote_url",
    "destination"
  ],
  "properties": {
    "scope": {
      "type": "string",
      "pattern": "^@[A-Za-z0-9._-]{1,100}$",
      "description": "Only for a scoped Node.js package: the scope including the @, for example @example."
    },
    "destination": {
      "type": "string",
      "maxLength": 201,
      "minLength": 3,
      "description": "The destination repository as \"user/repo\" (it must already exist)."
    },
    "promote_url": {
      "type": "string",
      "maxLength": 1000,
      "minLength": 10,
      "description": "The promote_url of a package object, exactly as returned by the API (a /api/v1/repos/... path)."
    }
  }
}

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.

read-only

Argument	Type	Description
q	string	Part of the package file name; empty returns all packages.
arch	string	Architecture, for example x86_64, arm64 or amd64.
dist	string	Distribution, for example ubuntu or el/6.
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
filter	string	Package type: rpms, debs, dscs, gem, python or node. Ignored when dist is given.
per_page	integer	Results per page (default 30; the server caps it at its own Max-Per-Page).
repository*	string	The repository as "user/repo" (the fqname returned by packagecloud_list_repositories).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "repository"
  ],
  "properties": {
    "kind": {
      "enum": [
        "count",
        "series",
        "detail"
      ],
      "type": "string",
      "default": "count",
      "description": "count = total, series = per interval, detail = one record per install (owners only; includes host names and IP addresses)."
    },
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "distro": {
      "type": "string",
      "pattern": "^[A-Za-z0-9*._-]{1,64}$",
      "description": "Only installs on this distribution, for example ubuntu."
    },
    "version": {
      "type": "string",
      "pattern": "^[A-Za-z0-9*._-]{1,64}$",
      "description": "Only installs on this distribution version, for example jammy (needs distro)."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{8}Z?$|^\\d{4}-\\d{2}-\\d{2}(T[0-9:.]{2,12})?Z?$",
      "description": "An ISO 8601 date, for example 20260101Z or 2026-01-01."
    },
    "interval": {
      "type": "string",
      "default": "daily",
      "pattern": "^[a-z]{3,10}$",
      "description": "Series interval, \"daily\" (default) or \"weekly\"."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page (default 30; the server caps it at its own Max-Per-Page).",
      "exclusiveMinimum": 0
    },
    "repository": {
      "type": "string",
      "maxLength": 201,
      "minLength": 3,
      "description": "The repository as \"user/repo\" (the fqname returned by packagecloud_list_repositories)."
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{8}Z?$|^\\d{4}-\\d{2}-\\d{2}(T[0-9:.]{2,12})?Z?$",
      "description": "An ISO 8601 date, for example 20260101Z or 2026-01-01."
    },
    "user_agent": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only downloads whose user agent equals this."
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "repository"
  ],
  "properties": {
    "q": {
      "type": "string",
      "default": "",
      "maxLength": 200,
      "description": "Part of the package file name; empty returns all packages."
    },
    "arch": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,32}$",
      "description": "Architecture, for example x86_64, arm64 or amd64."
    },
    "dist": {
      "type": "string",
      "pattern": "^[A-Za-z0-9._/-]{1,64}$",
      "description": "Distribution, for example ubuntu or el/6."
    },
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "filter": {
      "type": "string",
      "pattern": "^[A-Za-z]{2,12}$",
      "description": "Package type: rpms, debs, dscs, gem, python or node. Ignored when dist is given."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page (default 30; the server caps it at its own Max-Per-Page).",
      "exclusiveMinimum": 0
    },
    "repository": {
      "type": "string",
      "maxLength": 201,
      "minLength": 3,
      "description": "The repository as \"user/repo\" (the fqname returned by packagecloud_list_repositories)."
    }
  }
}