How to integrate Docker hub MCP with Atomic Agent

Connect Atomic Agent to Docker hub MCP. Create a new docker hub repository, add a member to your docker organization, and more using natural language, with authentication handled for you.

Docker hub logoDocker hub
Api Key

Docker Hub is a cloud-based registry for finding and sharing container images. It simplifies container collaboration and deployment for individuals and teams.

24 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Docker hub.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Docker hub account. See the Atomic Agent documentation for installation instructions.

Also integrate Docker hub with

How Atomic Agent connects to Docker hub

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Docker hub to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Docker hub. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Docker hub account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Docker hub MCP server, and what's possible with it?

The Docker hub MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Docker Hub account. It provides structured and secure access to your container repositories and organizations, so your agent can perform actions like creating repositories, managing organization members, deleting images, setting up webhooks, and cleaning up tags on your behalf.

  • Repository and image management: Let your agent create new Docker Hub repositories, delete existing ones, and remove specific images or tags as needed.
  • Organization and team automation: Easily add members to organizations, create new Docker Hub organizations, or delete organizations and teams directly from your workflows.
  • Webhook configuration: Set up or remove repository webhooks to automate external integrations and keep your CI/CD pipelines in sync.
  • Tag and resource cleanup: Direct your agent to delete outdated tags or unused resources, helping you maintain a tidy container registry.
  • Secure role management: Invite users with specific roles to your organizations, ensuring the right access for collaborators and teams.

Use Docker hub from Atomic Agent

With your account connected, ask Atomic Agent to work with Docker hub in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Docker hub action and event your agent gets out of the box.

Add Organization Member

Invite a user to join a Docker Hub organization.

Create Docker Hub Organization

Create a new Docker Hub organization.

Create Docker Hub Repository

Creates a new Docker Hub repository under the specified namespace.

Create Docker Hub Webhook

Create a webhook on a Docker Hub repository to receive notifications on image push events.

Delete Repository Images

Delete one or more images from your Docker Hub namespace using the bulk delete API.

Delete Docker Hub Organization

Permanently deletes a Docker Hub organization.

Delete Docker Hub Repository

Permanently deletes a Docker Hub repository and all its images/tags.

Delete Repository Tag

Permanently delete a specific tag from a Docker Hub repository.

Delete Docker Hub Team

Permanently deletes a team from a Docker Hub organization.

Delete Docker Hub repository webhook

Deletes a specific webhook from a Docker Hub repository.

Get Docker Hub Image

Retrieve details about a specific platform-specific image variant by its digest.

Get Docker Hub Repository

Retrieves detailed information about a specific Docker Hub repository.

Get Docker Hub Tag

Tool to retrieve details of a specific Docker Hub repository tag.

Get Docker Hub Team

Retrieve details of a specific team (group) within a Docker Hub organization.

Get Docker Hub Webhook

Retrieves details of a specific Docker Hub webhook by its ID.

List Organization Access Tokens

Tool to list all organization access tokens for a Docker Hub organization.

List Docker Hub Organizations

List Docker Hub organizations that the authenticated user belongs to.

List Docker Hub Organization Members

Lists members of a Docker Hub organization with their roles and details.

List Docker Hub Repositories

Tool to list repositories under a namespace.

List Team Members

List members of a Docker Hub team (group) within an organization.

List Organization Teams

List all teams (groups) within a Docker Hub organization.

List Docker Hub repository webhooks

Lists all webhooks configured for a Docker Hub repository.

Remove Organization Member

Remove a member from a Docker Hub organization.

Remove Team Member

Remove a user from a Docker Hub organization team (group).

FAQ

Frequently asked questions

With a standalone Docker hub MCP server, the agents and LLMs can only access a fixed set of Docker hub tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Docker hub and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Docker hub tools.

Yes, absolutely. You can configure which Docker hub scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Docker hub data and credentials are handled as safely as possible.

Start with Docker hub.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Docker hub tool your agent needs.Free to start.

Start building