gittr-mcp

Create a pull request - REQUIRES signing

Publish a NIP-22 comment (kind 1111) on a pull request. Optional replyTo for threaded replies.

Create PR via gittr CLI - full flow including git push (RECOMMENDED for PRs)

POST push-payment action create_intent — invoice for pay-to-push (owner wallet keys in body)

Not supported for UI release notes. For Zapstore/NIP-82 announce use announceSoftwareFromForgeRelease. For git tags use listReleases + publishRepoState.

CREATE A REPO IN ONE CALL - Push files AND publish to Nostr. Best for agents! Auto-loads credentials from .nostr-keys.json.

Alias for softDeleteRepo — soft-delete a NIP-34 repository (owner only).

NIP-09 kind 5 deletion for previously published NIP-82 app/release/asset event ids (does not delete the git repo).

Show whether Nostr keys are loaded (hex/npub only — never returns private key). Use first in a session.

Explore repositories by category/topic

Fetch a public forge Release (GitHub/Codeberg/GitLab) with announceable binaries (APK, AppImage, DMG, linux tar.gz, MSI/EXE, IPA). Omit tag for latest. Set hash:true to compute sha256 (slow; required before announce).

Alias for findReposBySource (exact forge URL → npub). Prefer findReposBySource for non-GitHub forges.

Exact reverse lookup: given one or more forge URLs (GitHub, GitLab, Codeberg, Gitea, …) or github owner/repo shorthand, find Nostr kind-30617 announces with that source/forkedFrom. Returns npub + gittr URL so you can DM owners when the forge is unreachable. Does NOT fuzzy-match renamed slugs.

Fork an existing repository

Get branches for a repository

Get commit history for a repository

Get file content without a full local clone. Tries gittr bridge file-content, then a few hardcoded GRASP /raw/ hosts. Not full Code-tab parity (no 30617 clone[] / repo-files for home remotes) — prefer bridgeListFiles after importRemoteToBridge/mirrorRepo.

One issue, the way the website opens it. A 64-character id is the Nostr issue. issue-N or a number needs ownerPubkey and repoId and reads the forge issue.

Get public key from private key

One pull request, the way the website opens it. A 64-character id is the Nostr pull request. pr-N or a number needs ownerPubkey and repoId and reads the forge pull request.

GET /api/nostr/repo/push-payment — push cost and whether payer has paid intent

Get a single repository by ID or owner+name

Get contributors to a repository

Get trending/popular repositories

Copy a Git URL onto the bridge. With the owner key, an existing forge repo is updated to the forge commits (history kept). Does not publish the Nostr card — use mirrorRepo for the same result as the website Push. Do not use pushToBridge to sync a forge. If the URL returns 403, do not retry it and do not pass a different URL to change source: this force-updates the gittr branches to match the URL. Read the existing bare repo with bridgeListFiles instead. Leaving a dead forge is the website sidebar If this git host is gone, not this tool.

Discover open bounties (issues with bounty labels or Lightning funding)

List kind 9806 bounty events linked to an issue id

List all forge Releases + assets for a source URL (same as gittr Releases tab). No NIP-82 MIME gate. Distinct from listReleases (git tags).

Comments on an issue, same as the website. A 64-character Nostr id returns Nostr comments. issue-N or a number needs ownerPubkey and repoId and returns the forge comments. Nothing is posted back to GitHub.

List issues the way the website Issues tab does. Nostr issues, plus GitHub or Codeberg/Gitea issues when the repo source says so. A forge issue and a Nostr issue stay separate rows. GitLab sources stay Nostr-only, same as the website.

Comments on a pull request, same as the website. A 64-character Nostr id returns Nostr comments. pr-N or a number needs ownerPubkey and repoId and returns the forge conversation. Nothing is posted back to GitHub.

List pull requests the way the website does. Nostr pull requests, plus GitHub or Codeberg/Gitea pull requests when the repo source says so. They stay separate rows.

