# docker-facts MCP server

Does that Docker tag actually exist? Real tags, sizes and platforms, live from Docker Hub.

## At a glance

docker-facts is an MCP server in the Dev Tools & Git category. It is hosted remotely and connects over HTTP, and declares no required credentials. It exposes 3 tools, including check_image_tag, get_image_info and list_image_tags. It scores D (33/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install docker-facts in Claude Code

1. Add the server

```bash
claude mcp add --transport http docker-facts https://api.kaiv.ai/api/bridge/mcp/docker-facts-adc41b39
```

2. Verify it's connected

```bash
claude mcp list
```

3. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

4. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. check_image_tag, get_image_info, list_image_tags). It discovers them automatically.

### How to install docker-facts in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "docker-facts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.kaiv.ai/api/bridge/mcp/docker-facts-adc41b39"
      ]
    }
  }
}
```

3. Why the wrapper?

   This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.

4. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install docker-facts in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "docker-facts": {
      "url": "https://api.kaiv.ai/api/bridge/mcp/docker-facts-adc41b39"
    }
  }
}
```

2. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install docker-facts in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.docker-facts]
command = "npx"
args = ["-y", "mcp-remote", "https://api.kaiv.ai/api/bridge/mcp/docker-facts-adc41b39"]
```

2. Why the wrapper?

   Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.

3. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install docker-facts in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "docker-facts": {
      "serverUrl": "https://api.kaiv.ai/api/bridge/mcp/docker-facts-adc41b39"
    }
  }
}
```

2. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install docker-facts in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "docker-facts": {
      "type": "streamableHttp",
      "url": "https://api.kaiv.ai/api/bridge/mcp/docker-facts-adc41b39"
    }
  }
}
```

### How to install docker-facts in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "docker-facts": {
      "type": "http",
      "url": "https://api.kaiv.ai/api/bridge/mcp/docker-facts-adc41b39"
    }
  }
}
```

2. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `check_image_tag` — Does this image:tag exist, how big is it, and which platforms does it cover? Use this before writing a FROM line or a compose file. On a hit it returns size, platforms, arm64/amd64 support and the digest. On a miss it says whether the IMAGE exists but the tag is wrong, and lists real tags newest first so the caller can correct itself. Defaults to tag "latest" when none is given.
- `get_image_info` — Repository facts: official status, pulls, stars, whether it is archived. Use to judge whether an image is the canonical one and still maintained. Archived images still pull but receive no security patches.
- `list_image_tags` — Real tags for an image, most recently updated first. Use when choosing a tag rather than verifying one. Each entry carries size and platform list, so a choice can be made without a second call.

---

Source: https://mcp-skills-hub.vercel.app/mcps/ai-kaiv-docker-facts · MCP Skills Hub · data as of 2026-10-28T12:31:05Z