# Docker Hub MCP MCP

> Docker Hub manages your container images directly through conversation. This MCP lets any AI agent list repositories, search for community images by name or description, and check specific image tags—all without opening a browser. It's full lifecycle management for DevOps teams.

## Overview
- **Category:** loved-by-devs
- **Price:** Free
- **Tags:** containerization, registry, image-management, automation, repository, version-control

## Description

Managing Docker containers used to mean logging into the console, clicking through dashboards just to see if the right tag existed or who had access. Now you talk to your agent about it. This MCP connects directly to your container registry so your AI client can handle all the heavy lifting—listing repositories, searching for community images, and auditing account details on demand. You're not just viewing data; your agent acts as a dedicated registry assistant that knows exactly what image versions exist.

If you’re building complex pipelines, combining this MCP with another service, like a Git repository tracker or a CI/CD platform, allows you to chain together automations that span multiple tools through Vinkius. This means your AI agent can check the latest version tag, trigger a build, and then report on its status—all in one flow. It’s about building complete workflows, not just calling single functions.

## Tools

### create_repository
Creates an entirely new container image repository in your account.

### delete_repository
Permanently deletes a specified container image repository. Be careful, this action is irreversible.

### get_repository
Retrieves specific details about one defined container repository.

### get_tag
Fetches all metadata for a single, specified image tag within a repository.

### get_user
Returns basic details about the user account connected via the access token to verify credentials.

### list_organizations
Shows all organizational groups that the current user has membership in.

### list_repositories
Provides a list of every container repository associated with your account, including visibility and pull counts.

### list_tags
Lists all version tags available for a specified image within one repository.

### search_repositories
Searches the entire Docker Hub catalog to find public or private repositories by keywords.

### update_repository
Modifies metadata for an existing container repository, like changing its description or privacy setting.

## Prompt Examples

**Prompt:** 
```
List all my Docker repositories.
```

**Response:** 
```
I found 5 repositories: 'myapp-api' (12K pulls, public), 'myapp-web' (8K pulls, public), 'myapp-worker' (private), 'base-image' (25K pulls, public) and 'test-env' (private). Would you like details on any of them?
```

**Prompt:** 
```
Show me all available tags for the nginx official image.
```

**Response:** 
```
The nginx repository has 200+ tags. Latest versions include: 'latest' (187MB, pushed 2 days ago), '1.25-alpine' (42MB), '1.25.3' (187MB), '1.25.3-alpine' (42MB), and '1.24-perl' (205MB). Would you like details on a specific tag?
```

**Prompt:** 
```
Search for official Python images on Docker Hub.
```

**Response:** 
```
Found the official 'python' image with 1.2B+ pulls. Also found related images: 'python:alpine' (lightweight, 50MB), 'python:slim' (minimal, 130MB), and community images like 'python:3.12-slim'.
```

## Capabilities

### List all image repositories
Get a full overview of every container repository you own, including star and pull counts.

### Find specific tags for an image
Quickly check what version tags are available for any given image name (e.g., 'v1.2.3' or 'latest').

### Create new container repositories
Set up brand-new, dedicated containers to hold your application images.

### Search community images
Find popular or official public images across the entire Docker Hub catalog by name or description.

### Update repository metadata
Change details like a repo's visibility (public/private) or its main description.

## Use Cases

### A new developer needs to verify the latest stable image.
The dev asks their agent: 'What tags are available for the core API service?' The agent uses `list_tags` and reports back all versions, letting the dev pick the correct one immediately.

### The platform team needs to audit who owns what.
The architect asks: 'What organizations am I part of, and how many repositories are under my name?' The agent runs `list_organizations` then `list_repositories`, giving an instant inventory.

### You need to find a niche open-source library.
Instead of browsing the entire hub manually, you ask: 'Find me a Python image with logging capabilities.' The agent uses `search_repositories` and returns relevant matches.

### A team is retiring an old application.
The lead asks the agent to delete the repo using `delete_repository`. The agent confirms the action, preventing accidental data loss or lingering access points.

## Benefits

- Never manually check tags again. With `list_tags`, your agent finds every version of an image instantly, eliminating the need to click into a tag dashboard.
- Audit access history easily. Use `get_user` to confirm who you are connected as, which is critical when setting up new pipelines or connecting multi-service workflows.
- Build and tear down environments fast. You can use `create_repository` for temporary testing repos, then `delete_repository` once the work is done, keeping your account clean.
- Discover images without guesswork. The `search_repositories` tool lets you find community solutions by name or description across the entire hub catalog.
- Maintain consistency with `update_repository`. Need to change a repo's description or set it to private? Do it via chat instead of navigating settings menus.

## How It Works

The bottom line is you get immediate, conversational access to container registry data without touching a browser.

1. Subscribe to this MCP and provide your Docker Hub access token.
2. Connect the service to your preferred AI client, like Cursor or Claude.
3. Ask your agent a direct question, such as 'What tags are available for my web app repo?'

## Frequently Asked Questions

**How do I get a Docker Hub access token?**
Log in to [**hub.docker.com**](https://hub.docker.com/settings/security), go to **Settings > Security**, click **New Access Token**, give it a name and copy the token immediately — it starts with `dckr_pat_` and won't be shown again.

**Can I create private repositories?**
Yes! Use `create_repository` with `is_private` set to "true". Note that free Docker Hub accounts have a limited number of private repositories. Check your account plan for private repo limits.

**Can I search for public Docker images?**
Yes! Use `search_repositories` with a query like "nginx", "python" or "node". Results include the namespace, name, star count, pull count and description for each matching image. This is useful for discovering community images before pulling them.

**Can I see all tags for an image?**
Yes! Use `list_tags` with the namespace and repository name. Returns all available tags with their image sizes, last pushed dates and digests. Useful for finding the correct version to pull.

**How do I update metadata for a repository using `update_repository`?**
You can modify specific fields like description or visibility with `update_repository`. You just provide the namespace, repo name, and a JSON object containing only the fields you want to change.

**What is the process for removing a repository using `delete_repository`?**
You call `delete_repository` with the required namespace and repository name. Be aware that this action is irreversible, so double-check your request before confirming deletion.

**How can I use `list_organizations` to see my organizational scope?**
Running `list_organizations` returns a list of all organizations you belong to. This helps map out which corporate groups or teams have access to specific image repositories.

**What information does the `get_user` tool return after I connect my account?**
The `get_user` tool provides basic profile details, including your username, email, full name, company, and location. This confirms that your access token is active and working correctly.