MCPs Use Cases Use cases by category
Productivity & Inbox Inbox, calendar, and daily flow Engineering & DevOps Ship, debug, and run on-call Sales & CRM Pipeline, outreach, and deals Marketing & Growth Campaigns, SEO, and growth Support & Success Triage tickets, keep customers happy Finance & Ops Close, reconcile, and expenses Creative & Content Generate assets and content People & Hiring Hiring, onboarding, and HR Research & Data Synthesize data and insights See all use cases Blogs Pricing Docs Search | ⌘ KSign in Infrastructure You Can Trust for Agentic Products
© 2026 MewCP. All rights reserved.
Github MCP Server | MewCP
Github
Share your feedback directly with the maintainers - every feedback helps make this server better for everyone.
Comprehensive GitHub API access for repositories, issues, pull requests, and code — all through typed MCP tools.
A Model Context Protocol (MCP) server that exposes GitHub's API for managing repositories, issues, pull requests, branches, releases, tags, branch protection, and repository rulesets.
Overview
The MewCP GitHub MCP Server provides:
Repository management — get, create, update, and fork repositories; create or update files and push multi-file commits
Search across GitHub — repositories, code, users, issues, and pull requests
Issue tracking — list, get, create, comment on, and update issues, including sub-issue relationships and Copilot assignment
Pull request workflows — read, list, create, update, merge PRs, manage branch updates, write reviews, reply to comments, and request Copilot review
Repository administration — branches, commits, file contents, tags, releases, labels, branch protection, PR review protection, and repository rulesets
Perfect for:
AI agents that need to read and act on GitHub repository state (issues, PRs, files, commits)
Automating routine GitHub workflows — issue triage, PR review requests, release lookups
Enforcing and auditing repository governance — branch protection, PR review requirements, rulesets
get_repo — Get basic details for a GitHub repository.Get basic details for a GitHub repository.
Inputs:
- `owner` (string, required) — Repository owner, for example octocat - `repo` (string, required) — Repository name output data
{ id : number | null ; name : string | null ; full_name : string | null ; owner : object | null ; html_url : string | null ; description : string | null ; private : boolean | null ; fork : boolean update_repository — Updates repository metadata or renames a repository.Updates repository metadata or renames a repository. Only the fields you provide are changed — others keep their current value. NOTE: this overwrites the current field values — the original state is not stored after the call. The response includes both the before and after state so you have a full record of what changed.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `name` (string, optional) — New repository name (to rename) - `description` (string, optional) — Repository description - `private` (boolean, optional) — Make repository private/public - `default_branch` (string, optional) — Default branch name output data
create_repository — Create a new GitHub repository in your personal account or an organization.Create a new GitHub repository in your personal account or an organization.
Inputs:
- `name` (string, required) — Repository name (required). Must be unique in account/organization. - `description` (string, optional) — Repository description (optional). - `private` (boolean, optional, default: false ) — Make repository private (default: False for public). - `auto_init` (boolean, optional, default: false ) — Auto-initialize with README (default: False). - `gitignore_template` (string, optional) — Gitignore template name. Example: 'Python', 'Node'. - `org` (string, optional) — Organization name to create repo in (optional). output data
fork_repository — Fork a repository to your personal account or an organization.Fork a repository to your personal account or an organization.
Inputs:
- `owner` (string, required) — Original repository owner. - `repo` (string, required) — Original repository name. - `org` (string, optional) — Organization name to fork into (optional). output data
{ id : number | null ; name : string | null ; create_or_update_file — Create or update a file in a repository. Prevents accidental overwrites with SHA validation.Create or update a file in a repository. Prevents accidental overwrites with SHA validation.
Inputs:
- `owner` (string, required) — Repository owner name. - `repo` (string, required) — Repository name. - `path` (string, required) — File path in repository. Example: 'src/main.py'. - `content` (string, required) — File content to write. - `message` (string, required) — Commit message. - `branch` (string, optional) — Target branch name (optional). - `sha` (string, optional) — File SHA for updates (optional). output data
push_files — Push multiple files to a repository in a single atomic commit.Push multiple files to a repository in a single atomic commit.
Inputs:
- `owner` (string, required) — Repository owner name. - `repo` (string, required) — Repository name. - `files_json` (string, required) — JSON array of file objects with path and content keys. Example: '[{ "path" : "file1.txt" , "content" : "hello" }]' - `message` (string, required) — Commit message. - `branch` (string, optional) — Target branch name (optional). - `author_name` (string, optional) — Author name (optional). - `author_email` (string, optional) — Author email (optional). output
search_repositories — Search GitHub repositories.Search GitHub repositories.
Inputs:
- `query` (string, required) — Search query - `sort` (string, optional, default: "stars" ) — Sort by: stars, forks, updated - `order` (string, optional, default: "desc" ) — Order: asc or desc - `page` (integer, optional, default: 1 ) — Page number - `perPage` (integer, optional, default: 30 ) — Items per page output data
search_code — Fast and precise code search across GitHub repositories.Fast and precise code search across GitHub repositories.
Inputs:
- `query` (string, required) — Search query using GitHub code search syntax. - `sort` (string, optional, default: "indexed" ) — Sort field. Only 'indexed' is supported. - `order` (string, optional, default: "desc" ) — Sort order: asc or desc. - `page` (integer, optional, default: 1 ) — Page number. - `perPage` (integer, optional, default: 30 ) — Results per page ( 1-100 ). output data
search_users — Search GitHub users by name, location, followers, or other attributes.Search GitHub users by name, location, followers, or other attributes.
Inputs:
- `query` (string, required) — User search query using GitHub's search syntax. - `sort` (string, optional, default: "followers" ) — Sort field: followers, repositories, joined. - `order` (string, optional, default: "desc" ) — Sort order: asc or desc. - `page` (integer, optional, default: 1 ) — Page number. - `perPage` (integer, optional, default: 30 ) — Results per page ( 1-100 ). output data
search_issues — Search issues and pull requests across GitHub.Search issues and pull requests across GitHub.
Inputs:
- `query` (string, required) — Search query using GitHub issue search syntax. - `sort` (string, optional, default: "updated" ) — Sort field: updated, created, comments. - `order` (string, optional, default: "desc" ) — Sort order: asc or desc. - `owner` (string, optional) — Repository owner (optional). - `repo` (string, optional) — Repository name (optional). - `page` (integer, optional, default: 1 ) — Page number. - `perPage` (integer, optional, default: 30 ) — Results per page ( 1-100 ). output
search_pull_requests — Search for pull requests across GitHub using search syntax.Search for pull requests across GitHub using search syntax.
Inputs:
- `query` (string, required) — Search query using GitHub search syntax. - `sort` (string, optional, default: "updated" ) — Sort field: updated, created, comments. - `order` (string, optional, default: "desc" ) — Sort order: asc or desc. - `owner` (string, optional) — Repository owner (optional). - `repo` (string, optional) — Repository name (optional). - `page` (integer, optional, default: 1 ) — Page number. - `per_page` (integer, optional, default: 30 ) — Results per page. output
list_issues — List issues in a GitHub repository.List issues in a GitHub repository.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `state` (string, optional, default: "open" ) — Filter by state: open, closed, all - `labels` (string, optional) — Comma-separated label names to filter by - `page` (integer, optional, default: 1 ) — Page number - `perPage` (integer, optional, default: 30 ) — Items per page output data
get_issue — Get detailed information about a specific GitHub issue.Get detailed information about a specific GitHub issue.
Inputs:
- `owner` (string, required) — Repository owner name. - `repo` (string, required) — Repository name. - `issue_number` (integer, required) — Issue number. output data
{ number : number | null ; title : string | null ; body get_issue_comments — Get all comments on a GitHub issue with pagination support.Get all comments on a GitHub issue with pagination support.
Inputs:
- `owner` (string, required) — Repository owner name. - `repo` (string, required) — Repository name. - `issue_number` (integer, required) — Issue number. - `page` (integer, optional, default: 1 ) — Page number. - `perPage` (integer, optional, default: 30 ) — Comments per page ( 1-100 ). output data
create_issue — Create a new GitHub issue in a repository.Create a new GitHub issue in a repository.
Inputs:
- `owner` (string, required) — Repository owner name. - `repo` (string, required) — Repository name. - `title` (string, required) — Issue title (required). - `body` (string, optional) — Issue description (optional). - `assignees` (string[], optional) — List of usernames to assign (optional). - `labels` (string[], optional) — List of label names (optional). - `milestone` (integer, optional) — Milestone ID (optional). output data
add_issue_comment — Add a comment to a GitHub issue or pull request.Add a comment to a GitHub issue or pull request.
Inputs:
- `owner` (string, required) — Repository owner name. - `repo` (string, required) — Repository name. - `issue_number` (integer, required) — Issue or pull request number. - `body` (string, required) — Comment text (required). output data
{ id : number | null ; url : string | update_issue — Updates a GitHub issue's title, body, state, assignees, labels, or milestone.Updates a GitHub issue's title, body, state, assignees, labels, or milestone. Only the fields you provide are changed — others keep their current value. NOTE: this overwrites the current field values — the original state is not stored after the call. The response includes both the before and after state so you have a full record of what changed.
Inputs:
- `owner` (string, required) — Repository owner name. - `repo` (string, required) — Repository name. - `issue_number` (integer, required) — Issue number to update. - `title` (string, optional) — New issue title (optional). - `body` (string, optional) — New issue description (optional). - `state` (string, optional) — New state: open or closed (optional). - `state_reason` (string, optional) — Reason when closing: completed, not_planned (optional). - `assignees` (string[], optional) — New list of assignees (optional). - `labels` (string[], optional) — New list of labels (optional). - `milestone` (integer, optional) — Milestone ID (optional). list_org_repositories_by_contributor — Find all repositories in an organization where specific contributors have made contributions.Find all repositories in an organization where specific contributors have made contributions.
Inputs:
- `org` (string, required) — Organization name - `contributor_usernames` (string, required) — GitHub username(s) to filter by. Comma-separated for multiple. - `repo_type` (string, optional, default: "all" ) — Filter by type: all, public, or private. output data
{ filter_contributors : string[]; organization sub_issue_write — Manage sub-issues for a parent issue (add, remove, reprioritize).Manage sub-issues for a parent issue (add, remove, reprioritize).
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `issue_number` (integer, required) — Parent issue number - `method` (string, required) — Operation: add, remove, or reprioritize - `sub_issue_id` (integer, required) — ID of the sub-issue - `replace_parent` (boolean, optional, default: false ) — Replace current parent when adding - `after_id` (integer, optional) — Sub-issue ID to position after - `before_id` (integer, optional) — Sub-issue ID to position before output data
assign_copilot_to_issue — Assign GitHub Copilot to work on an issue.Assign GitHub Copilot to work on an issue.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `issue_number` (integer, required) — Issue number - `base_ref` (string, optional) — Git reference to start from (optional). - `custom_instructions` (string, optional) — Additional context for Copilot (optional). output data
{ issue_number : number | null pull_request_read — Get details for a pull request with flexible method options (get, get_files, get_status, get_comments, get_review_comments).Get details for a pull request with flexible method options (get, get_files, get_status, get_comments, get_review_comments).
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `pull_number` (integer, required) — Pull request number - `method` (string, optional, default: "get" ) — Which PR data to retrieve: get, get_files, get_status, get_comments, get_review_comments - `page` (integer, optional, default: 1 ) — Page number - `per_page` (integer, optional, default: 30 ) — Results per page output data
list_pull_requests — List pull requests in a GitHub repository with filtering and sorting options.List pull requests in a GitHub repository with filtering and sorting options.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `state` (string, optional, default: "open" ) — Filter by state: open, closed, or all - `sort` (string, optional, default: "created" ) — Sort by: created, updated, popularity, or long-running - `direction` (string, optional, default: "desc" ) — Sort direction: asc or desc - `base` (string, optional) — Filter by base branch - `head` (string, optional) — Filter by head branch (user:branch format) - `page` (integer, optional, default: 1 ) — Page number - `per_page` (integer, optional, default: 30 ) — Results per page create_pull_request — Create a new pull request in a GitHub repository.Create a new pull request in a GitHub repository.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `title` (string, required) — Pull request title - `head` (string, required) — Branch containing changes - `base` (string, required) — Branch to merge into - `body` (string, optional) — PR description (optional) - `draft` (boolean, optional, default: false ) — Create as draft PR - `maintainer_can_modify` (boolean, optional, default: true ) — Allow maintainer edits output data
update_pull_request — Updates a pull request's title, body, state, base branch, draft status, maintainer-edit permission, or requested reviewers.Updates a pull request's title, body, state, base branch, draft status, maintainer-edit permission, or requested reviewers. Only the fields you provide are changed — others keep their current value. NOTE: this overwrites the current field values — the original state is not stored after the call. The response includes both the before and after state so you have a full record of what changed.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `pull_number` (integer, required) — Pull request number - `title` (string, optional) — New title (optional) - `body` (string, optional) — New description (optional) - `state` (string, optional) — 'open' or 'closed' (optional) - `base` (string, optional) — New base branch (optional) - `draft` (boolean, optional) — Mark as draft/ready (optional) - `maintainer_can_modify` (boolean, optional) — Allow maintainer edits (optional) - `reviewers` (string[], optional) — Request reviews from users (optional) merge_pull_request — Merges a pull request using the given merge method (merge, squash, or rebase).Merges a pull request using the given merge method (merge, squash, or rebase). This action is irreversible — once merged, the pull request cannot be un-merged; undoing it requires a new commit or pull request.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `pull_number` (integer, required) — Pull request number - `merge_method` (string, optional, default: "merge" ) — 'merge', 'squash', or 'rebase' - `commit_title` (string, optional) — Custom commit title (optional) - `commit_message` (string, optional) — Commit message details (optional) output data
update_pull_request_branch — Update pull request branch with latest changes from base branch.Update pull request branch with latest changes from base branch.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `pull_number` (integer, required) — Pull request number - `expected_head_sha` (string, optional) — Expected HEAD SHA (optional) output data
{ message : string | null ; url : string pull_request_review_write — Write operations on PR reviews: create a review, submit a pending review, delete a pending review, or resolve/unresolve a review thread.Write operations on PR reviews: create a review, submit a pending review, delete a pending review, or resolve/unresolve a review thread. Select the operation via method delete_pending
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `pull_number` (integer, required) — Pull request number - `method` (string, required) — create, submit_pending, delete_pending, resolve_thread, or unresolve_thread - `commit_id` (string, optional) — Commit SHA (required for create) - `body` (string, optional) — Review comment text (optional) - `event` (string, optional) — APPROVE, REQUEST_CHANGES, or COMMENT - `thread_id` (string, optional) — Thread ID for thread operations add_reply_to_pull_request_comment — Add a reply to an existing PR comment.Add a reply to an existing PR comment.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `pull_number` (integer, required) — Pull request number - `comment_id` (integer, required) — ID of the comment to reply to - `body` (string, required) — Reply text output data
request_copilot_review — Request a code review from GitHub Copilot on a pull request.Request a code review from GitHub Copilot on a pull request.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `pull_number` (integer, required) — Pull request number output data
{ pull_number : number | null ; requested : boolean | null ; list_branches — List branches in a GitHub repository.List branches in a GitHub repository.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `page` (integer, optional, default: 1 ) — Page number - `perPage` (integer, optional, default: 30 ) — Items per page output data
{ branches : { name : string | list_commits — List commits in a GitHub repository.List commits in a GitHub repository.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `sha` (string, optional) — Branch or commit SHA - `path` (string, optional) — Filter commits by path - `author` (string, optional) — Filter by author login - `since` (string, optional) — ISO 8601 date: YYYY-MM-DD - `until` (string, optional) — ISO 8601 date: YYYY-MM-DD - `page` (integer, optional, default: 1 ) — Page number - `perPage` (integer, optional, default: 30 ) — Items per page
get_commit — Get details of a specific commit.Get details of a specific commit.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `sha` (string, required) — Commit SHA - `include_diff` (boolean, optional, default: true ) — Include file changes in diff output data
{ sha : string | null ; message : string get_file_contents — Get file or directory contents from a GitHub repository.Get file or directory contents from a GitHub repository.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `path` (string, optional, default: "/" ) — File or directory path - `ref` (string, optional) — Branch, tag, or commit SHA output data
Polymorphic shape covering both directory and single-file responses.
list_tags — List all git tags in a repository with pagination support.List all git tags in a repository with pagination support.
Inputs:
- `owner` (string, required) — Repository owner name. - `repo` (string, required) — Repository name. - `page` (integer, optional, default: 1 ) — Page number. - `perPage` (integer, optional, default: 30 ) — Number of tags per page ( 1-100 ). output data
get_tag — Get detailed information about a specific git tag.Get detailed information about a specific git tag.
Inputs:
- `owner` (string, required) — Repository owner name. - `repo` (string, required) — Repository name. - `tag` (string, required) — Tag name to retrieve. output data
{ ref : string | null ; node_id : string | null ; url get_latest_release — Get the latest release in a repository.Get the latest release in a repository.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name output data
{ id : number | null ; tag_name : string | null ; name : string | null list_releases — List releases in a repository.List releases in a repository.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `page` (integer, optional, default: 1 ) — Page number - `per_page` (integer, optional, default: 30 ) — Results per page output data
{ releases : { id : number | get_release_by_tag — Get a specific release by tag name.Get a specific release by tag name.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `tag` (string, required) — Tag name (e.g., 'v 1.0 . 0 ') output data
Response shape is identical to get_latest_release
get_label — Get a specific label from a repository.Get a specific label from a repository.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `name` (string, required) — Label name output data
{ id : number | null ; name : string | null ; color : string get_me — Get details of the authenticated GitHub user.Get details of the authenticated GitHub user.
Inputs:
This tool takes no parameters.
Output data
{ id : number | null ; login : string | null ; name : string | null ; email : string | null ; bio : string | null ; company get_branch_protection — Get branch protection rules for a specific branch.Get branch protection rules for a specific branch.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `branch` (string, required) — Branch name output data
{ url : string | null ; required_status_checks : object | null ; enforce_admins set_branch_protection — Set (create or replace) branch protection rules for a branch.Set (create or replace) branch protection rules for a branch.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `branch` (string, required) — Branch name - `enforce_admins` (boolean, required) — Enforce for admins - `required_status_checks` (object, optional) — Required status checks config - `required_pull_request_reviews` (object, optional) — Required PR reviews config - `restrictions` (object, optional) — User/team restrictions - `required_linear_history` (boolean, optional, default: false ) — Require linear history - `allow_force_pushes` (boolean, optional) — Allow force pushes - `allow_deletions` (boolean, optional, default: false ) — Allow deletions - `block_creations` (boolean, optional, default: false ) — Block creations - `required_conversation_resolution` (boolean, optional, default: false ) — Require conversation resolution delete_branch_protection — DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING.DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING. Permanently deletes all branch protection rules for the given branch. This action is irreversible — the branch protection configuration (required status checks, required reviews, restrictions, and all other settings) cannot be recovered once deleted. NEVER call this tool autonomously or as part of an automated flow. You MUST stop, tell the user exactly what will be deleted and that it is permanent, and wait for their explicit written confirmation before proceeding.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `branch` (string, required) — Branch name output data
{ deleted : boolean | null get_pull_request_review_protection — Get PR review requirements for a protected branch.Get PR review requirements for a protected branch.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `branch` (string, required) — Branch name output data
{ url : string | null ; dismiss_stale_reviews : boolean | null ; update_pull_request_review_protection — Updates the pull request review requirements for a protected branch.Updates the pull request review requirements for a protected branch. Only the fields you provide are changed — others keep their current value. NOTE: this overwrites the current field values — the original state is not stored after the call. The response includes both the before and after state so you have a full record of what changed.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `branch` (string, required) — Branch name - `dismiss_stale_reviews` (boolean, optional) — Dismiss stale reviews - `require_code_owner_reviews` (boolean, optional) — Require code owner reviews - `required_approving_review_count` (integer, optional) — Required approving reviews - `require_last_push_approval` (boolean, optional) — Require last push approval - `dismissal_restrictions` (object, optional) — Dismissal restrictions output
delete_pull_request_review_protection — DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING.DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING. Permanently removes the pull request review requirements from the given protected branch. This action is irreversible — the review requirement configuration (required approving review count, dismissal restrictions, code owner review requirement, and all other settings) cannot be recovered once deleted. NEVER call this tool autonomously or as part of an automated flow. You MUST stop, tell the user exactly what will be deleted and that it is permanent, and wait for their explicit written confirmation before proceeding.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `branch` (string, required) — Branch name output data
list_repository_rulesets — List all rulesets for a repository.List all rulesets for a repository.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `includes_parents` (boolean, optional, default: true ) — Include parent rulesets - `per_page` (integer, optional, default: 30 ) — Results per page - `page` (integer, optional, default: 1 ) — Page number output data
get_repository_ruleset — Get a specific ruleset for a repository.Get a specific ruleset for a repository.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `ruleset_id` (integer, required) — Ruleset ID output data
{ id : number | null ; name : string | null ; target create_repository_ruleset — Create a new ruleset for a repository.Create a new ruleset for a repository.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `name` (string, required) — Ruleset name - `enforcement` (string, required) — active, evaluate, or disabled - `target` (string, optional, default: "branch" ) — Target: branch, tag, or push - `conditions` (object, optional) — Ruleset conditions - `rules` (object[], optional) — Rules list - `bypass_actors` (object[], optional) — Bypass actors output data
update_repository_ruleset — Updates an existing repository ruleset.Updates an existing repository ruleset. Only the fields you provide are changed — others keep their current value. NOTE: this overwrites the current field values — the original state is not stored after the call. The response includes both the before and after state so you have a full record of what changed.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `ruleset_id` (integer, required) — Ruleset ID - `name` (string, optional) — New ruleset name - `enforcement` (string, optional) — active, evaluate, or disabled - `target` (string, optional) — Updated target: branch, tag, or push - `conditions` (object, optional) — Updated conditions - `rules` (object[], optional) — Updated rules - `bypass_actors` (object[], optional) — Updated bypass actors output
delete_repository_ruleset — DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING.DESTRUCTIVE — REQUIRES EXPLICIT USER CONFIRMATION BEFORE CALLING. Permanently deletes the specified ruleset from the repository. This action is irreversible — the ruleset configuration (conditions, rules, and bypass actors) cannot be recovered once deleted. NEVER call this tool autonomously or as part of an automated flow. You MUST stop, tell the user exactly what will be deleted and that it is permanent, and wait for their explicit written confirmation before proceeding.
Inputs:
- `owner` (string, required) — Repository owner - `repo` (string, required) — Repository name - `ruleset_id` (integer, required) — Ruleset ID output data
{ deleted : boolean | null ; API Parameters Reference
Response Envelope Every tool returns the same top-level envelope. Only data
// Success { "success" : true , "statusCode" : 200 , "retriable" : false , "retry_after_seconds" : null , "error" : null , "data" : { ... } }
// Error Common Parameters
owner repo owner page perPage per_page Troubleshooting
Missing or Invalid Headers
Cause: API key not provided in request headers or incorrect formatSolution:
Verify Authorization: Bearer YOUR_API_KEY X-Mewcp-Credential-Id: CREDENTIAL-ID
Check API key is active in your MewCP account
Insufficient Credits
Cause: API calls have exceeded your request limitsSolution:
Check credit usage in your Curious Layer dashboard
Upgrade to a paid plan or add credits for higher limits
Contact support for credit adjustments
Credential Not Connected
Cause: No GitHub credential linked to your accountSolution:
Go to Credentials in your MewCP dashboard
Connect your GitHub account (OAuth) or add your API key (static)
Retry the request with the correct X-Mewcp-Credential-Id
Malformed Request Payload
Cause: JSON payload is invalid or missing required fieldsSolution:
Validate JSON syntax before sending
Ensure all required tool parameters are included
Check parameter types match expected values
Server Not Found
Cause: Incorrect server name in the API endpointSolution:
Verify endpoint format: { server-name }/mcp/{ tool-name }
Use correct server name from documentation
Check available servers in your Curious Layer account
GitHub API Error
Cause: Upstream GitHub API returned an errorSolution:
Check GitHub service status at GitHub Status Page
Verify your credential has the required permissions (OAuth scopes)
Review the error message for specific details
|
null
;
url : string | null ;
default_branch : string | null ;
created_at : string | null ;
updated_at : string | null ;
stargazers_count : number | null ;
language : string | null ;
has_issues : boolean | null ;
has_downloads : boolean | null ;
forks_count : number | null ;
}
{
before : {
id : number | null ;
name : string | null ;
full_name : string | null ;
owner : object | null ;
html_url : string | null ;
description : string | null ;
private : boolean | null ;
fork : boolean | null ;
url : string | null ;
default_branch : string | null ;
created_at : string | null ;
updated_at : string | null ;
stargazers_count : number | null ;
language : string | null ;
has_issues : boolean | null ;
has_downloads : boolean | null ;
forks_count : number | null ;
};
after : {
id : number | null ;
name : string | null ;
full_name : string | null ;
html_url : string | null ;
private : boolean | null ;
description : string | null ;
default_branch : string | null ;
};
}
{ id : number | null ; name : string | null ; full_name : string | null ; url : string | null ; html_url : string | null ; owner : object | null ; private : boolean | null ; created_at : string | null ; } full_name : string | null ;
url : string | null ;
html_url : string | null ;
owner : object | null ;
fork : boolean | null ;
}
{ content : object | null ; commit : object | null ; }
data
{ commit_sha : string | null ; tree_sha : string | null ; branch : string | null ; message : string | null ; url : string | null ; } {
items : {
id : number | null ;
name : string | null ;
full_name : string | null ;
private : boolean | null ;
html_url : string | null ;
description : string | null ;
stars : number | null ;
}[];
total_count : number;
}
{ total_count : number; incomplete_results : boolean; items : { name : string | null ; path : string | null ; repository : string | null ; url : string | null ; }[]; } { total_count : number; incomplete_results : boolean; items : { login : string | null ; id : number | null ; profile_url : string | null ; avatar_url : string | null ; }[]; } data
{ total_count : number; incomplete_results : boolean; items : { number : number | null ; title : string | null ; state : string | null ; body : string | null ; url : string | null ; comments : number | null ; user : string | null ; }[]; } data
{ total_count : number; incomplete_results : boolean; pull_requests : { number : number | null ; title : string | null ; state : string | null ; url : string | null ; user : string | null ; created_at : string | null ; updated_at : string | null ; comments : number | null ; }[]; page : number | null ; per_page : number | null ; } { issues : { number : number | null ; title : string | null ; state : string | null ; url : string | null ; body : string | null ; user : string | null ; labels : string[]; created_at : string | null ; updated_at : string | null ; }[]; count : number; }
: string
|
null
;
state : string | null ;
state_reason : string | null ;
labels : string[];
assignees : string[];
url : string | null ;
user : string | null ;
created_at : string | null ;
updated_at : string | null ;
closed_at : string | null ;
}
{
comments : {
id : number | null ;
body : string | null ;
url : string | null ;
user : string | null ;
created_at : string | null ;
updated_at : string | null ;
}[];
page : number | null ;
per_page : number | null ;
}
{
id : number | null ;
number : number | null ;
url : string | null ;
title : string | null ;
}
null
;
body : string | null ;
user : string | null ;
}
{ before : { number : number | null ; title : string | null ; body : string | null ; state : string | null ; state_reason : string | null ; labels : string[]; assignees : string[]; url : string | null ; user : string | null ; created_at : string | null ; updated_at : string | null ; closed_at : string | null ; }; after : { id : number | null ; number : number | null ; url : string | null ; title : string | null ; state : string | null ; }; } : string
|
null
;
repo_type_filter : string | null ;
total_repos_with_filtered_contributors : number;
repos : {
repo : string | null ;
full_name : string | null ;
url : string | null ;
private : boolean | null ;
description : string | null ;
contributors : {
username : string | null ;
contributions : number;
}[];
total_filtered_contributions : number;
}[];
}
{ method : string | null ; sub_issue_id : number | null ; success : boolean | null ; message : string | null ; } ;
assigned : boolean | null ;
job_id : number | null ;
status : string | null ;
pull_request_url : string | null ;
}
Polymorphic shape covering all 5 method null
{ // method="get" number : number | null ; title : string | null ; body : string | null ; state : string | null ; state_reason : string | null ; url : string | null ; user : string | null ; created_at : string | null ; updated_at : string | null ; merged_at : string | null ; merged : boolean | null ; merge_commit_sha : string | null ; head : object | null ; base : object | null ; draft : boolean | null ; additions : number | null ; deletions : number | null ; changed_files : number | null ; commits : number | null ; labels : string[] | null ; assignees : string[] | null ; reviewers : string[] | null ;
// method="get_files" files : object[] | null ; total_files : number | null ;
// method="get_status" sha : string | null ; total_count : number | null ; statuses : object[] | null ;
// method="get_comments" comments : object[] | null ; total_comments : number | null ;
// method="get_review_comments" review_comments : object[] | null ; total_review_comments : number | null ;
// pagination (get_files / get_comments / get_review_comments) page : number | null ; per_page : number | null ; } { pull_requests : { number : number | null ; title : string | null ; state : string | null ; url : string | null ; user : string | null ; created_at : string | null ; updated_at : string | null ; draft : boolean | null ; additions : number | null ; deletions : number | null ; changed_files : number | null ; }[]; total_count : number; page : number | null ; per_page : number | null ; } { number : number | null ; title : string | null ; state : string | null ; draft : boolean | null ; url : string | null ; head_branch : string | null ; base_branch : string | null ; created_at : string | null ; user : string | null ; } { before : { number : number | null ; title : string | null ; body : string | null ; state : string | null ; state_reason : string | null ; url : string | null ; user : string | null ; created_at : string | null ; updated_at : string | null ; merged_at : string | null ; merged : boolean | null ; merge_commit_sha : string | null ; head : object | null ; base : object | null ; draft : boolean | null ; additions : number | null ; deletions : number | null ; changed_files : number | null ; commits : number | null ; labels : string[] | null ; assignees : string[] | null ; reviewers : string[] | null ; files : object[] | null ; total_files : number | null ; sha : string | null ; total_count : number | null ; statuses : object[] | null ; comments : object[] | null ; total_comments : number | null ; review_comments : object[] | null ; total_review_comments : number | null ; page : number | null ; per_page : number | null ; }; after : { number : number | null ; title : string | null ; state : string | null ; draft : boolean | null ; url : string | null ; updated_at : string | null ; }; } { merged : boolean | null ; sha : string | null ; message : string | null ; }
|
null
;
}
Polymorphic shape covering all method
{ // method="create" id : number | null ; node_id : string | null ; state : string | null ; body : string | null ; user : string | null ; submitted_at : string | null ;
// method="delete_pending" deleted : boolean | null ; review_id : number | null ;
// method="resolve_thread" / "unresolve_thread" thread_id : string | null ; resolved : boolean | null ; message : string | null ; } user
: string
|
null
;
body : string | null ;
created_at : string | null ;
url : string | null ;
in_reply_to_id : number | null ;
}
reviewer : string | null ;
status : string | null ;
}
null
;
sha : string | null ;
protected : boolean;
}[];
}
output data
{ commits : { sha : string | null ; message : string | null ; author : object | null ; committer : object | null ; date : string | null ; }[]; } |
null
;
author : object | null ;
committer : object | null ;
date : string | null ;
url : string | null ;
files : object[] | null ;
}
;
// directory listing
items : object[] | null ;
// single file
name : string | null ;
path : string | null ;
size : number | null ;
url : string | null ;
content : string | null ;
encoding : string | null ;
}
name : string | null ;
commit : object | null ;
zipball_url : string | null ;
tarball_url : string | null ;
}[];
page : number | null ;
per_page : number | null ;
}
: string
|
null
;
object : object | null ;
}
;
draft : boolean | null ;
prerelease : boolean | null ;
created_at : string | null ;
published_at : string | null ;
url : string | null ;
body : string | null ;
author : string | null ;
}
null
;
tag_name : string | null ;
name : string | null ;
draft : boolean | null ;
prerelease : boolean | null ;
created_at : string | null ;
published_at : string | null ;
url : string | null ;
author : string | null ;
}[];
total_count : number;
page : number | null ;
per_page : number | null ;
}
null
;
tag_name : string | null ;
name : string | null ;
draft : boolean | null ;
prerelease : boolean | null ;
created_at : string | null ;
published_at : string | null ;
url : string | null ;
body : string | null ;
author : string | null ;
}
|
null
;
description : string | null ;
url : string | null ;
}
: string
|
null
;
location : string | null ;
public_repos : number;
followers : number;
following : number;
created_at : string | null ;
updated_at : string | null ;
avatar_url : string | null ;
profile_url : string | null ;
}
: boolean
|
null
;
required_pull_request_reviews : object | null ;
restrictions : object | null ;
required_linear_history : boolean | null ;
allow_force_pushes : boolean | null ;
allow_deletions : boolean | null ;
block_creations : boolean | null ;
required_conversation_resolution : boolean | null ;
required_signatures : boolean | null ;
lock_branch : boolean | null ;
allow_fork_syncing : boolean | null ;
}
- `lock_branch` (boolean, optional, default: false ) — Lock branch
- `allow_fork_syncing` (boolean, optional, default: false ) — Allow fork syncing
{ url : string | null ; branch : string | null ; enforce_admins : boolean | null ; required_linear_history : boolean | null ; allow_force_pushes : boolean | null ; allow_deletions : boolean | null ; required_conversation_resolution : boolean | null ; lock_branch : boolean | null ; } ;
branch : string | null ;
}
require_code_owner_reviews
: boolean
|
null
;
required_approving_review_count : number | null ;
require_last_push_approval : boolean | null ;
dismissal_restrictions : object | null ;
}
data
{ before : { url : string | null ; dismiss_stale_reviews : boolean | null ; require_code_owner_reviews : boolean | null ; required_approving_review_count : number | null ; require_last_push_approval : boolean | null ; dismissal_restrictions : object | null ; }; after : { url : string | null ; dismiss_stale_reviews : boolean | null ; require_code_owner_reviews : boolean | null ; required_approving_review_count : number | null ; require_last_push_approval : boolean | null ; dismissal_restrictions : object | null ; }; } null
;
branch : string | null ;
}
rulesets : {
id : number | null ;
name : string | null ;
target : string | null ;
source_type : string | null ;
enforcement : string | null ;
node_id : string | null ;
created_at : string | null ;
updated_at : string | null ;
}[];
page : number | null ;
per_page : number | null ;
}
: string
|
null
;
source_type : string | null ;
source : string | null ;
enforcement : string | null ;
conditions : object | null ;
rules : object[];
bypass_actors : object[];
node_id : string | null ;
created_at : string | null ;
updated_at : string | null ;
}
{ id : number | null ; name : string | null ; target : string | null ; enforcement : string | null ; conditions : object | null ; rules : object[]; bypass_actors : object[]; node_id : string | null ; created_at : string | null ; updated_at : string | null ; }
data
{ before : { id : number | null ; name : string | null ; target : string | null ; source_type : string | null ; source : string | null ; enforcement : string | null ; conditions : object | null ; rules : object[]; bypass_actors : object[]; node_id : string | null ; created_at : string | null ; updated_at : string | null ; }; after : { id : number | null ; name : string | null ; target : string | null ; enforcement : string | null ; conditions : object | null ; rules : object[]; bypass_actors : object[]; node_id : string | null ; created_at : string | null ; updated_at : string | null ; }; } ruleset_id : number | null ;
}
{
"success" : false ,
"statusCode" : 400 ,
"retriable" : false ,
"retry_after_seconds" : null ,
"error" : { "code" : "{ERROR_CODE}" , "message" : "{description}" , "details" : {} },
"data" : null
}
retriable true false retry_after_seconds retriable true error.code VALIDATION_ERROR AUTH_ERROR UPSTREAM_ERROR SERVER_ERROR 
