Skip to content
MCP server

dotrepo

Repository facts with sources, conflicts and age, as JSON, a .repo file or MCP

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, vscode
Runs
Locally
Version
2.0.0-rc.2
Listing updated
2 days ago

About dotrepo

dotrepo is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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"
      ]
    }
  }
}

What it does

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

Pricing

Open source

Open protocol and tools; licence file in the repository

Prices change. Check dotrepo.org before you buy.

dotrepo 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 to dotrepo

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools