Edit icon Edit This Page

MCP Tools

The tools that rp mcp offers to an AI agent. The read tools are always there; a write tool is listed only while the credential may use it: a login session may use every write tool, an access token needs the scope named below, and rp mcp --read-only hides them all. No tool deletes, revokes or rotates anything. rp mcp tools prints the same list.

ToolAccessTitle
create_deploy_tokenWrite, needs a login session or a token with repo:manage.Create a deploy token
create_repoWrite, needs a login session or a token with repo:manage.Create a repository
get_client_setupRead.Get client setup
get_packageRead.Get a package
get_repoRead.Get a repository
get_scan_overviewRead.Get the scan overview of a version
get_usageRead.Get usage
list_deploy_tokensRead.List deploy tokens
list_package_tagsRead.List package tags
list_packagesRead.List packages
list_repo_contentsRead.List repository contents
list_reposRead.List repositories
list_scan_findingsRead.List scan findings
list_scansRead.List the scans of a version
trigger_scanWrite, needs a login session or a token with repo:write.Start a security scan
whoamiRead.Who am I

create_deploy_token

Create a deploy token. Write, needs a login session or a token with repo:manage.

Create a deploy token for a repository, for a CI job or a client that must not use a personal credential. The result holds the secret once: it goes into this conversation and the transcript of the client, so prefer creating it in a terminal with rp token create when that matters.

ArgumentTypeRequiredDescription
namestringyesa name for the token, 1 to 80 characters
repostringyesthe repository name, as list_repos returns it
expires_in_daysintegernothe life of the token in days, 1 to 365; default 365
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain
read_onlybooleannotrue for a token that can only read (download)
usernamestringnothe username the token signs in with; default: the server chooses one

create_repo

Create a repository. Write, needs a login session or a token with repo:manage.

Create a repository, private unless public is true. On Repsy OS only an administrator can; on Repsy Cloud it belongs to the account of the credential. A name that is taken is an error, nothing is overwritten.

ArgumentTypeRequiredDescription
formatstringyesmaven, npm, pypi, docker, cargo, nuget, go, helm or ruby
namestringyesthe name of the new repository
descriptionstringnoa description of the repository
publicbooleannotrue makes the repository readable without credentials; default private

get_client_setup

Get client setup. Read.

Return the configuration that rp <format> setup would write for a repository: the files and the lines it adds, the commands it runs and the steps left to the user. Nothing is written, and the user’s own files are not read. The token is a reference to an environment variable, never the token itself. The repository is read once to check that it exists.

ArgumentTypeRequiredDescription
formatstringyesthe client: maven, npm, pypi, docker, cargo, nuget, go, helm or ruby
repostringyesthe repository name, as list_repos returns it
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain
scopestringnouser or project; default user. Not every format has both

get_package

Get a package. Read.

Return one package, version, Docker tag or manifest, with the API’s own fields for the format. Coordinates are the natural ones of the format: maven group[:artifact[:version]], npm [@scope/]name[@version] (@scope alone: the packages of a scope), docker image[:tag] or image@sha256:digest (the image may contain /), go module/path[@version], cargo, helm, nuget, pypi and ruby name[@version].

ArgumentTypeRequiredDescription
coordinatesstringyesthe package, or one version of it when the coordinates carry a version; a Maven group alone is the group summary, a Docker image@digest the stored manifest
repostringyesthe repository name, as list_repos returns it
formatstringnothe repository format (maven, npm, pypi, docker, cargo, nuget, go, helm or ruby); omit it to read it from the repository, which costs one request
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain
platformstringnoRuby only: the gem platform of the version, such as java

get_repo

Get a repository. Read.

Return one repository with its settings: format, visibility, disk usage, and whether it takes snapshots, releases and overrides.

ArgumentTypeRequiredDescription
repostringyesthe repository name, as list_repos returns it
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain

get_scan_overview

Get the scan overview of a version. Read.

Return the vulnerability counts by severity of the latest security scan of one package version, with the id of that scan and its status.

ArgumentTypeRequiredDescription
artifactstringyesthe package name as the repository lists it, without an npm scope
repostringyesthe repository name, as list_repos returns it
versionstringyesthe version of the package
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain
scopestringnonpm only: the scope of a scoped package, with or without the @

get_usage

Get usage. Read.

Return the disk use and traffic of the account. The server answers this for a login session only; with an access token the tool refuses without sending anything.

No arguments.

list_deploy_tokens

List deploy tokens. Read.

List the deploy tokens of a repository: name, username, read-only or not, and expiry. The secrets are never returned; the server keeps no copy to show.

ArgumentTypeRequiredDescription
repostringyesthe repository name, as list_repos returns it
limitintegernothe most rows to return, 1 to 200; default 50
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain

list_package_tags

List package tags. Read.

