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,700+ 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.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

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 for image push notifications, then add its hook URL; repository admin permissions are required.

Delete Repository Images

Delete up to 100 image manifests from a Docker Hub namespace by repository and SHA256 digest, or use a dry run to validate the request without deleting.

Delete Docker Hub Organization

Permanently deletes a Docker Hub organization.

Delete Docker Hub Repository

Permanently delete a Docker Hub repository and its images, tags, and metadata.

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 a platform-specific image variant by digest by searching repository tags.

Get Docker Hub Repository

Retrieve detailed metadata for a Docker Hub repository, including available description, counts, permissions, and configuration.

Get Docker Hub Tag

Retrieve details of a specific Docker Hub repository tag by namespace, repository, and tag name.

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

List a page of organization access tokens for a Docker Hub organization, with pagination.

List Docker Hub Organizations

List Docker Hub organizations associated with the authenticated user, with available organization details in paginated results.

List Docker Hub Organization Members

List members of a Docker Hub organization with available roles and details, using paginated results.

List Docker Hub Repositories

List repositories under a Docker Hub namespace with optional filtering and pagination.

List Team Members

List members of a Docker Hub team (group) within an organization, returning paginated user details.

List Organization Teams

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

List Docker Hub repository webhooks

List webhooks configured for a Docker Hub repository, returning paginated configuration details.

Remove Organization Member

Remove a member from a Docker Hub organization.

Remove Team Member

Remove a user from a Docker Hub organization team (group), revoking that team membership.

FAQ

Frequently asked questions

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