# dotdog MCP server

> Lets an AI client validate and compile spec files and query repository spec and code graphs through a local stdio MCP server.

- Repository: https://github.com/specdog/dotdog
- Page: https://hostedmcp.org/servers/specdog/dotdog
- Transport: stdio
- Stars: 7
- License: MIT

## Install

### Claude Code

```sh
claude mcp add dotdog -- npx -y dotdog
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "dotdog": {
      "command": "npx",
      "args": [
        "-y",
        "dotdog"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "dotdog": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "dotdog"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"dotdog","type":"stdio","command":"npx","args":["-y","dotdog"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "dotdog": {
      "command": "npx",
      "args": [
        "-y",
        "dotdog"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add dotdog -- npx -y dotdog
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.dotdog]
command = "npx"
args = ["-y", "dotdog"]
```

### Gemini CLI

```sh
gemini mcp add -s user dotdog npx -- -y dotdog
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "dotdog": {
      "command": "npx",
      "args": [
        "-y",
        "dotdog"
      ]
    }
  }
}
```

## FAQ

### How do I configure the dotdog MCP server?

Install the dotdog executable and point your client at a local stdio server with arguments ["serve"], run from the repository root. It opens no TCP listener.

### What MCP tools does dotdog expose?

It exposes listProjects, workspace.list, search, getEntity, schema, summary, traverse, path, context, impact and infraVerify. Every tool returns structured JSON plus a text fallback.

### Does dotdog need an API key or account?

No authentication is described; it runs locally over stdio. Only infraVerify makes an explicit live network or provider call.

### Which languages does dotdog extract code from?

AST extraction covers JS/TS top-level declarations and static relative imports and re-exports; other files are inventoried only. It does not resolve dynamic calls or runtime execution.

### Can dotdog import Ghidra analysis results?

It can import a saved REA NativeCallGraph body export, keeping coverage, limitations and evidence references. It is not a direct Ghidra analysis provider.
