Part of the Pare toolkit, this server wraps GitHub's CLI and API to surface pull requests, issues, actions, and repository metadata as structured JSON instead of raw terminal output. You get typed fields for PR status, issue labels, workflow runs, and commit details without parsing ANSI codes or GitHub's varied text formats. The token efficiency angle matters if you're running agents that poll CI status or triage issues repeatedly. Pare's approach cuts 60-90% of tokens on verbose commands like build logs, though simpler GitHub queries see smaller gains. Useful when you need reliable, schema-validated GitHub data for automation workflows rather than one-off manual checks.
Public tool metadata for what this MCP can expose to an agent.
actions_getGet details about specific GitHub Actions resources. Use this tool to get details about individual workflows, workflow runs, jobs, and artifacts by their unique IDs.4 paramsGet details about specific GitHub Actions resources. Use this tool to get details about individual workflows, workflow runs, jobs, and artifacts by their unique IDs.
repostringownerstringmethodstringget_workflow · get_workflow_run · get_workflow_job · download_workflow_run_artifact · get_workflow_run_usage · get_workflow_run_logs_urlresource_idstringactions_listTools for listing GitHub Actions resources. Use this tool to list workflows in a repository, or list workflow runs, jobs, and artifacts for a specific workflow or workflow run.8 paramsTools for listing GitHub Actions resources. Use this tool to list workflows in a repository, or list workflow runs, jobs, and artifacts for a specific workflow or workflow run.
pagenumberrepostringownerstringmethodstringlist_workflows · list_workflow_runs · list_workflow_jobs · list_workflow_run_artifactsper_pagenumberresource_idstringworkflow_jobs_filterobjectworkflow_runs_filterobjectactions_run_triggerTrigger GitHub Actions workflow operations, including running, re-running, cancelling workflow runs, and deleting workflow run logs.7 paramsTrigger GitHub Actions workflow operations, including running, re-running, cancelling workflow runs, and deleting workflow run logs.
refstringrepostringownerstringinputsobjectmethodstringrun_workflow · rerun_workflow_run · rerun_failed_jobs · cancel_workflow_run · delete_workflow_run_logsrun_idnumberworkflow_idstringadd_comment_to_pending_reviewAdd review comment to the requester's latest pending pull request review. A pending review needs to already exist to call this (check with the user if not sure).10 paramsAdd review comment to the requester's latest pending pull request review. A pending review needs to already exist to call this (check with the user if not sure).
bodystringlinenumberpathstringrepostringsidestringLEFT · RIGHTownerstringstartLinenumberstartSidestringLEFT · RIGHTpullNumbernumbersubjectTypestringFILE · LINEadd_issue_commentAdd a comment to a specific issue in a GitHub repository. Use this tool to add comments to pull requests as well (in this case pass pull request number as issue_number), but only if user is not asking specifically to add review comments.4 paramsAdd a comment to a specific issue in a GitHub repository. Use this tool to add comments to pull requests as well (in this case pass pull request number as issue_number), but only if user is not asking specifically to add review comments.
bodystringrepostringownerstringissue_numbernumberadd_reply_to_pull_request_commentAdd a reply to an existing pull request comment. This creates a new comment that is linked as a reply to the specified comment.5 paramsAdd a reply to an existing pull request comment. This creates a new comment that is linked as a reply to the specified comment.
bodystringrepostringownerstringcommentIdnumberpullNumbernumberassign_copilot_to_issueAssign Copilot to a specific issue in a GitHub repository. This tool can help with the following outcomes: - a Pull Request created with source code changes to resolve the issue More information can be found at: - https://docs.github.com/en/copilot/using-github-copilot/using-c...5 paramsAssign Copilot to a specific issue in a GitHub repository. This tool can help with the following outcomes: - a Pull Request created with source code changes to resolve the issue More information can be found at: - https://docs.github.com/en/copilot/using-github-copilot/using-c...
repostringownerstringbase_refstringissue_numbernumbercustom_instructionsstringcreate_branchCreate a new branch in a GitHub repository4 paramsCreate a new branch in a GitHub repository
repostringownerstringbranchstringfrom_branchstringcreate_gistCreate a new gist4 paramsCreate a new gist
publicbooleancontentstringfilenamestringdescriptionstringcreate_or_update_fileCreate or update a single file in a GitHub repository. If updating, you should provide the SHA of the file you want to update. Use this tool to create or update a file in a GitHub repository remotely; do not use it for local file operations. In order to obtain the SHA of origi...7 paramsCreate or update a single file in a GitHub repository. If updating, you should provide the SHA of the file you want to update. Use this tool to create or update a file in a GitHub repository remotely; do not use it for local file operations. In order to obtain the SHA of origi...
shastringpathstringrepostringownerstringbranchstringcontentstringmessagestringcreate_pull_requestCreate a new pull request in a GitHub repository.8 paramsCreate a new pull request in a GitHub repository.
basestringbodystringheadstringrepostringdraftbooleanownerstringtitlestringmaintainer_can_modifybooleancreate_pull_request_with_copilotDelegate a task to GitHub Copilot coding agent to perform in the background. The agent will create a pull request with the implementation. You should use this tool if the user asks to create a pull request to perform a specific task, or if the user asks Copilot to do something.5 paramsDelegate a task to GitHub Copilot coding agent to perform in the background. The agent will create a pull request with the implementation. You should use this tool if the user asks to create a pull request to perform a specific task, or if the user asks Copilot to do something.
repostringownerstringtitlestringbase_refstringproblem_statementstringcreate_repositoryCreate a new GitHub repository in your account or specified organization5 paramsCreate a new GitHub repository in your account or specified organization
namestringprivatebooleanautoInitbooleandescriptionstringorganizationstringdelete_fileDelete a file from a GitHub repository5 paramsDelete a file from a GitHub repository
pathstringrepostringownerstringbranchstringmessagestringdismiss_notificationDismiss a notification by marking it as read or done2 paramsDismiss a notification by marking it as read or done
statestringread · donethreadIDstringfork_repositoryFork a GitHub repository to your account or specified organization3 paramsFork a GitHub repository to your account or specified organization
repostringownerstringorganizationstringget_code_scanning_alertGet details of a specific code scanning alert in a GitHub repository.3 paramsGet details of a specific code scanning alert in a GitHub repository.
repostringownerstringalertNumbernumberget_commitGet details for a commit from a GitHub repository6 paramsGet details for a commit from a GitHub repository
shastringpagenumberrepostringownerstringperPagenumberinclude_diffbooleanget_copilot_job_statusGet the status of a GitHub Copilot coding agent job. Use this to check if a previously submitted task has completed and to get the pull request URL once it's created. Provide the job ID (from create_pull_request_with_copilot) or pull request number (from assign_copilot_to_issu...3 paramsGet the status of a GitHub Copilot coding agent job. Use this to check if a previously submitted task has completed and to get the pull request URL once it's created. Provide the job ID (from create_pull_request_with_copilot) or pull request number (from assign_copilot_to_issu...
idstringrepostringownerstringget_copilot_spaceThis tool can be used to provide additional context to the chat from a specific Copilot space. If the user mentions the keyword 'Copilot space' with the name and owner of the space, execute this tool. The response includes a table of contents (TOC) listing all documents in the...2 paramsThis tool can be used to provide additional context to the chat from a specific Copilot space. If the user mentions the keyword 'Copilot space' with the name and owner of the space, execute this tool. The response includes a table of contents (TOC) listing all documents in the...
namestringownerstringget_dependabot_alertGet details of a specific dependabot alert in a GitHub repository.3 paramsGet details of a specific dependabot alert in a GitHub repository.
repostringownerstringalertNumbernumberget_discussionGet a specific discussion by ID3 paramsGet a specific discussion by ID
repostringownerstringdiscussionNumbernumberget_discussion_commentsGet comments from a discussion5 paramsGet comments from a discussion
repostringafterstringownerstringperPagenumberdiscussionNumbernumberget_file_contentsGet the contents of a file or directory from a GitHub repository5 paramsGet the contents of a file or directory from a GitHub repository
refstringshastringpathstringrepostringownerstringget_gistGet gist content of a particular gist, by gist ID1 paramsGet gist content of a particular gist, by gist ID
gist_idstringget_global_security_advisoryGet a global security advisory1 paramsGet a global security advisory
ghsaIdstringget_job_logsGet logs for GitHub Actions workflow jobs. Use this tool to retrieve logs for a specific job or all failed jobs in a workflow run. For single job logs, provide job_id. For all failed jobs in a run, provide run_id with failed_only=true.7 paramsGet logs for GitHub Actions workflow jobs. Use this tool to retrieve logs for a specific job or all failed jobs in a workflow run. For single job logs, provide job_id. For all failed jobs in a run, provide run_id with failed_only=true.
repostringownerstringjob_idnumberrun_idnumbertail_linesnumberfailed_onlybooleanreturn_contentbooleanget_labelGet a specific label from a repository.3 paramsGet a specific label from a repository.
namestringrepostringownerstringget_latest_releaseGet the latest release in a GitHub repository2 paramsGet the latest release in a GitHub repository
repostringownerstringget_meGet details of the authenticated GitHub user. Use this when a request is about the user's own profile for GitHub. Or when information is missing to build other tool calls.Get details of the authenticated GitHub user. Use this when a request is about the user's own profile for GitHub. Or when information is missing to build other tool calls.
No parameter schema in public metadata yet.
get_notification_detailsGet detailed information for a specific GitHub notification, always call this tool when the user asks for details about a specific notification, if you don't know the ID list notifications first.1 paramsGet detailed information for a specific GitHub notification, always call this tool when the user asks for details about a specific notification, if you don't know the ID list notifications first.
notificationIDstringget_release_by_tagGet a specific release by its tag name in a GitHub repository3 paramsGet a specific release by its tag name in a GitHub repository
tagstringrepostringownerstringget_repository_treeGet the tree structure (files and directories) of a GitHub repository at a specific ref or SHA5 paramsGet the tree structure (files and directories) of a GitHub repository at a specific ref or SHA
repostringownerstringtree_shastringrecursivebooleanpath_filterstringget_secret_scanning_alertGet details of a specific secret scanning alert in a GitHub repository.3 paramsGet details of a specific secret scanning alert in a GitHub repository.
repostringownerstringalertNumbernumberget_tagGet details about a specific git tag in a GitHub repository3 paramsGet details about a specific git tag in a GitHub repository
tagstringrepostringownerstringget_team_membersGet member usernames of a specific team in an organization. Limited to organizations accessible with current credentials2 paramsGet member usernames of a specific team in an organization. Limited to organizations accessible with current credentials
orgstringteam_slugstringget_teamsGet details of the teams the user is a member of. Limited to organizations accessible with current credentials1 paramsGet details of the teams the user is a member of. Limited to organizations accessible with current credentials
userstringgithub_support_docs_searchRetrieve documentation relevant to answer GitHub product and support questions. Support topics include: GitHub Actions Workflows, Authentication, GitHub Support Inquiries, Pull Request Practices, Repository Maintenance, GitHub Pages, GitHub Packages, GitHub Discussions, Copilo...1 paramsRetrieve documentation relevant to answer GitHub product and support questions. Support topics include: GitHub Actions Workflows, Authentication, GitHub Support Inquiries, Pull Request Practices, Repository Maintenance, GitHub Pages, GitHub Packages, GitHub Discussions, Copilo...
querystringissue_readGet information about a specific issue in a GitHub repository.6 paramsGet information about a specific issue in a GitHub repository.
pagenumberrepostringownerstringmethodstringget · get_comments · get_sub_issues · get_labelsperPagenumberissue_numbernumberissue_writeCreate a new or update an existing issue in a GitHub repository.13 paramsCreate a new or update an existing issue in a GitHub repository.
bodystringrepostringtypestringownerstringstatestringopen · closedtitlestringlabelsarraymethodstringcreate · updateassigneesarraymilestonenumberduplicate_ofnumberissue_numbernumberstate_reasonstringcompleted · not_planned · duplicatelabel_writePerform write operations on repository labels. To set labels on issues, use the 'update_issue' tool.7 paramsPerform write operations on repository labels. To set labels on issues, use the 'update_issue' tool.
namestringrepostringcolorstringownerstringmethodstringcreate · update · deletenew_namestringdescriptionstringlist_branchesList branches in a GitHub repository4 paramsList branches in a GitHub repository
pagenumberrepostringownerstringperPagenumberlist_code_scanning_alertsList code scanning alerts in a GitHub repository.6 paramsList code scanning alerts in a GitHub repository.
refstringrepostringownerstringstatestringopen · closed · dismissed · fixeddefault: openseveritystringcritical · high · medium · low · warning · notetool_namestringlist_commitsGet list of commits of a branch in a GitHub repository. Returns at least 30 results per page by default, but can return more if specified using the perPage parameter (up to 100).6 paramsGet list of commits of a branch in a GitHub repository. Returns at least 30 results per page by default, but can return more if specified using the perPage parameter (up to 100).
shastringpagenumberrepostringownerstringauthorstringperPagenumberlist_copilot_spacesRetrieves the list of Copilot Spaces accessible to the user, including their names and owners.Retrieves the list of Copilot Spaces accessible to the user, including their names and owners.
No parameter schema in public metadata yet.
list_dependabot_alertsList dependabot alerts in a GitHub repository.4 paramsList dependabot alerts in a GitHub repository.
repostringownerstringstatestringopen · fixed · dismissed · auto_dismisseddefault: openseveritystringlow · medium · high · criticallist_discussion_categoriesList discussion categories with their id and name, for a repository or organisation.2 paramsList discussion categories with their id and name, for a repository or organisation.
repostringownerstringlist_discussionsList discussions for a repository or organisation.7 paramsList discussions for a repository or organisation.
repostringafterstringownerstringorderBystringCREATED_AT · UPDATED_ATperPagenumbercategorystringdirectionstringASC · DESClist_gistsList gists for a user4 paramsList gists for a user
pagenumbersincestringperPagenumberusernamestringlist_global_security_advisoriesList global security advisories from GitHub.11 paramsList global security advisories from GitHub.
cwesarraytypestringreviewed · malware · unrevieweddefault: reviewedcveIdstringghsaIdstringaffectsstringupdatedstringmodifiedstringseveritystringunknown · low · medium · high · criticalecosystemstringactions · composer · erlang · go · maven · npmpublishedstringisWithdrawnbooleanlist_issue_typesList supported issue types for repository owner (organization).1 paramsList supported issue types for repository owner (organization).
ownerstringlist_issuesList issues in a GitHub repository. For pagination, use the 'endCursor' from the previous response's 'pageInfo' in the 'after' parameter.9 paramsList issues in a GitHub repository. For pagination, use the 'endCursor' from the previous response's 'pageInfo' in the 'after' parameter.
repostringafterstringownerstringsincestringstatestringOPEN · CLOSEDlabelsarrayorderBystringCREATED_AT · UPDATED_AT · COMMENTSperPagenumberdirectionstringASC · DESClist_labelList labels from a repository2 paramsList labels from a repository
repostringownerstringlist_notificationsLists all GitHub notifications for the authenticated user, including unread notifications, mentions, review requests, assignments, and updates on issues or pull requests. Use this tool whenever the user asks what to work on next, requests a summary of their GitHub activity, wa...7 paramsLists all GitHub notifications for the authenticated user, including unread notifications, mentions, review requests, assignments, and updates on issues or pull requests. Use this tool whenever the user asks what to work on next, requests a summary of their GitHub activity, wa...
pagenumberrepostringownerstringsincestringbeforestringfilterstringdefault · include_read_notifications · only_participatingperPagenumberlist_org_repository_security_advisoriesList repository security advisories for a GitHub organization.4 paramsList repository security advisories for a GitHub organization.
orgstringsortstringcreated · updated · publishedstatestringtriage · draft · published · closeddirectionstringasc · desclist_pull_requestsList pull requests in a GitHub repository. If the user specifies an author, then DO NOT use this tool and use the search_pull_requests tool instead.9 paramsList pull requests in a GitHub repository. If the user specifies an author, then DO NOT use this tool and use the search_pull_requests tool instead.
basestringheadstringpagenumberrepostringsortstringcreated · updated · popularity · long-runningownerstringstatestringopen · closed · allperPagenumberdirectionstringasc · desclist_releasesList releases in a GitHub repository4 paramsList releases in a GitHub repository
pagenumberrepostringownerstringperPagenumberlist_repository_security_advisoriesList repository security advisories for a GitHub repository.5 paramsList repository security advisories for a GitHub repository.
repostringsortstringcreated · updated · publishedownerstringstatestringtriage · draft · published · closeddirectionstringasc · desclist_secret_scanning_alertsList secret scanning alerts in a GitHub repository.5 paramsList secret scanning alerts in a GitHub repository.
repostringownerstringstatestringopen · resolvedresolutionstringfalse_positive · wont_fix · revoked · pattern_edited · pattern_deleted · used_in_testssecret_typestringlist_starred_repositoriesList starred repositories5 paramsList starred repositories
pagenumbersortstringcreated · updatedperPagenumberusernamestringdirectionstringasc · desclist_tagsList git tags in a GitHub repository4 paramsList git tags in a GitHub repository
pagenumberrepostringownerstringperPagenumbermanage_notification_subscriptionManage a notification subscription: ignore, watch, or delete a notification thread subscription.2 paramsManage a notification subscription: ignore, watch, or delete a notification thread subscription.
actionstringignore · watch · deletenotificationIDstringmanage_repository_notification_subscriptionManage a repository notification subscription: ignore, watch, or delete repository notifications subscription for the provided repository.3 paramsManage a repository notification subscription: ignore, watch, or delete repository notifications subscription for the provided repository.
repostringownerstringactionstringignore · watch · deletemark_all_notifications_readMark all notifications as read3 paramsMark all notifications as read
repostringownerstringlastReadAtstringmerge_pull_requestMerge a pull request in a GitHub repository.6 paramsMerge a pull request in a GitHub repository.
repostringownerstringpullNumbernumbercommit_titlestringmerge_methodstringmerge · squash · rebasecommit_messagestringprojects_getGet details about specific GitHub Projects resources. Use this tool to get details about individual projects, project fields, and project items by their unique IDs.8 paramsGet details about specific GitHub Projects resources. Use this tool to get details about individual projects, project fields, and project items by their unique IDs.
ownerstringfieldsarraymethodstringget_project · get_project_field · get_project_item · get_project_status_updateitem_idnumberfield_idnumberowner_typestringuser · orgproject_numbernumberstatus_update_idstringprojects_listTools for listing GitHub Projects resources. Use this tool to list projects for a user or organization, or list project fields and items for a specific project.9 paramsTools for listing GitHub Projects resources. Use this tool to list projects for a user or organization, or list project fields and items for a specific project.
afterstringownerstringquerystringbeforestringfieldsarraymethodstringlist_projects · list_project_fields · list_project_items · list_project_status_updatesper_pagenumberowner_typestringuser · orgproject_numbernumberprojects_writeAdd, update, or delete project items, or create status updates in a GitHub Project.15 paramsAdd, update, or delete project items, or create status updates in a GitHub Project.
bodystringownerstringmethodstringadd_project_item · update_project_item · delete_project_item · create_project_status_updatestatusstringINACTIVE · ON_TRACK · AT_RISK · OFF_TRACK · COMPLETEitem_idnumberitem_repostringitem_typestringissue · pull_requestitem_ownerstringowner_typestringuser · orgstart_datestringtarget_datestringissue_numbernumberupdated_fieldobjectproject_numbernumberpull_request_numbernumberpull_request_readGet information on a specific pull request in GitHub repository.6 paramsGet information on a specific pull request in GitHub repository.
pagenumberrepostringownerstringmethodstringget · get_diff · get_status · get_files · get_review_comments · get_reviewsperPagenumberpullNumbernumberpull_request_review_writeCreate and/or submit, delete review of a pull request. Available methods: - create: Create a new review of a pull request. If "event" parameter is provided, the review is submitted. If "event" is omitted, a pending review is created. - submit_pending: Submit an existing pendin...7 paramsCreate and/or submit, delete review of a pull request. Available methods: - create: Create a new review of a pull request. If "event" parameter is provided, the review is submitted. If "event" is omitted, a pending review is created. - submit_pending: Submit an existing pendin...
bodystringrepostringeventstringAPPROVE · REQUEST_CHANGES · COMMENTownerstringmethodstringcreate · submit_pending · delete_pendingcommitIDstringpullNumbernumberpush_filesPush multiple files to a GitHub repository in a single commit5 paramsPush multiple files to a GitHub repository in a single commit
repostringfilesarrayownerstringbranchstringmessagestringrequest_copilot_reviewRequest a GitHub Copilot code review for a pull request. Use this for automated feedback on pull requests, usually before requesting a human reviewer.3 paramsRequest a GitHub Copilot code review for a pull request. Use this for automated feedback on pull requests, usually before requesting a human reviewer.
repostringownerstringpullNumbernumberrun_secret_scanningScan files, content, or recent changes for secrets such as API keys, passwords, tokens, and credentials. This tool is intended for targeted scans of specific files, snippets, or diffs provided directly as content. It accepts file contents or diffs and returns detected secrets...3 paramsScan files, content, or recent changes for secrets such as API keys, passwords, tokens, and credentials. This tool is intended for targeted scans of specific files, snippets, or diffs provided directly as content. It accepts file contents or diffs and returns detected secrets...
repostringfilesarrayownerstringsearch_codeFast and precise code search across ALL GitHub repositories using GitHub's native search engine. Best for finding exact symbols, functions, classes, or specific code patterns.5 paramsFast and precise code search across ALL GitHub repositories using GitHub's native search engine. Best for finding exact symbols, functions, classes, or specific code patterns.
pagenumbersortstringorderstringasc · descquerystringperPagenumbersearch_issuesSearch for issues in GitHub repositories using issues search syntax already scoped to is:issue7 paramsSearch for issues in GitHub repositories using issues search syntax already scoped to is:issue
pagenumberrepostringsortstringcomments · reactions · reactions-+1 · reactions--1 · reactions-smile · reactions-thinking_faceorderstringasc · descownerstringquerystringperPagenumbersearch_orgsFind GitHub organizations by name, location, or other organization metadata. Ideal for discovering companies, open source foundations, or teams.5 paramsFind GitHub organizations by name, location, or other organization metadata. Ideal for discovering companies, open source foundations, or teams.
pagenumbersortstringfollowers · repositories · joinedorderstringasc · descquerystringperPagenumbersearch_pull_requestsSearch for pull requests in GitHub repositories using issues search syntax already scoped to is:pr7 paramsSearch for pull requests in GitHub repositories using issues search syntax already scoped to is:pr
pagenumberrepostringsortstringcomments · reactions · reactions-+1 · reactions--1 · reactions-smile · reactions-thinking_faceorderstringasc · descownerstringquerystringperPagenumbersearch_repositoriesFind GitHub repositories by name, description, readme, topics, or other metadata. Perfect for discovering projects, finding examples, or locating specific repositories across GitHub.6 paramsFind GitHub repositories by name, description, readme, topics, or other metadata. Perfect for discovering projects, finding examples, or locating specific repositories across GitHub.
pagenumbersortstringstars · forks · help-wanted-issues · updatedorderstringasc · descquerystringperPagenumberminimal_outputbooleansearch_usersFind GitHub users by username, real name, or other profile information. Useful for locating developers, contributors, or team members.5 paramsFind GitHub users by username, real name, or other profile information. Useful for locating developers, contributors, or team members.
pagenumbersortstringfollowers · repositories · joinedorderstringasc · descquerystringperPagenumberstar_repositoryStar a GitHub repository2 paramsStar a GitHub repository
repostringownerstring
PareReliable, structured CLI output for AI agents — no more parsing fragile terminal text.
Pare provides MCP servers that wrap common developer tools (git, npm, docker, test runners, etc.) and return clean, schema-validated JSON instead of raw terminal text. Agents get typed data they can act on directly, without brittle string parsing.
Parsing CLI output is fragile. Raw terminal text includes ANSI escape codes, decorative headers, progress bars, locale-specific formatting, and platform differences that break agent workflows in subtle ways. An agent that works fine with git status on macOS may fail on Windows because the output format changed. A test runner's summary line might shift between versions, silently breaking a regex.
Pare eliminates this entire class of errors by returning schema-validated JSON with consistent field names, regardless of platform, tool version, or locale. As a bonus, structured output is significantly smaller — agents use fewer tokens per tool call:
| Tool Command | Raw Tokens | Pare Tokens | Reduction |
|---|---|---|---|
docker build (multi-stage, 11 steps) | 373 | 20 | 95% |
git log --stat (5 commits, verbose) | 4,992 | 382 | 92% |
npm install (487 packages, warnings) | 241 | 41 | 83% |
vitest run (28 tests, all pass) | 196 | 39 | 80% |
cargo build (2 errors, help text) | 436 | 138 | 68% |
pip install (9 packages, progress bars) | 288 | 101 | 65% |
cargo test (12 tests, 2 failures) | 351 | 190 | 46% |
npm audit (4 vulnerabilities) | 287 | 185 | 36% |
Token estimates use ~4 chars/token. The biggest savings appear on verbose commands (builds, installs, tests). For simpler tools like
eslintortsc, the main advantage is reliable structured data — agents can use typed JSON directly rather than parsing strings.
Each Pare tool returns two outputs:
content — human-readable text, for MCP clients that display itstructuredContent — typed, schema-validated JSON, ready for agents to processThis uses MCP's structuredContent and outputSchema features to provide type-safe, validated data that agents can rely on without custom parsing.
git statusRaw git output (~118 tokens):
On branch main
Your branch is ahead of 'origin/main' by 2 commits.
(use "git push" to publish your local commits)
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
modified: src/index.ts
new file: src/utils.ts
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: README.md
Untracked files:
(use "git add <file>..." to include in what will be committed)
temp.log
Pare structured output (~59 tokens):
{
"branch": "main",
"upstream": "origin/main",
"ahead": 2,
"staged": [
{ "file": "src/index.ts", "status": "modified" },
{ "file": "src/utils.ts", "status": "added" }
],
"modified": ["README.md"],
"deleted": [],
"untracked": ["temp.log"],
"conflicts": [],
"clean": false
}
50% fewer tokens. Zero information lost. Fully typed. Savings scale with output verbosity — test runners and build logs see 80–92% reduction.
Install only the servers relevant to your stack — most projects need just 2–4. The full catalog covers a wide range of ecosystems so Pare works wherever you do.
| Category | Servers | Tools | Wraps |
|---|---|---|---|
| Version Control | git, github | 55 | git, gh |
| Languages & Packages | npm, python, cargo, go, deno, bun, nix, dotnet, ruby, swift, jvm | 101 | npm, pip, cargo, go, deno, bun, nix, dotnet, gem, swift, gradle, maven |
| Build, Lint & Test | build, lint, test, cmake, bazel | 23 | tsc, esbuild, vite, webpack, eslint, prettier, biome, vitest, pytest, jest |
| Infrastructure | docker, k8s, infra, security, remote | 40 | docker, kubectl, helm, terraform, ansible, trivy, ssh |
| Utilities | search, http, make, process, db | 21 | ripgrep, fd, curl, make, just, psql, mysql, redis, mongosh |
Tool Schemas — detailed response examples and field descriptions for every tool. See also Tool Response Examples for quick JSON samples.
# 1. Configure MCP servers (non-interactive)
npx @paretools/init --client claude-code --preset web
# 2. Add agent rules to your project
# (append to existing CLAUDE.md, or copy if new)
cat node_modules/@paretools/init/rules/CLAUDE.md >> CLAUDE.md
# 3. Restart your client session
# 4. Validate
npx @paretools/init doctor
Available presets: web, python, rust, go, jvm, dotnet, ruby, swift, mobile, devops, full
| Claude Code | Claude Desktop | Cursor |
| VS Code / Copilot | Windsurf | Cline / Roo Code |
| OpenAI Codex | Gemini CLI | Zed |
| Continue.dev |
Full Quickstart Guide — presets, ecosystem mapping, validation
Manual Configuration — config paths and formats for all clients
Agent Integration Guide — rule files, hooks, CLI-to-MCP mapping
By default, every Pare server registers all of its tools. If a server exposes tools you don't need — or you want to limit which tools are available to an agent — you can filter them with environment variables.
Per-server filter — restrict a single server's tools:
# Only register status and log in the git server
PARE_GIT_TOOLS=status,log npx @paretools/git
Universal filter — restrict tools across all servers:
# Only register these specific tools across any server
PARE_TOOLS=git:status,git:log,npm:install npx @paretools/git
Disable all tools — set the env var to an empty string:
PARE_GIT_TOOLS= npx @paretools/git # no tools registered
| Env Var | Scope | Format | Example |
|---|---|---|---|
PARE_TOOLS | All servers | server:tool,... | git:status,npm:install |
PARE_{SERVER}_TOOLS | One server | tool,... | status,log,diff |
Rules:
PARE_TOOLS (universal) takes precedence over per-server varsPARE_MY_SERVER_TOOLS)Common patterns:
# Read-only git (no push, commit, add, checkout)
PARE_GIT_TOOLS=status,log,diff,branch,show
# Minimal npm
PARE_NPM_TOOLS=install,test,run
# Only specific tools across all servers
PARE_TOOLS=git:status,git:diff,npm:install,test:run
In JSON MCP config, set via the env key:
{
"mcpServers": {
"pare-git": {
"command": "npx",
"args": ["-y", "@paretools/git"],
"env": {
"PARE_GIT_TOOLS": "status,log,diff,show"
}
}
}
}
| Issue | Solution |
|---|---|
npx not found / ENOENT on Windows | Use cmd /c npx wrapper (see your client's setup guide) |
| Slow first start | Run npx -y @paretools/git once to cache, or install globally: npm i -g @paretools/git |
| Node.js version error | Pare requires Node.js >= 20 |
| NVM/fnm PATH issues | Use absolute path to npx: e.g., ~/.nvm/versions/node/v22/bin/npx |
| MCP connection timeout | Set MCP_TIMEOUT=30000 for Claude Code, or increase initTimeout in client config |
| Too many tools filling context | Use tool selection env vars to limit tools, or only install the servers you need |
Each server is a self-contained package. See CONTRIBUTING.md for the full guide.
ray0907/git-mcp-server
cyanheads/git-mcp-server
io.github.b1ff/atlassian-dc-mcp-bitbucket
io.github.b1ff/atlassian-dc-mcp-jira
com.mcparmory/atlassian-jira
sirlordt/vscode-terminal-mcp