Skip to main content
Open browser to create a Personal Access Token for a container registry.

​
Parameters

ParameterTypeDefaultDescription
registry_urlstringrequiredRegistry URL (e.g., docker://ghcr.io/org/image)

​
Known Registries

RegistryPAT Page
docker.ioDocker Hub PAT settings
ghcr.ioGitHub fine-grained tokens
registry.gitlab.comGitLab PAT settings
gcr.ioGoogle Cloud credentials

​
Examples

Docker Hub: 
{"registry_url": "docker://docker.io/library/alpine"}
GitHub Container Registry: 
{"registry_url": "docker://ghcr.io/org/image"}
Bare image name (defaults to docker.io): 
{"registry_url": "alpine"}

​
Response

Success: 
{
  "status": "success",
  "registry": "docker.io",
  "url": "https://app.docker.com/settings/personal-access-tokens",
  "message": "Browser opened to ... Create a read-only PAT, then provide your username and token.",
  "agent_instruction": "STOP HERE. Wait for user to create PAT and provide the token."
}
Unknown registry: 
{
  "status": "error",
  "registry": "unknown.example.com",
  "message": "Unknown registry 'unknown.example.com'. Please consult the registry documentation for token creation."
}

​
Workflow

  1. Call registry_token_obtain → opens browser
  2. User creates read-only PAT in registry web UI
  3. User provides username and token
  4. Call registry_auth to validate and store credentials
  5. Call import_image to import images