gitopia/gitopia-mcp-server

MCP server for Gitopia — decentralized Git with on-chain governance, bounties, and DAO management. Works with Cursor, VS Code, Claude Code, Claude Desktop, Windsurf, and any MCP-compatible tool.
**57 tools** | **3 prompts** | **4 resource templates**
Zero-config start: a wallet is auto-generated on first use. No setup beyond pasting a config snippet.
Quick Start
Docker (Recommended)
Then add the config for your editor (see Editor Setup below).
Native Binary
Download from GitHub Releases, or:
Requires Go 1.25+ and git-remote-gitopia (curl https://get.gitopia.com | bash).
Editor Setup
OpenAI Codex
Or add to ~/.codex/config.toml:
Full Codex guide
Claude Code
Add to your project's .mcp.json:
Full Claude Code guide
Cursor
Add to ~/.cursor/mcp.json (macOS) or %APPDATA%\Cursor\mcp.json (Windows):
Full Cursor guide
VS Code
Full VS Code guide
Windsurf
Full Windsurf guide
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
**Using an existing wallet?** Set GITOPIA_MNEMONIC in your shell, then add "-e", "GITOPIA_MNEMONIC" to the Docker args. Never hardcode mnemonics in config files.
Tools (57)
Context Management (4)
| Tool | Description |
|------|-------------|
| get_user_context | Get current identity, address, and available DAOs |
| set_active_dao | Switch operations to a DAO context |
| refresh_user_context | Reload user info from chain |
| claim_fee_grant | Claim fee grant from faucet |
User Management (1)
| Tool | Description |
|------|-------------|
| create_user | Create on-chain Gitopia user for wallet |
Repository Management (7)
| Tool | Description |
|------|-------------|
| list_repos | List repositories for owner |
| create_repo | Create remote repository |
| get_repo | Get repository details |
| list_branches | List branches |
| get_file_contents | Read file without cloning |
| fork_repository | Fork a repository |
| toggle_repository_forking | Enable/disable forking |
Tags, Commits, Releases (4)
| Tool | Description |
|------|-------------|
| list_tags | List version tags |
| list_commits | Browse commit history for a branch |
| list_releases | List published releases |
| create_release | Publish a new release |
Issue Management (5)
| Tool | Description |
|------|-------------|
| list_issues | List issues |
| get_issue | Get full issue details |
| create_issue | Create issue (on-chain) |
| comment_on_issue | Comment on issue (on-chain) |
| update_issue | Update state, labels, assignees |
Pull Request Management (6)
| Tool | Description |
|------|-------------|
| list_pull_requests | List PRs |
| get_pull_request | Get full PR details |
| get_pull_request_diff | Get unified diff for a PR |
| create_pull_request | Create PR (on-chain) |
| comment_on_pull_request | Comment on PR (general or inline) |
| merge_pull_request | Merge PR (on-chain) |
Git Operations (5)
| Tool | Description |
|------|-------------|
| git_clone | Clone repository to workspace |
| git_push | Push commits to remote |
| create_feature_branch | Create and checkout new branch |
| sync_with_remote | Fetch and merge/rebase |
| commit_and_push_changes | Stage + commit + push in one step |
Workflow Orchestration (3)
| Tool | Description |
|------|-------------|
| bootstrap_repo | Create remote + local init + files + push |
| create_feature_branch_pr | Branch + changes + commit + push + PR |
| update_feature_branch | Add commits to existing branch/PR |