`search_images`

Pack: dockerhub · Endpoint: https://gateway.pipeworx.io/dockerhub/mcp

Search Docker Hub for container images by keyword. Returns repository name, description, pull count, star count, and official status. Use when finding images for deployment.

Parameters

Name	Type	Required	Description
`query`	string	yes	Search query (e.g., “nginx”, “postgres”)
`limit`	number	no	Number of results to return (default 10, max 100)

Example call

Arguments

{
  "query": "nginx"
}

curl

curl -X POST https://gateway.pipeworx.io/dockerhub/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_images","arguments":{"query":"nginx"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_images', {
  "query": "nginx"
});

More examples

{
  "query": "postgres",
  "limit": 25
}

Response shape

Always returns: total, images

Field	Type	Description
`total`	number	Total number of matching repositories
`images`	array	List of matching Docker Hub repositories

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total number of matching repositories"
    },
    "images": {
      "type": "array",
      "description": "List of matching Docker Hub repositories",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Repository name (e.g., namespace/name)"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Short description of the repository"
          },
          "stars": {
            "type": "number",
            "description": "Number of stars"
          },
          "pulls": {
            "type": "number",
            "description": "Number of pulls"
          },
          "is_official": {
            "type": "boolean",
            "description": "Whether this is an official Docker repository"
          },
          "is_automated": {
            "type": "boolean",
            "description": "Whether this is an automated build"
          }
        },
        "required": [
          "name",
          "description",
          "stars",
          "pulls",
          "is_official",
          "is_automated"
        ]
      }
    }
  },
  "required": [
    "total",
    "images"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "dockerhub": {
      "url": "https://gateway.pipeworx.io/dockerhub/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_images