# dotrepo

> dotrepo is an open-source MCP server for developer tools. Repository facts with sources, conflicts and age, as JSON, a .repo file or MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, vscode
- **Website:** https://dotrepo.org
- **Repository:** https://github.com/maxwellsantoro/dotrepo
- **MCP Registry name:** io.github.maxwellsantoro/dotrepo
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

DotRepo is an open metadata protocol, tools and a public index for what a project does, where its docs are, who maintains it and how it is built. Each answer carries its sources, recorded conflicts and freshness, and the README tells consumers to check upstream when a value is missing, old or in conflict. Returned commands are data to review, not permission to execute them.

You can try it without installing anything by fetching a profile such as the one for pydantic, or install dotrepo-mcp with Cargo and call dotrepo.lookup with a repository URL. The registry points at the 2.0.0 release candidate, while the README recommends stable v1.0.4 for production. An experimental decision workflow (dotrepo.decision.* tools) is not in released packages.

It belongs to the Lazy Collective, alongside PageDigest, which aims to cut repeated fetching and verification.

## Features

- **Sourced repo facts:** Purpose, docs, owners and commands with sources.
- **Conflicts and freshness:** Disagreements and age are recorded, not hidden.
- **Public index:** Look up indexed repositories as JSON.
- **Local .repo files:** Publish records from existing manifests and CI.
- **Stable and preview channels:** v1.0.4 stable; v2.0.0-rc.2 preview.

## Good for

- Orient yourself in an unfamiliar repository
- Find a project's docs and maintainers
- Publish repository metadata from existing files
- Give an agent a trusted starting point

## Install

### Claude Code (Terminal)

```sh
claude mcp add dotrepo -- npx -y https://github.com/maxwellsantoro/dotrepo/releases/download/v2.0.0-rc.2/dotrepo-mcp-2.0.0-rc.2.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "dotrepo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/maxwellsantoro/dotrepo/releases/download/v2.0.0-rc.2/dotrepo-mcp-2.0.0-rc.2.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "dotrepo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/maxwellsantoro/dotrepo/releases/download/v2.0.0-rc.2/dotrepo-mcp-2.0.0-rc.2.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "dotrepo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/maxwellsantoro/dotrepo/releases/download/v2.0.0-rc.2/dotrepo-mcp-2.0.0-rc.2.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "dotrepo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/maxwellsantoro/dotrepo/releases/download/v2.0.0-rc.2/dotrepo-mcp-2.0.0-rc.2.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "dotrepo": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/maxwellsantoro/dotrepo/releases/download/v2.0.0-rc.2/dotrepo-mcp-2.0.0-rc.2.mcpb"
      ]
    }
  }
}
```

## FAQ

### How do I install the MCP server?

Run cargo install dotrepo-mcp --version 1.0.4 --locked, or use the release bundle.

### Which version should I use?

The README says production installs use stable v1.0.4.

### Can I try it without installing?

Yes, fetch a profile.json from dotrepo.org.

### Should I run the commands it returns?

No. They are data to review.

### Is dotrepo free?

Yes. dotrepo is open source, so you can use and self-host it for free.

### How do I add dotrepo to Claude Code?

Run this command in your terminal: claude mcp add dotrepo -- npx -y https://github.com/maxwellsantoro/dotrepo/releases/download/v2.0.0-rc.2/dotrepo-mcp-2.0.0-rc.2.mcpb

### What are the best alternatives to dotrepo?

The closest alternatives to dotrepo are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/dotrepo
