Pare Python

Lists, creates, renames, or deletes branches. List mode returns `{ branches, current }`. Mutations (create/delete/rename/setUpstream) return a compact confirmation `{ success, action, ... }` instead of the full listing — call again without a mutation param to list. When several mutations are combined in one call, the confirmation describes the last one performed. Pass `path` to target a specific repo or worktree — when omitted, operates on the server's own working directory, not the caller's (see #876).

Runs a build command and returns structured success/failure with errors and warnings. Allowed commands: ant, bazel, bun, bunx, cargo, cmake, dotnet, esbuild, go, gradle, gradlew, make, msbuild, mvn, npm, npx, nx, pnpm, rollup, tsc, turbo, vite, webpack, yarn.

Verifies that the Gemfile's dependencies are satisfied without installing them.

Executes a command in the context of the Gemfile bundle using `bundle exec` and returns structured output.

Installs Gemfile dependencies using `bundle install` and returns structured output with success status and duration.

Runs cargo check (type check without full build) and returns structured diagnostics. Faster than build for error checking.

Switches branches or restores files. Returns structured data with ref, previous ref, whether a new branch was created, and detached HEAD status. Pass `path` to target a specific repo or worktree — when omitted, operates on the server's own working directory, not the caller's, which can move branches in the wrong worktree (see #876).

Applies specific commits to the current branch. Returns structured data with applied commits, any conflicts, and new commit hash.

Runs dotnet clean to remove build outputs and returns structured results.

Runs cargo clippy and returns structured lint diagnostics.

CMake build system operations: configure, build, test, list-presets, install, clean.

Creates a commit with the given message. Returns structured data with hash, message, and change statistics. Pass `path` to target a specific repo or worktree — when omitted, operates on the server's own working directory, not the caller's (see #876).

Builds Docker Compose service images and returns structured per-service build status.

Stops Docker Compose services and returns structured status.

Retrieves Docker Compose service logs as structured entries.

Lists Docker Compose services with structured state and status information.

Starts Docker Compose services and returns structured status.

Runs conda commands (list, info, env-list, create, remove, update) and returns structured JSON output.

Manages git configuration values. Supports get, set, list, and unset actions. Operates at local, global, system, or worktree scope.

Counts pattern matches per file using ripgrep. Returns per-file match counts and totals.

Runs tests with coverage and returns structured coverage summary per file.

Describes a Kubernetes resource with detailed information.

Enters or queries a Nix dev shell. When a command is provided, runs it inside the dev shell and returns the result.

Returns file-level diff statistics as structured data. Use full=true for patch content.

Description is built at runtime.

Lists GitHub Discussions for a repository via GraphQL. Returns structured list with discussion number, title, author, category, answered status, and comment count.

Generates Rust documentation and returns structured output with warning count.

Returns Go environment variables as structured JSON. Optionally request specific variables.

Runs the esbuild bundler and returns structured errors, warnings, and output files.

Executes arbitrary commands inside a running Docker container and returns structured output. WARNING: may execute untrusted code.

Finds files and directories using fd with structured output. Returns file paths, names, and extensions.

Checks a Nix flake for errors and returns structured check results, warnings, and errors.

Shows the outputs of a Nix flake as a structured tree. Uses --json for machine-parseable output by default.

Updates flake lock file inputs and returns structured information about what was updated.

Checks or fixes Rust formatting and returns structured output.

Checks if files are formatted and returns a structured list of files needing formatting.

Installs a Ruby gem using `gem install` and returns structured output with success status and duration.

Lists installed Ruby gems with version information. Returns structured JSON with gem names and versions.

Lists outdated Ruby gems showing current and latest available versions.

Runs go generate directives in Go source files. WARNING: may execute untrusted code.

Downloads and installs Go packages and their dependencies.

Creates a new GitHub gist from one or more files. Returns structured data with gist ID, URL, visibility, file names, description, and file count.

Runs Gitleaks to detect hardcoded secrets in git repositories. Returns structured finding data with redacted secrets.

Runs golangci-lint and returns structured lint diagnostics (file, line, linter, severity, message).

Runs `gradle build` and returns structured output with diagnostics, task counts, and exit code.

Shows the Gradle dependency tree with structured output per configuration.

Lists available Gradle tasks with descriptions and groups. Uses `gradle tasks --all`.

Runs `gradle test` and returns structured test results with pass/fail counts and individual test outcomes.

Runs Hadolint (Dockerfile linter) and returns structured diagnostics (file, line, rule, severity, message).

Makes an HTTP HEAD request via curl and returns structured response headers (no body). Use to check resource existence, content type, or cache headers. SECURITY: URLs targeting private/reserved IPs are blocked (SSRF protection). The proxy parameter routes traffic through an external proxy — use only with trusted proxies.

Manages Helm releases (install, upgrade, list, status, history, template). Returns structured JSON output.

Lists Docker images with structured repository, tag, size, and creation info.

Runs `deno info` to show dependency information for a module. Returns structured dependency data.

Initializes a Terraform working directory. Downloads providers, configures backend, and prepares for plan/apply.

Shows detailed container or image information with structured state, image, and platform data.

Runs `bun install` to install project dependencies and returns structured output with package count.

Closes an issue with an optional comment and reason. Returns structured data with issue number, state, URL, reason, and comment URL.

Adds, edits, or deletes a comment on an issue. Returns structured data with the comment URL, operation type, comment ID, issue number, and body echo.

Creates a new issue. Returns structured data with issue number, URL, and labels applied.

Lists issues with optional filters. Returns structured list with issue number, state, title, labels, assignees, author, creation date, and milestone.

Updates issue metadata (title, body, labels, assignees, milestone, projects). All fields except `number` are optional — only supply the fields you want to change. For list fields (labels, assignees, projects), use `add*` to append and `remove*` to delete specific items without affecting others. Returns structured data with issue number and URL.

Description is built at runtime.

Processes and transforms JSON using jq expressions. Accepts JSON from a file path or inline string. Returns the transformed result.

Creates a new repository label. Returns structured data with label name, description, color, and URL.

Lists repository labels. Returns structured data with label name, description, color, and default status.

Runs Lerna monorepo commands (list, run, changed, version) and returns structured package information.

Runs `deno lint` and returns structured diagnostics with file, line, column, code, and message.

Lists Go packages or modules and returns structured information. When `modules` is true, lists modules (with path, version, dir); otherwise lists packages (with dir, importPath, name, goFiles, testGoFiles).

Runs dotnet list package and returns structured NuGet package listings per project and framework.

Returns commit history as structured data.

Returns visual branch topology as structured data. Wraps `git log --graph --oneline --decorate`.

Retrieves container logs as structured line arrays.

Runs `mvn package` (or specified goals) and returns structured build output with diagnostics.

Shows the Maven dependency tree with structured output per artifact.

Runs `mvn test` and returns structured Surefire test results with pass/fail/error counts.

Runs `mvn verify` to execute all checks (compile, test, integration-test, verify phases) and returns structured results.

Merges a branch into the current branch. Supports abort, continue, and quit actions. Returns structured data with merge status, fast-forward detection, conflicts, and commit hash.

Runs go mod tidy to add missing and remove unused module dependencies.

Evaluates a MongoDB expression via mongosh and returns the output. WARNING: The expression is executed as-is — do not pass untrusted input.

Gets MongoDB database statistics (collections, objects, data size, storage, indexes) via mongosh.

Runs mypy and returns structured type-check diagnostics (file, line, severity, message, code).

Lists all MySQL databases with structured output.

Executes a MySQL query and returns structured tabular output. WARNING: The query is executed as-is against the target database — do not pass untrusted input.

Lists Docker networks with structured driver and scope information.

Manages Node.js versions via nvm. Supports listing installed versions, showing the current version, listing remote versions, and executing commands with a specific Node.js version. Supports both Unix nvm and nvm-windows. SECURITY: The 'exec' action runs arbitrary commands under a specific Node version. Use PARE_NPM_ALLOWED_COMMANDS or PARE_ALLOWED_COMMANDS to restrict which commands can be executed.

Runs Nx workspace commands and returns structured per-project task results with cache status.

Runs `bun outdated` to check for outdated packages and returns structured version info.

Shows Terraform output values from the current state. Returns structured name/value/type/sensitive data.

Runs Oxlint and returns structured diagnostics (file, line, column, rule, severity, message).

Cleans Swift package build artifacts and returns structured result.

Initializes a new Swift package and returns structured result with created files.

Resolves Swift package dependencies and returns structured resolution results.

Shows the dependency tree of a Swift package and returns structured dependency data.

Updates Swift package dependencies and returns structured update results.

Runs pip-audit and returns a structured vulnerability report.

Runs pip install and returns a structured summary of installed packages. WARNING: may execute untrusted code.

Runs pip list and returns a structured list of installed packages.

Runs pip show and returns structured package metadata (name, version, summary, dependencies). Supports multiple packages in a single call.

Shows the Terraform execution plan with resource change counts. Read-only — does not modify infrastructure.

Runs Playwright tests with JSON reporter and returns structured results with pass/fail status, duration, and error messages.

Runs `bun pm ls` to list installed packages and returns structured package info.

Runs Poetry commands and returns structured output. Supports install, add, remove, show, build, update, lock, check, and export actions.

Makes an HTTP POST request via curl and returns structured response data. Convenience wrapper for the request tool with required body. SECURITY: URLs targeting private/reserved IPs are blocked (SSRF protection). File uploads via form @filepath are blocked by default (set PARE_HTTP_ALLOW_FILE_UPLOAD=true to allow). The proxy parameter routes traffic through an external proxy — use only with trusted proxies.

Lists check/status results for a pull request. Returns structured data with check names, states, URLs, summary counts (passed, failed, pending), and a top-level `conclusion` ("passed" | "failed" | "pending" | "none" | "timed_out") for easy branching. `conclusion: "passed"` is only ever returned when at least one check exists and all of them succeeded; a PR with zero reported checks returns `conclusion: "none"` (never "passed"), so a merge gate cannot mistake "CI has not started" for "CI is green". When watch=true, polls internally until checks appear AND all complete, or watchTimeout elapses; …

Closes a pull request with an optional comment and optional branch deletion. Returns structured data with PR number, state, URL, and deleted-branch flag.

Adds, edits, or deletes a comment on a pull request. Returns structured data with the comment URL, operation type, comment ID, and body echo.

Creates a new pull request. Returns structured data with PR number and URL.

Returns file-level diff statistics for a pull request. Use full=true for patch/hunk content, or nameOnly=true for just the changed file paths.

Lists pull requests with optional filters. Returns structured list with PR number, state, title, author, branch, labels, draft status, and merge readiness.

Merges a pull request by number, URL, or branch. Returns structured data with merge status, method, URL, and branch deletion status.

Marks a pull request as ready for review (or converts it back to draft when undo=true). Returns structured data with PR number, state, URL, and resulting draft status.

Reopens a previously closed pull request, optionally with a comment. Returns structured data with PR number, state, and URL.

Submits a review on a pull request (approve, request-changes, or comment). Returns structured data with the review event, URL, and body echo.

Updates pull request metadata (title, body, labels, assignees, reviewers, milestone, base branch, projects). Returns structured data with PR number and URL.

Description is built at runtime.

Formats files with Prettier (--write) and returns a structured list of changed files.

Lists Docker containers with structured status, ports, and state information.

Lists all PostgreSQL databases via psql with owner, encoding, and size info.

Executes a PostgreSQL query via psql and returns structured tabular output. WARNING: The query is executed as-is against the target database — do not pass untrusted input.

Runs dotnet publish for deployment and returns structured output with output path and diagnostics.

Pulls a Docker image from a registry and returns structured result with digest info.

Pushes commits to a remote repository. Returns structured data with success status, remote, branch, summary, and whether the remote branch was newly created.

Manages Python versions via pyenv.

Runs pytest and returns structured test results (passed, failed, errors, skipped, failures).

Rebases the current branch onto a target branch. Supports abort, continue, skip, and quit for conflict resolution. Returns structured data with success status, branch info, conflicts, and rebased commit count.

Executes a Redis command via redis-cli and returns the response. WARNING: The command is executed as-is — do not pass untrusted input.

Gets Redis server info with structured sections (server, clients, memory, etc.).

Tests Redis connectivity by sending a PING command.

Returns reference log entries as structured data, useful for recovery operations. Also supports checking if a reflog exists.

Creates a new GitHub release with optional asset uploads. Returns structured data with tag, URL, draft, prerelease status, and assets uploaded count.

Lists GitHub releases for a repository. Returns structured list with tag, name, draft/prerelease/latest status, publish date, and creation date.

Rebuilds the MCP server (or a specified project) and sends a `notifications/tools/list_changed` notification so the host re-fetches tool definitions. Useful during local development when code changes require a rebuild without restarting the session. Default build command: `pnpm build`. Override with `buildCommand` for custom setups. **Security warning**: The `buildCommand` parameter executes arbitrary commands. Configure `PARE_PROCESS_ALLOWED_COMMANDS` to restrict which executables are permitted. When not configured, any command is allowed.

Manages remote repositories. Supports list (default), add, remove, rename, set-url, prune, and show actions. Returns structured remote data.

Runs `bun remove` to remove one or more packages and returns structured output.

Clones a GitHub repository. Returns structured data with success status, repo name, target directory, and message.

Views repository details. Returns structured data with name, owner, description, stars, forks, languages, topics, license, and dates.

Makes an HTTP request via curl and returns structured response data (status, headers, body, timing). SECURITY: URLs targeting private/reserved IPs are blocked (SSRF protection). The proxy parameter routes traffic through an external proxy — use only with trusted proxies. File uploads via form @filepath are blocked by default (set PARE_HTTP_ALLOW_FILE_UPLOAD=true to allow).

Resets the current HEAD to a specified state. Supports soft, mixed, hard, merge, and keep modes. The 'hard' mode requires confirm=true as a safety guard since it permanently discards changes. Returns structured data with the ref, mode, and list of affected files. Pass `path` to target a specific repo or worktree — when omitted, operates on the server's own working directory, not the caller's (see #876).

Runs dotnet restore to restore NuGet dependencies and returns structured results.

Runs Rollup bundler and returns structured bundle output with errors and warnings.

Syncs files between local and remote locations using rsync. WARNING: Defaults to dry-run mode for safety — set dryRun=false to actually transfer files. Returns structured transfer statistics.

Runs ruff check and returns structured lint diagnostics (file, line, code, message).

Runs ruff format and returns structured results (files changed, file list).

Runs a script or file with `bun run` and returns structured output (stdout, stderr, exit code, duration).

Lists workflow runs with optional filters. Returns structured list with run ID, status, conclusion, and workflow details.

Re-runs a workflow run by ID. Optionally re-runs only failed jobs or a specific job. Returns structured result with run ID, status, and URL.

Views a workflow run by ID. Returns structured data with status, conclusion, jobs (with steps), and workflow details.

Searches the npm registry for packages matching a query. Note: pnpm and yarn do not have a search command, so this always uses npm.

Deletes a repository, organization, or environment GitHub Actions secret.

Lists repository, organization, or environment secret names and metadata. Secret values are not exposed by GitHub.

Sets a repository, organization, or environment GitHub Actions secret. Secret values are sent via stdin and never returned.

Runs Semgrep static analysis with structured rules and findings. Returns structured finding data with severity summary.

Makes packages available in the environment and optionally runs a command. Returns stdout, stderr, exit code, and duration.

Runs ShellCheck (shell script linter) and returns structured diagnostics (file, line, column, rule, severity, message).

Shows commit details and diff statistics for a given ref. When `file` is provided, extracts raw file content at that ref (e.g., `git show HEAD:src/index.ts`).

Retrieves public host keys from a remote SSH server using `ssh-keyscan`. Useful for populating known_hosts or verifying host key fingerprints.

Executes a command on a remote host via SSH. WARNING: This runs commands on a remote machine. Ensure the host and command are correct before executing. Returns structured output with stdout, stderr, exit code, and duration.

Tests SSH connectivity to a remote host using `ssh -T`. Returns whether the host is reachable and any banner message.

Pushes, pops, applies, drops, shows, or clears stash entries. Returns structured result with action, success, message, and stash reference.

Lists all stash entries with index, message, date, branch, and optional file change summary. Returns structured stash data.

Lists all resources tracked in the Terraform state. Returns resource addresses.

Returns a snapshot of container resource usage (CPU, memory, network/block I/O, PIDs) as structured data.

Returns the working tree status as structured data (branch, staged, modified, untracked, conflicts).

Runs Stylelint and returns structured diagnostics (file, line, column, rule, severity, message).

Manages git submodules. Supports list (default), add, update, sync, and deinit actions. List returns structured submodule data with path, SHA, branch, and status.

Manages git tags. Supports list (default), create, and delete actions. List returns structured tag data with name, date, and message. Create supports lightweight and annotated tags.

Runs a named task from deno.json via `deno task` and returns structured output (stdout, stderr, exit code, duration).

Runs `bun test` and returns structured pass/fail results with per-test details.

Displays the dependency tree for a Rust project.

Runs Trivy vulnerability/misconfiguration scanner on container images, filesystems, or IaC configs. Returns structured vulnerability data with severity summary.

Runs the TypeScript compiler and returns structured diagnostics (file, line, column, code, message). Note: In compact mode, diagnostics are trimmed to file, line, and code — column and message fields are omitted to save tokens.

Runs Turborepo tasks and returns structured per-package results with cache hit/miss info.

Updates dependencies in the lock file. Optionally updates a single package.

Runs uv pip install and returns a structured summary of installed packages. WARNING: may execute untrusted code.

Runs a command in a uv-managed environment and returns structured output.

Manages Vagrant VMs: status, global-status, up, halt, destroy.

Validates Terraform configuration files for syntax and consistency errors. Returns structured diagnostics.

Deletes a repository, organization, or environment GitHub Actions variable.

Lists repository, organization, or environment GitHub Actions variables with values and metadata.

Sets a repository, organization, or environment GitHub Actions variable. Variables are not secret and may be visible in logs.

Runs go vet and returns structured static analysis diagnostics with analyzer names. Uses -json flag for native JSON output with automatic text fallback.

Runs Vite production build and returns structured output files with sizes.

Lists Docker volumes with structured driver, mountpoint, and scope information.

Runs webpack build with JSON stats output and returns structured assets, errors, and warnings.

Manages Terraform workspaces: list, select, create, or delete workspaces.

Lists, adds, removes, locks, unlocks, or prunes git worktrees for managing multiple working trees. Returns structured data with worktree paths, branches, and HEAD commits. On list, pass withStatus for per-worktree {dirty, ahead, behind, unpushed} and/or mergedInto for a per-worktree merged flag. Use action=prune-merged {base, requireClean} for safe batch cleanup.

Processes and transforms YAML, JSON, XML, TOML, and properties files using yq expressions. Accepts input from a file path or inline string. Returns the transformed result.