# Diffinery MCP server

> Lets AI clients manage repositories, pull requests, CI runs, logs and issues on a self-hosted git forge.

- Repository: https://github.com/codician-team/diffinery
- Page: https://hostedmcp.org/servers/codician-team/diffinery
- Transport: remote
- Stars: 83
- License: Apache-2.0
- Latest version: 0.1.0

## Install

### Claude Code

```sh
claude mcp add --transport http diffinery https://{diffinery_host}/mcp
```

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

```json
{
  "mcpServers": {
    "diffinery": {
      "url": "https://{diffinery_host}/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "diffinery": {
      "type": "http",
      "url": "https://{diffinery_host}/mcp"
    }
  }
}
```

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

```toml
[mcp_servers.diffinery]
url = "https://{diffinery_host}/mcp"
```

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

```json
{
  "mcpServers": {
    "diffinery": {
      "httpUrl": "https://{diffinery_host}/mcp"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `BOOTSTRAP_ADMINS` | no | no |  |
| `CLOUDFLARE_ACCOUNT_ID` | no | no |  |
| `CLOUDFLARE_API_TOKEN` | no | no |  |
| `DIFFINERY_DOMAIN` | no | no |  |

## FAQ

### What does Diffinery's MCP server let an AI client do?

The built-in MCP server gives agents access to repositories, pull requests, CI runs, logs and issues, with the same guardrails enforced over Git, REST and MCP.

### Can AI agents push directly to protected branches on Diffinery?

No. Agents open pull requests instead, unless a branch protection rule allows it, and an agent's pull request needs approval from a person.

### Does Diffinery run existing GitHub Actions workflows?

Yes, it reads .github/workflows/ with the same syntax and runs marketplace actions, with any known differences documented.

### How is Diffinery deployed?

You deploy your own instance to your own Cloudflare account and domain, using Workers, Durable Objects, D1, R2, Queues, Workflows and Containers.

### Is Diffinery open source?

Yes, it is free and open-source software under the Apache License 2.0.