List the distribution tags of an npm package or the OCI tags of a Helm chart. The tags of a Docker image are a list_packages call with the image as coordinates. Coordinates are the natural ones of the format: maven group[:artifact[:version]], npm [@scope/]name[@version] (@scope alone: the packages of a scope), docker image[:tag] or image@sha256:digest (the image may contain /), go module/path[@version], cargo, helm, nuget, pypi and ruby name[@version].

ArgumentTypeRequiredDescription
coordinatesstringyesthe npm package or Helm chart, without a version
repostringyesthe repository name, as list_repos returns it
formatstringnothe repository format (maven, npm, pypi, docker, cargo, nuget, go, helm or ruby); omit it to read it from the repository, which costs one request
limitintegernothe most rows to return, 1 to 200; default 50
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain

list_packages

List packages. Read.

List the packages of a repository, or the next level down for the given coordinates: the versions of a package, the artifacts of a Maven group, the tags of a Docker image or the manifests of a tag. Coordinates are the natural ones of the format: maven group[:artifact[:version]], npm [@scope/]name[@version] (@scope alone: the packages of a scope), docker image[:tag] or image@sha256:digest (the image may contain /), go module/path[@version], cargo, helm, nuget, pypi and ruby name[@version].

ArgumentTypeRequiredDescription
repostringyesthe repository name, as list_repos returns it
coordinatesstringnoomit it for the packages of the repository; give a package for its versions, a Maven group for its artifacts, a Docker image for its tags or image:tag for its manifests
formatstringnothe repository format (maven, npm, pypi, docker, cargo, nuget, go, helm or ruby); omit it to read it from the repository, which costs one request
limitintegernothe most rows to return, 1 to 200; default 50
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain
searchstringnoonly rows whose name contains this text, case-insensitive; a few lists have no such filter and say so

list_repo_contents

List repository contents. Read.

List the files and directories stored in a Maven repository at one path, as the registry keeps them (one level, not recursive). Only Maven repositories have this file tree; list the packages of any other format with list_packages.

ArgumentTypeRequiredDescription
repostringyesthe repository name, as list_repos returns it
limitintegernothe most rows to return, 1 to 200; default 50
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain
pathstringnoa directory inside the repository, such as com/acme; omit it for the root

list_repos

List repositories. Read.

List the repositories the credential can see. On Repsy Cloud this includes the repositories of accounts the user collaborates with, and each row names its owner; pass that owner to the other tools.

ArgumentTypeRequiredDescription
formatstringnoonly repositories of this format (maven, npm, pypi, docker, cargo, nuget, go, helm or ruby)
limitintegernothe most rows to return, 1 to 200; default 50
searchstringnoonly repositories whose name contains this text, case-insensitive

list_scan_findings

List scan findings. Read.

List the vulnerabilities a security scan found in one package version: CVE, severity, affected package and version, fixed version and CVSS score. Without scan_id the latest scan is read.

ArgumentTypeRequiredDescription
artifactstringyesthe package name as the repository lists it, without an npm scope
repostringyesthe repository name, as list_repos returns it
versionstringyesthe version of the package
limitintegernothe most rows to return, 1 to 200; default 50
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain
scan_idstringnothe id of a scan from list_scans; omit it for the latest scan
scopestringnonpm only: the scope of a scoped package, with or without the @
sortstringnoproperty,direction, for example severity,desc or cvssScore,desc; properties: id, cveId, severity, packageName, packageVersion, fixedVersion, description, referenceUrl, fixStatus, cvssScore, cvssVector

list_scans

List the scans of a version. Read.

List the security scans of one package version, newest first: status, highest severity, scanner and times.

ArgumentTypeRequiredDescription
artifactstringyesthe package name as the repository lists it, without an npm scope
repostringyesthe repository name, as list_repos returns it
versionstringyesthe version of the package
limitintegernothe most rows to return, 1 to 200; default 50
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain
scopestringnonpm only: the scope of a scoped package, with or without the @

trigger_scan

Start a security scan. Write, needs a login session or a token with repo:write.

Start a security scan of one package version. When a scan of the version is already running (an upload starts one when a scanner is enabled) the tool attaches to it instead of failing. With wait_seconds it waits for the scan to finish, up to 300 seconds.

ArgumentTypeRequiredDescription
artifactstringyesthe package name as the repository lists it, without an npm scope; a Maven artifact is groupId:artifactId
repostringyesthe repository name, as list_repos returns it
versionstringyesthe version of the package
ownerstringnoRepsy Cloud only: the owner (user or organisation) of the repository, as list_repos returns it; omit it for the owner of the rp profile. Refused on Repsy OS and on a Cloud custom domain
scopestringnonpm only: the scope of a scoped package, with or without the @
wait_secondsintegernowait up to this many seconds (at most 300) for the scan to finish; 0, the default, returns at once

whoami

Who am I. Read.

Return the Repsy host, the product (os or cloud), the user and the kind of credential this server signs requests with. Call it first to know which registry the other tools talk to.

No arguments.

Found a problem with this page?