packagecloud MCP by usefulapi is an MCP server published by io.usefulapi, hosted at packagecloud.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 18 tools, including packagecloud_list_repositories, packagecloud_get_repository, packagecloud_create_repository, packagecloud_list_distributions, packagecloud_list_packages.
Read packagecloud repos, packages, versions and download stats; create repos, promote and delete.
3,949 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | 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. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "packagecloud_list_repositories",
"title": "List repositories",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List repositories",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One repository: name, fqname, url, privacy, package count and last push. GET /repos/{user}/{repo}.
| Parameter | Type | Description |
|---|---|---|
| repository * | string | The repository as "user/repo" (the fqname returned by packagecloud_list_repositories). |
{
"name": "packagecloud_get_repository",
"title": "Get repository",
"description": "One repository: name, fqname, url, privacy, package count and last push. GET /repos/{user}/{repo}.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get repository",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The new repository name. |
| private | boolean | Create a private repository (default true) or a public one. |
{
"name": "packagecloud_create_repository",
"title": "Create repository",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Create repository",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "packagecloud_list_distributions",
"title": "List distributions",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List distributions",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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). |
{
"name": "packagecloud_list_packages",
"title": "List all packages",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "List packages",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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). |
{
"name": "packagecloud_search_packages",
"title": "Search packages",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Search packages",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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). |
{
"name": "packagecloud_list_package_groups",
"title": "List package names by type",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"repository",
"type"
],
"properties": {
"arch": {
"type": "string",
"pattern": "^[A-Za-z0-9*._-]{1,64}$",
"description": "Architecture, for example amd64 or x86_64."
},
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"type": {
"type": "string",
"pattern": "^[a-z]{2,12}$",
"description": "Package type: deb, rpm, gem, python, node, java, helm, alpine ..."
},
"distro": {
"type": "string",
"pattern": "^[A-Za-z0-9*._-]{1,64}$",
"description": "Distribution name, for example ubuntu or el."
},
"version": {
"type": "string",
"pattern": "^[A-Za-z0-9*._-]{1,64}$",
"description": "Distribution version name, for example jammy or 7."
},
"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)."
}
}
},
"annotations": {
"title": "List package names by type",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| package_url * | string | The package_url of a package object, exactly as returned by the API (a /api/v1/repos/... path). |
{
"name": "packagecloud_get_package",
"title": "Get package",
"description": "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}.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get package",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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}.
| Parameter | 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). |
{
"name": "packagecloud_list_package_versions",
"title": "List package versions",
"description": "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}.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "List package versions",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 | string | Only downloads whose user agent equals this. |
| package_url * | string | The package_url of a package object, exactly as returned by the API (a /api/v1/repos/... path). |
{
"name": "packagecloud_get_package_downloads",
"title": "Get package download stats",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"package_url"
],
"properties": {
"kind": {
"enum": [
"count",
"series",
"detail"
],
"type": "string",
"default": "count",
"description": "count = total, series = per interval, detail = one record per download (owners only)."
},
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"source": {
"enum": [
"web",
"cli"
],
"type": "string",
"description": "Only downloads from the \"web\" or the \"cli\"."
},
"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
},
"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."
},
"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)."
}
}
},
"annotations": {
"title": "Get package download stats",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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). |
| repository * | string | The repository as "user/repo" (the fqname returned by packagecloud_list_repositories). |
| start_date | string | An ISO 8601 date, for example 20260101Z or 2026-01-01. |
| user_agent | string | Only downloads whose user agent equals this. |
{
"name": "packagecloud_get_repository_installs",
"title": "Get repository install stats",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Get repository install stats",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| repository * | string | The repository as "user/repo" (the fqname returned by packagecloud_list_repositories). |
{
"name": "packagecloud_list_gpg_keys",
"title": "List GPG keys",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "List GPG keys",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| key_name * | string | The GPG key name. |
| repository * | string | The repository as "user/repo" (the fqname returned by packagecloud_list_repositories). |
{
"name": "packagecloud_get_gpg_key",
"title": "Get GPG key",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get GPG key",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The Markdown README of a repository. GET /repos/{user}/{repo}/readme.json.
| Parameter | Type | Description |
|---|---|---|
| repository * | string | The repository as "user/repo" (the fqname returned by packagecloud_list_repositories). |
{
"name": "packagecloud_get_readme",
"title": "Get repository README",
"description": "The Markdown README of a repository. GET /repos/{user}/{repo}/readme.json.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get repository README",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: create the Markdown README of a repository. Use append_readme to add to an existing one. POST /repos/{user}/{repo}/readme.json.
| Parameter | Type | Description |
|---|---|---|
| body * | string | The README, as Markdown. |
| repository * | string | The repository as "user/repo" (the fqname returned by packagecloud_list_repositories). |
{
"name": "packagecloud_create_readme",
"title": "Create repository README",
"description": "WRITE: create the Markdown README of a repository. Use append_readme to add to an existing one. POST /repos/{user}/{repo}/readme.json.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Create repository README",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| body * | string | Markdown to append to the README. |
| repository * | string | The repository as "user/repo" (the fqname returned by packagecloud_list_repositories). |
{
"name": "packagecloud_append_readme",
"title": "Append to repository README",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Append to repository README",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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}.
| Parameter | 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). |
{
"name": "packagecloud_promote_package",
"title": "Promote (move) package",
"description": "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}.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Promote (move) package",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}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}.
| Parameter | 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). |
{
"name": "packagecloud_delete_package",
"title": "Delete (yank) package",
"description": "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}.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Delete (yank) package",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for packagecloud, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which package repositories do I have, and how many packages are in each?"; "List all versions of the package my-agent in my main repository."; "How many times was my release repository installed this month?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes packagecloud data. Free plan: 50 tool calls per month. Run packagecloud_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run packagecloud_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run packagecloud_upgrade without a plan: it returns both plans, each with a payment link for the user to open. packagecloud_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.