List git tags from the bridge (refs/tags/*), not Zapstore software releases and not the website Releases tab

Discover repositories from Nostr relays (NIP-34). Filter by pubkey or search term.

List repos a user starred (kind 7 with #k 30617 and #e pointing at 30617 events; latest reaction per repo wins)

List repos from your latest kind 10018 followed-repos event on relays

Load Nostr credentials from .nostr-keys.json (for debugging)

Convenience: publish status 1631 (merged/applied) for a PR root event

Full merge: git clone/fetch with signed HTTPS auth, merge PR head, push to bridge, optional 30618+1631. Signer must be repo owner OR on latest kind 30617 merge_maintainers (if that tag exists) OR on maintainers when merge_maintainers is absent. Requires git on PATH. repoId optional if derivable from PR a-tag.

Same result as the website Push of a GitHub/GitLab repo. Copies the forge commits onto gittr (keeps history, updates an existing repo), announces the same git servers as the website, and publishes the branch tips with HEAD on the forge default branch. A second call keeps the existing name, description, and web links unless you pass new ones. Do not follow this with pushToBridge. If the forge returns 403 (account suspended or blocked), do not call this again and do not pass a different URL to change the source: this copies that URL onto the gittr bare repo and replaces every branch. Read the ex…

List repositories owned by the current user (from .nostr-keys.json)

Publish gittr bounty metadata event (kind 9806)

Publish Nostr Pages (NIP-5A kind 35128): upload static files through gittr’s Blossom proxy (kind 24242), then sign the named-site manifest. Requires index.html. Pass files or fromBridge:true to read the git tree. Default Blossom is blossom.gittr.space (Pages only — never for app installers).

Publish repository to Nostr (kind 30617). Always writes the same clone addresses as the website Push (gittr, ngit, gitnostr, shakespeare, danconway). A GitHub URL is kept as the source, not as a clone. The private key is loaded from .nostr-keys.json when omitted.

Publish repository state to Nostr (kind 30618). HEAD follows branch when passed, otherwise main or master, not the alphabetically first branch. The private key is loaded from .nostr-keys.json when omitted.

Low-level: publish NIP-82 events from an already-fetched forge payload (ok:true + hashed announceable binary). Prefer announceSoftwareFromForgeRelease.

Publish NIP-34 status (1630 open, 1631 merged/applied, 1632 closed, 1633 draft) for an issue, PR, or patch root event

Push files to the git server (REQUIRES signing with privkey). This replaces the branch with one new snapshot commit. It does not keep imported GitHub history. Optional deletedPaths removes files or whole folders on that snapshot (same as gittr UI folder delete); allowTreeShrink defaults true when deletes are present.

Convenience: publish status 1630 (open) for an issue

Resolve repo by Nostr identity (npub or hex) and repo name. Returns cloneUrl (prefer git.gittr.space), cloneUrls, relays for location-agnostic use.

Full-text search across repository names and descriptions

Create a disposable TEST Nostr keypair and write .nostr-keys.json so all tools auto-load it. ASK THE USER FIRST — a keypair is a permanent Nostr identity. Without confirm:true this only returns the question to ask. Never overwrites real credentials unless force:true.

Owner soft-delete for a NIP-34 repo: publish replaceable 30617 with deleted markers + NIP-09 kind 5, and POST the signed 30617 to the bridge /api/nostr/repo/event (same as gittr Settings → Delete). Alias: deleteRepo.

Star a repo (NIP-25 kind 7 on the latest kind 30617 event: tags e+k+p, content +). Requires a published repo announcement on relays.

Submit work on a bounty (claim it with PR/evidence)

POST /api/nostr/repo/push-policy-sync — upsert push paywall from signed kind 30617 (use announcement event JSON from publishRepoAnnouncement)

Unstar a repo (NIP-25 kind 7 on the 30617 event with content "-"). Same tags as starRepo.

Unwatch a repo (republish kind 10018 without this repo)

Publish NIP-34 PR update (kind 1619): new tip commit + clone URLs

Watch a repo (NIP-51 kind 10018 followed-repos list — publishes full `a` tag set, same as gittr Watch button)