# Docker Hub MCP for AI Agents AI Agent Connect > Docker Hub lets you manage your container images through your agent. You can list repositories, browse specific tags, create new hosts, and search the community registry for the right base images. It handles the heavy lifting of navigating the Docker Hub website, letting you focus on deployment and configuration. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ffdmDWTXZHfe3wwCZhc1wGAayNfR7ufnlBz3HHzP/ai-agent-connect - **Tags:** containerization, registry, image-management, automation, repository, version-control ## Description Docker Hub lets you manage your container images through a direct conversation with your agent. Instead of jumping between browser tabs to check if a specific tag was pushed or hunting for the right architecture in a sea of results, you just ask your agent to do the heavy lifting. You can pull up your own repository list, see how many pulls an image is getting, or even spin up a new private repo on the fly. It turns your agent into a dedicated registry assistant that knows your account's structure inside out. When you need to audit your organization's membership or find a specific version of a community image, it's all just a quick conversation away. This is one of the many ways Vinkius helps bridge the gap between your dev tools and the actual services you use every day. You get to stay in your flow state while your agent handles the repetitive navigation and data fetching of the Docker Hub service. No more manual searching or clicking through multiple tabs to find metadata. You just get the answers you need to keep moving forward with your deployment. Whether you are a DevOps engineer looking for specific pull statistics or a developer trying to find the most stable tag for a production environment, this connection gives you immediate access to your registry data without the friction of a web interface. ## Tools ### get_user Check your authenticated account details to confirm your access token is active. Use this for initial setup. ### create_repository Create a new Docker Hub repository with a specific name, description, and visibility. It helps you spin up new hosts quickly. ### get_repository Fetch the full details and metadata for a specific repository. Use this to check current status. ### get_tag Retrieve specific information for a single image tag like version or size. It's great for verifying specific builds. ### list_organizations See a list of all organizations your account currently belongs to. Useful for auditing permissions. ### list_repositories View all your Docker Hub repositories including pull counts and visibility. Get a high-level overview of your registry. ### list_tags Get a list of all available tags for a repository to find the right version. Helps avoid using the wrong image. ### search_repositories Find public images on Docker Hub based on names or descriptions. Discover community images instantly. ### update_repository Modify the description or privacy settings of an existing repository. Keep your registry metadata up to date. ### delete_repository Permanently remove a Docker Hub repository from your account. This action is irreversible. ## Prompt Examples **Prompt:** ``` List all my Docker repositories. ``` **Response:** ``` I found 5 repositories: | Name | Pulls | Visibility | | :--- | :--- | :--- | | **myapp-api** | 12K | Public | | **myapp-web** | 8K | Public | | **myapp-worker** | - | Private | | **base-image** | 25K | Public | | **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. The latest versions include: * **latest** (187MB, pushed 2 days ago) * **1.25-alpine** (42MB) * **1.25.3** (187MB) * **1.25.3-alpine** (42MB) * **1.24-perl** (205MB) Would you like details on a specific tag? ``` **Prompt:** ``` Search for official Python images on Docker Hub. ``` **Response:** ``` I found the official **python** image with over 1.2 billion pulls. Related images include: * **python:alpine** (lightweight, 50MB) * **python:slim** (minimal, 130MB) * **python:3.12-slim** (community image) Would you like to see the specific tags for any of these? ``` ## Capabilities ### Create new repositories Spin up a new Docker Hub repository with specific visibility settings and descriptions. ### Delete old repositories Permanently remove repositories from your account to clean up your registry. ### Fetch repository details Get full metadata for any specific repository in your account. ### View specific image tags Retrieve information on a single tag, including its size and push date. ### Get authenticated user info Confirm your account details and verify that your access token is working. ### List organization memberships See all the organizations your account is currently a part of. ### Browse all image repositories View your entire list of Docker Hub repositories and their pull counts. ### Look up repository tags See all available versions for a repository to find the correct one for your project. ### Search the public registry Find community images by searching for specific names or descriptions. ### Update repository settings Modify the privacy or description of an existing repository on the fly. ## Use Cases ### Finding the right base image A developer needs a base image for a Python app and asks their agent to find the official one with the smallest size using `search_repositories`. ### Verifying tag availability A DevOps engineer wants to see if a specific tag was pushed to the production repo and asks their agent to check the details with `list_tags`. ### Organization auditing A platform lead needs to audit organization memberships to ensure the right people have access and uses `list_organizations` to get the full list. ### Quick repository setup A user wants to quickly make a public repository for a new project and asks their agent to create it with a description using `create_repository`. ## Benefits - Faster Image Discovery: Use `search_repositories` to find community images in seconds instead of scrolling through pages of results. - Easier Tag Management: Quickly see what versions are available using `list_tags` so you don't have to guess which image is the latest. - Streamlined Repo Creation: Create new hosts with `create_repository` without having to manually fill out forms on the Docker Hub website. - Real-time Stats: Monitor your image popularity and pull counts using `list_repositories` to track your project's reach. - Instant Auth Checks: Verify your credentials are correct by calling `get_user` whenever you set up a new environment. ## How It Works The bottom line is you get a direct line to your container registry without the web UI overhead. 1. Subscribe to the Docker Hub MCP via the Vinkius catalog. 2. Provide your Docker Hub Access Token in your client settings. 3. Ask your agent to list your repos, search for images, or check tag versions. ## Frequently Asked Questions **Can I use the Docker Hub MCP to find the right base image for my app?** Yes, you can ask your agent to search the public registry for specific images. It will find matching repositories based on your description and show you the pull counts and visibility. **Does the Docker Hub MCP let me create new repositories?** Yes, you can create new Docker Hub repositories directly through your agent. You just need to specify the name, description, and whether it should be public or private. **How do I check which tags are available for a specific image?** You can ask your agent to list all tags for a repository. It will return a list of available versions, their sizes, and the last push dates so you can pick the right one. **Can I use Docker Hub MCP to see my organization membership?** Yes, the Connector can list all the organizations your account belongs to. This is helpful for auditing access and managing your team's registry presence. **Will this Connector help me manage my Docker Hub account settings?** It allows you to manage repository-level settings like descriptions and privacy. It also lets you fetch your authenticated user info to verify your connection. **Can I use this to pull images to my local machine?** No, this Connector is for managing registry metadata and repository settings. You still use the standard Docker CLI or your container runtime to actually pull and run images. **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.