zzstoatzz.io / tangled-mcp
MCP server for tangled
fork atom
Python 98.4%
Just 1.6%
Other 0.1%
10 3 14

Clone this repository

https://tangled.org/zzstoatzz.io/tangled-mcp
git@tangled.org:zzstoatzz.io/tangled-mcp

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md

tangled-mcp#

MCP server for Tangled - a git collaboration platform built on AT Protocol.

note: this repository is mirrored to GitHub for deployment via FastMCP Cloud.

installation#

git clone https://tangled.org/zzstoatzz/tangled-mcp
cd tangled-mcp
just setup
IMPORTANT

requires uv and just

configuration#

create .env file:

TANGLED_HANDLE=your.handle
TANGLED_PASSWORD=your-app-password
# optional: only needed if using custom PDS (leave blank for auto-discovery)
TANGLED_PDS_URL=

usage#

uv run tangled-mcp

resources#

  • tangled://status - connection status (PDS auth + tangled accessibility)

tools#

all tools accept repositories in owner/repo format (e.g., zzstoatzz/tangled-mcp). handles (with or without @ prefix) and DIDs are both supported for the owner.

repositories#

  • list_repo_branches(repo, limit, cursor) - list branches for a repository

issues#

  • create_repo_issue(repo, title, body) - create an issue on a repository
  • list_repo_issues(repo, limit, cursor) - list issues for a repository

development#

just test   # run tests
just check  # run pre-commit checks