io.github.greenmtnsun/giteasy

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Plain-English git via MCP: 22 tools to branch, commit, push, and tag. No git jargon.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "giteasy": {
      "url": "https://giteasy-mcp.azurewebsites.net/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (22)

• push

  Send already-committed work to the remote without making a new commit. Pushes the current branch; on a branch's first push, sets the remote branch as its upstream automatically.

  Parameters:

  • remoteName — string — Remote name. Default origin.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• show_diagnostic

  Show git repository diagnostic info: current branch, upstream, HEAD SHA, remote URLs, and status summary.

  Parameters:

  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• set_vault

  Configure the git credential helper to use a specific vault path. Returns new credential helper value.

  Parameters:

  • vaultPath — string — Path to the credential helper vault executable.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• restore_file

  Restore a single file to its HEAD state, discarding uncommitted changes. Returns restored file path.

  Parameters:

  • filePath — string — Repo-relative path to the file to restore.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• reset_login

  Clear stored git credentials by unsetting the credential helper in local git config. Returns confirmation.

  Parameters:

  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• set_ssh

  Change a remote URL to its SSH equivalent. Returns old and new remote URLs.

  Parameters:

  • sshUrl — string — New SSH remote URL, e.g. [email protected]:owner/repo.git.
  • remoteName — string — Remote name to update. Default origin.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• save_work

  Stage changes, commit with a message, and optionally push to remote. Returns commit SHA and push result.

  Parameters:

  • files — ['array', 'null'] — Files to commit. Default empty (commits all changes).
  • message — string — Commit message.
  • pushToRemote — boolean — Push to remote after commit. Default false.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_vault_status

  Report current git credential helper configuration. Returns helper name and scope.

  Parameters:

  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• test_login

  Test whether git credentials are working by attempting ls-remote against the origin. Returns success/failure and remote refs count.

  Parameters:

  • remoteName — string — Remote to test. Default origin.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• show_releases

  List all tags/releases in the repository, newest first. Returns tag names, target SHAs, and annotation messages.

  Parameters:

  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• show_change

  Show the diff for a specific file or all changed files. Returns unified diff text.

  Parameters:

  • staged — boolean — Show staged diff. Default false.
  • filePath — string — Repo-relative file path. If empty, shows all.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• new_release

  Create an annotated git tag and push it to the remote. Returns the tag name and target commit SHA.

  Parameters:

  • message — string — Annotation message for the tag.
  • tagName — string — Tag name, e.g. v1.2.0.
  • remoteName — string — Remote to push to. Default origin.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• find_changes

  List changed files: staged, unstaged, and untracked. Returns file counts and paths by status group.

  Parameters:

  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• show_remote

  Show all remote names and their fetch/push URLs. Returns list of remotes with URL and type.

  Parameters:

  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_updates

  Fetch from remote and show incoming commits not yet in local branch. Returns count and commit summaries.

  Parameters:

  • remoteName — string — Remote name. Default origin.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• undo_changes

  Discard uncommitted changes. If filePath given, restores that file; otherwise restores all tracked files. Returns list of restored paths.

  Parameters:

  • filePath — string — Repo-relative file path to undo. If empty, undoes all tracked changes.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• switch_work

  Switch to an existing branch. Returns the branch switched to and current HEAD SHA.

  Parameters:

  • branchName — string — Name of the branch to switch to.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_history

  Search commit history for commits whose message matches a search term. Returns matching commits with SHA, author, date, and message.

  Parameters:

  • limit — integer — Max commits to return. Default 20.
  • searchTerm — string — Text to search for in commit messages.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• show_history

  Show recent commit history. Returns commits with SHA, author, date, and message.

  Parameters:

  • limit — integer — Number of commits to return. Default 20.
  • branchName — string — Branch name. Default current branch.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• new_work_branch

  Create a new branch from current HEAD and switch to it. Returns branch name and base commit SHA.

  Parameters:

  • branchName — string — Name of the new branch.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• set_token

  Store a personal access token for HTTP git authentication. Returns confirmation (token value is never echoed).

  Parameters:

  • token — string — Personal access token to store.
  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• clear_junk

  Remove untracked files and directories from the working tree (git clean -fd). Returns list of removed paths.

  Parameters:

  • workingDirectory — string — Git repo path. Default current directory.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.