@apteva/integrations 0.2.3 → 0.3.1

package/src/apps/github.json

@@ -1,105 +1,1537 @@
 {
   "slug": "github",
   "name": "GitHub",
-  "description": "Code hosting, issues, pull requests, and repository management",
+  "description": "GitHub REST API - repos, issues, PRs, code, branches, commits, releases, actions, users, and search via OAuth2",
   "logo": "https://github.githubassets.com/favicons/favicon.svg",
-  "categories": ["developer-tools", "version-control"],
+  "categories": [
+    "development",
+    "git",
+    "code",
+    "collaboration",
+    "github",
+    "oauth2"
+  ],
   "base_url": "https://api.github.com",
   "auth": {
-    "types": ["bearer", "oauth2"],
-    "headers": { "Authorization": "Bearer {{token}}", "Accept": "application/vnd.github+json" },
+    "types": [
+      "bearer",
+      "oauth2"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "access_token"
+      }
+    ],
     "oauth2": {
       "authorize_url": "https://github.com/login/oauth/authorize",
       "token_url": "https://github.com/login/oauth/access_token",
-      "scopes": ["repo", "read:user", "read:org"],
+      "scopes": [
+        "repo",
+        "repo:status",
+        "repo_deployment",
+        "public_repo",
+        "repo:invite",
+        "security_events",
+        "admin:repo_hook",
+        "write:repo_hook",
+        "read:repo_hook",
+        "admin:org",
+        "write:org",
+        "read:org",
+        "admin:public_key",
+        "write:public_key",
+        "read:public_key",
+        "admin:org_hook",
+        "gist",
+        "notifications",
+        "user",
+        "read:user",
+        "user:email",
+        "user:follow",
+        "project",
+        "read:project",
+        "delete_repo",
+        "write:packages",
+        "read:packages",
+        "delete:packages",
+        "admin:gpg_key",
+        "write:gpg_key",
+        "read:gpg_key",
+        "codespace",
+        "workflow"
+      ],
       "client_id_required": true,
-      "pkce": false,
-      "setup_url": "https://github.com/settings/developers",
-      "setup_steps": [
-        "Go to GitHub Settings > Developer settings > OAuth Apps",
-        "Click 'New OAuth App'",
-        "Set the callback URL to your Apteva instance: {callback_url}",
-        "Copy the Client ID and generate a Client Secret"
-      ]
-    },
-    "credential_fields": [
-      { "name": "token", "label": "Personal Access Token", "description": "GitHub PAT with repo and user scopes (Settings > Developer settings > Tokens)" }
-    ]
+      "pkce": false
+    }
   },
   "tools": [
+    {
+      "name": "get_authenticated_user",
+      "description": "Get the authenticated user's profile including login, name, email, bio, public repos count, followers, and account details",
+      "method": "GET",
+      "path": "/user",
+      "input_schema": {
+        "type": "object",
+        "properties": {}
+      }
+    },
+    {
+      "name": "get_user",
+      "description": "Get a user's public profile by their username",
+      "method": "GET",
+      "path": "/users/%7B%7Busername%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "username": {
+            "type": "string",
+            "description": "GitHub username"
+          }
+        },
+        "required": [
+          "username"
+        ]
+      }
+    },
     {
       "name": "list_repos",
-      "description": "List repositories for the authenticated user",
+      "description": "List repositories for the authenticated user. Returns repos you own, collaborate on, or are a member of.",
       "method": "GET",
       "path": "/user/repos",
       "input_schema": {
         "type": "object",
         "properties": {
-          "sort": { "type": "string", "enum": ["created", "updated", "pushed", "full_name"], "description": "Sort field" },
-          "per_page": { "type": "number", "description": "Results per page (max 100)", "default": 30 }
+          "type": {
+            "type": "string",
+            "description": "Type of repos to list",
+            "enum": [
+              "all",
+              "owner",
+              "public",
+              "private",
+              "member"
+            ],
+            "default": "all"
+          },
+          "sort": {
+            "type": "string",
+            "description": "Sort field",
+            "enum": [
+              "created",
+              "updated",
+              "pushed",
+              "full_name"
+            ],
+            "default": "updated"
+          },
+          "direction": {
+            "type": "string",
+            "description": "Sort direction",
+            "enum": [
+              "asc",
+              "desc"
+            ],
+            "default": "desc"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
         }
       }
     },
     {
       "name": "get_repo",
-      "description": "Get a repository by owner and name",
+      "description": "Get detailed information about a repository including description, stars, forks, language, default branch, and permissions",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner (user or org)"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          }
+        },
+        "required": [
+          "owner",
+          "repo"
+        ]
+      }
+    },
+    {
+      "name": "list_user_repos",
+      "description": "List public repositories for a specific user",
+      "method": "GET",
+      "path": "/users/%7B%7Busername%7D%7D/repos",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "username": {
+            "type": "string",
+            "description": "GitHub username"
+          },
+          "sort": {
+            "type": "string",
+            "description": "Sort field",
+            "enum": [
+              "created",
+              "updated",
+              "pushed",
+              "full_name"
+            ],
+            "default": "updated"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "username"
+        ]
+      }
+    },
+    {
+      "name": "search_repos",
+      "description": "Search for repositories using GitHub search syntax. Supports qualifiers like language:, stars:>, topic:, etc.",
+      "method": "GET",
+      "path": "/search/repositories",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "q": {
+            "type": "string",
+            "description": "Search query (supports qualifiers like language:python, stars:>100, topic:machine-learning)"
+          },
+          "sort": {
+            "type": "string",
+            "description": "Sort field",
+            "enum": [
+              "stars",
+              "forks",
+              "help-wanted-issues",
+              "updated"
+            ],
+            "default": "stars"
+          },
+          "order": {
+            "type": "string",
+            "description": "Sort order",
+            "enum": [
+              "asc",
+              "desc"
+            ],
+            "default": "desc"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "q"
+        ]
+      }
+    },
+    {
+      "name": "search_code",
+      "description": "Search for code across all repositories. Supports qualifiers like repo:, path:, language:, extension:",
       "method": "GET",
-      "path": "/repos/{owner}/{repo}",
+      "path": "/search/code",
       "input_schema": {
         "type": "object",
         "properties": {
-          "owner": { "type": "string", "description": "Repository owner" },
-          "repo": { "type": "string", "description": "Repository name" }
+          "q": {
+            "type": "string",
+            "description": "Search query (e.g., 'addClass repo:jquery/jquery', 'filename:config.yml language:yaml')"
+          },
+          "sort": {
+            "type": "string",
+            "description": "Sort field (only 'indexed' supported)",
+            "enum": [
+              "indexed"
+            ]
+          },
+          "order": {
+            "type": "string",
+            "description": "Sort order",
+            "enum": [
+              "asc",
+              "desc"
+            ],
+            "default": "desc"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
         },
-        "required": ["owner", "repo"]
+        "required": [
+          "q"
+        ]
+      }
+    },
+    {
+      "name": "get_contents",
+      "description": "Get repository contents — a file (with content) or directory listing. For files up to 1MB, content is base64 encoded.",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/contents/%7B%7Bpath%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "path": {
+            "type": "string",
+            "description": "Path to file or directory (empty string for repo root)",
+            "default": ""
+          },
+          "ref": {
+            "type": "string",
+            "description": "Branch, tag, or commit SHA (defaults to default branch)"
+          }
+        },
+        "required": [
+          "owner",
+          "repo"
+        ]
+      }
+    },
+    {
+      "name": "create_or_update_file",
+      "description": "Create or update a file in a repository. Content must be base64 encoded. To update, include the SHA of the file being replaced (from get-contents).",
+      "method": "PUT",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/contents/%7B%7Bpath%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "path": {
+            "type": "string",
+            "description": "Path for the file"
+          },
+          "message": {
+            "type": "string",
+            "description": "Commit message"
+          },
+          "content": {
+            "type": "string",
+            "description": "File content (base64 encoded)"
+          },
+          "sha": {
+            "type": "string",
+            "description": "SHA of file being replaced (required for updates, get from get-contents)"
+          },
+          "branch": {
+            "type": "string",
+            "description": "Branch to commit to (defaults to default branch)"
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "path",
+          "message",
+          "content"
+        ]
+      }
+    },
+    {
+      "name": "delete_file",
+      "description": "Delete a file from a repository. Requires the file's SHA (from get-contents).",
+      "method": "DELETE",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/contents/%7B%7Bpath%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "path": {
+            "type": "string",
+            "description": "Path to the file to delete"
+          },
+          "message": {
+            "type": "string",
+            "description": "Commit message"
+          },
+          "sha": {
+            "type": "string",
+            "description": "SHA of file being deleted (from get-contents)"
+          },
+          "branch": {
+            "type": "string",
+            "description": "Branch to commit to"
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "path",
+          "message",
+          "sha"
+        ]
+      }
+    },
+    {
+      "name": "list_branches",
+      "description": "List branches in a repository",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/branches",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "owner",
+          "repo"
+        ]
+      }
+    },
+    {
+      "name": "create_branch",
+      "description": "Create a new branch. First get the SHA of the source branch via list-branches or get-contents, then create a git ref.",
+      "method": "POST",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/git/refs",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "ref": {
+            "type": "string",
+            "description": "Full git ref to create (e.g., refs/heads/my-new-branch)"
+          },
+          "sha": {
+            "type": "string",
+            "description": "SHA of the commit to branch from"
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "ref",
+          "sha"
+        ]
+      }
+    },
+    {
+      "name": "list_commits",
+      "description": "List commits in a repository. Can filter by branch, path, author, and date range.",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/commits",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "sha": {
+            "type": "string",
+            "description": "Branch name or commit SHA to start from"
+          },
+          "path": {
+            "type": "string",
+            "description": "Only commits containing this file path"
+          },
+          "author": {
+            "type": "string",
+            "description": "GitHub username or email to filter by"
+          },
+          "since": {
+            "type": "string",
+            "description": "ISO 8601 date — only commits after this date"
+          },
+          "until": {
+            "type": "string",
+            "description": "ISO 8601 date — only commits before this date"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "owner",
+          "repo"
+        ]
       }
     },
     {
       "name": "list_issues",
-      "description": "List issues for a repository",
+      "description": "List issues in a repository. Filter by state, labels, assignee, milestone, and more.",
       "method": "GET",
-      "path": "/repos/{owner}/{repo}/issues",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/issues",
       "input_schema": {
         "type": "object",
         "properties": {
-          "owner": { "type": "string", "description": "Repository owner" },
-          "repo": { "type": "string", "description": "Repository name" },
-          "state": { "type": "string", "enum": ["open", "closed", "all"], "default": "open" },
-          "per_page": { "type": "number", "default": 30 }
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "state": {
+            "type": "string",
+            "description": "Issue state filter",
+            "enum": [
+              "open",
+              "closed",
+              "all"
+            ],
+            "default": "open"
+          },
+          "labels": {
+            "type": "string",
+            "description": "Comma-separated label names"
+          },
+          "assignee": {
+            "type": "string",
+            "description": "Filter by assignee username (use * for any, none for unassigned)"
+          },
+          "sort": {
+            "type": "string",
+            "description": "Sort field",
+            "enum": [
+              "created",
+              "updated",
+              "comments"
+            ],
+            "default": "created"
+          },
+          "direction": {
+            "type": "string",
+            "description": "Sort direction",
+            "enum": [
+              "asc",
+              "desc"
+            ],
+            "default": "desc"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
         },
-        "required": ["owner", "repo"]
+        "required": [
+          "owner",
+          "repo"
+        ]
+      }
+    },
+    {
+      "name": "get_issue",
+      "description": "Get a specific issue by number with full details including body, labels, assignees, and milestone",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/issues/%7B%7Bissue_number%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "issue_number": {
+            "type": "integer",
+            "description": "Issue number"
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "issue_number"
+        ]
       }
     },
     {
       "name": "create_issue",
-      "description": "Create an issue in a repository",
+      "description": "Create a new issue in a repository with title, body, labels, and assignees",
+      "method": "POST",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/issues",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "title": {
+            "type": "string",
+            "description": "Issue title"
+          },
+          "body": {
+            "type": "string",
+            "description": "Issue body (supports markdown)"
+          },
+          "labels": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Label names to apply"
+          },
+          "assignees": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Usernames to assign"
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "title"
+        ]
+      }
+    },
+    {
+      "name": "update_issue",
+      "description": "Update an issue — change title, body, state, labels, or assignees",
+      "method": "PATCH",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/issues/%7B%7Bissue_number%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "issue_number": {
+            "type": "integer",
+            "description": "Issue number"
+          },
+          "title": {
+            "type": "string",
+            "description": "New title"
+          },
+          "body": {
+            "type": "string",
+            "description": "New body (markdown)"
+          },
+          "state": {
+            "type": "string",
+            "description": "Issue state",
+            "enum": [
+              "open",
+              "closed"
+            ]
+          },
+          "labels": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Labels to set (replaces all existing labels)"
+          },
+          "assignees": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Assignees to set (replaces all existing)"
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "issue_number"
+        ]
+      }
+    },
+    {
+      "name": "list_issue_comments",
+      "description": "List comments on an issue or pull request",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/issues/%7B%7Bissue_number%7D%7D/comments",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "issue_number": {
+            "type": "integer",
+            "description": "Issue or PR number"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "issue_number"
+        ]
+      }
+    },
+    {
+      "name": "add_issue_comment",
+      "description": "Add a comment to an issue or pull request",
+      "method": "POST",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/issues/%7B%7Bissue_number%7D%7D/comments",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "issue_number": {
+            "type": "integer",
+            "description": "Issue or PR number"
+          },
+          "body": {
+            "type": "string",
+            "description": "Comment text (supports markdown)"
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "issue_number",
+          "body"
+        ]
+      }
+    },
+    {
+      "name": "search_issues",
+      "description": "Search issues and pull requests across all repos. Supports qualifiers like repo:, is:pr, is:issue, label:, author:, state:",
+      "method": "GET",
+      "path": "/search/issues",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "q": {
+            "type": "string",
+            "description": "Search query (e.g., 'bug label:bug is:open repo:owner/repo', 'is:pr author:username')"
+          },
+          "sort": {
+            "type": "string",
+            "description": "Sort field",
+            "enum": [
+              "comments",
+              "reactions",
+              "reactions-+1",
+              "reactions--1",
+              "reactions-smile",
+              "reactions-thinking_face",
+              "reactions-heart",
+              "reactions-tada",
+              "interactions",
+              "created",
+              "updated"
+            ],
+            "default": "created"
+          },
+          "order": {
+            "type": "string",
+            "description": "Sort order",
+            "enum": [
+              "asc",
+              "desc"
+            ],
+            "default": "desc"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "q"
+        ]
+      }
+    },
+    {
+      "name": "list_pulls",
+      "description": "List pull requests in a repository with state, branch, and sort filters",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/pulls",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "state": {
+            "type": "string",
+            "description": "PR state filter",
+            "enum": [
+              "open",
+              "closed",
+              "all"
+            ],
+            "default": "open"
+          },
+          "head": {
+            "type": "string",
+            "description": "Filter by head branch (format: user:branch)"
+          },
+          "base": {
+            "type": "string",
+            "description": "Filter by base branch"
+          },
+          "sort": {
+            "type": "string",
+            "description": "Sort field",
+            "enum": [
+              "created",
+              "updated",
+              "popularity",
+              "long-running"
+            ],
+            "default": "created"
+          },
+          "direction": {
+            "type": "string",
+            "description": "Sort direction",
+            "enum": [
+              "asc",
+              "desc"
+            ],
+            "default": "desc"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "owner",
+          "repo"
+        ]
+      }
+    },
+    {
+      "name": "get_pull",
+      "description": "Get a specific pull request with full details including diff stats, mergeable status, and review status",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/pulls/%7B%7Bpull_number%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "pull_number": {
+            "type": "integer",
+            "description": "Pull request number"
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "pull_number"
+        ]
+      }
+    },
+    {
+      "name": "create_pull",
+      "description": "Create a new pull request from a head branch into a base branch",
+      "method": "POST",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/pulls",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "title": {
+            "type": "string",
+            "description": "PR title"
+          },
+          "head": {
+            "type": "string",
+            "description": "Branch containing changes (e.g., 'feature-branch' or 'user:feature-branch' for cross-repo)"
+          },
+          "base": {
+            "type": "string",
+            "description": "Branch to merge into (e.g., 'main')"
+          },
+          "body": {
+            "type": "string",
+            "description": "PR description (supports markdown)"
+          },
+          "draft": {
+            "type": "boolean",
+            "description": "Create as draft PR",
+            "default": false
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "title",
+          "head",
+          "base"
+        ]
+      }
+    },
+    {
+      "name": "merge_pull",
+      "description": "Merge a pull request. Choose merge method: merge commit, squash, or rebase.",
+      "method": "PUT",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/pulls/%7B%7Bpull_number%7D%7D/merge",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "pull_number": {
+            "type": "integer",
+            "description": "Pull request number"
+          },
+          "commit_title": {
+            "type": "string",
+            "description": "Title for the merge commit"
+          },
+          "commit_message": {
+            "type": "string",
+            "description": "Extra detail for the merge commit"
+          },
+          "merge_method": {
+            "type": "string",
+            "description": "Merge method to use",
+            "enum": [
+              "merge",
+              "squash",
+              "rebase"
+            ],
+            "default": "merge"
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "pull_number"
+        ]
+      }
+    },
+    {
+      "name": "list_pull_files",
+      "description": "List files changed in a pull request with patch/diff details",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/pulls/%7B%7Bpull_number%7D%7D/files",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "pull_number": {
+            "type": "integer",
+            "description": "Pull request number"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "pull_number"
+        ]
+      }
+    },
+    {
+      "name": "list_releases",
+      "description": "List releases in a repository, ordered by creation date",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/releases",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "owner",
+          "repo"
+        ]
+      }
+    },
+    {
+      "name": "create_release",
+      "description": "Create a new release with a tag, name, and release notes",
       "method": "POST",
-      "path": "/repos/{owner}/{repo}/issues",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/releases",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "tag_name": {
+            "type": "string",
+            "description": "Tag name for the release (e.g., v1.0.0)"
+          },
+          "name": {
+            "type": "string",
+            "description": "Release title"
+          },
+          "body": {
+            "type": "string",
+            "description": "Release notes (supports markdown)"
+          },
+          "target_commitish": {
+            "type": "string",
+            "description": "Branch or commit SHA to tag (defaults to default branch)"
+          },
+          "draft": {
+            "type": "boolean",
+            "description": "Create as draft release",
+            "default": false
+          },
+          "prerelease": {
+            "type": "boolean",
+            "description": "Mark as pre-release",
+            "default": false
+          },
+          "generate_release_notes": {
+            "type": "boolean",
+            "description": "Auto-generate release notes from commits",
+            "default": false
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "tag_name"
+        ]
+      }
+    },
+    {
+      "name": "list_workflows",
+      "description": "List GitHub Actions workflows in a repository",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/actions/workflows",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "owner",
+          "repo"
+        ]
+      }
+    },
+    {
+      "name": "list_workflow_runs",
+      "description": "List recent runs for a specific workflow",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/actions/workflows/%7B%7Bworkflow_id%7D%7D/runs",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "workflow_id": {
+            "type": "string",
+            "description": "Workflow ID or filename (e.g., 'main.yml')"
+          },
+          "status": {
+            "type": "string",
+            "description": "Filter by status",
+            "enum": [
+              "completed",
+              "action_required",
+              "cancelled",
+              "failure",
+              "neutral",
+              "skipped",
+              "stale",
+              "success",
+              "timed_out",
+              "in_progress",
+              "queued",
+              "requested",
+              "waiting",
+              "pending"
+            ]
+          },
+          "branch": {
+            "type": "string",
+            "description": "Filter by branch"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "workflow_id"
+        ]
+      }
+    },
+    {
+      "name": "trigger_workflow",
+      "description": "Manually trigger a workflow_dispatch workflow run",
+      "method": "POST",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/actions/workflows/%7B%7Bworkflow_id%7D%7D/dispatches",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "workflow_id": {
+            "type": "string",
+            "description": "Workflow ID or filename (e.g., 'deploy.yml')"
+          },
+          "ref": {
+            "type": "string",
+            "description": "Branch or tag to run the workflow on"
+          },
+          "inputs": {
+            "type": "object",
+            "description": "Input parameters for the workflow (key-value pairs)"
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "workflow_id",
+          "ref"
+        ]
+      }
+    },
+    {
+      "name": "create_webhook",
+      "description": "Create a repository webhook to receive event notifications",
+      "method": "POST",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/hooks",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "config": {
+            "type": "object",
+            "description": "Webhook configuration",
+            "properties": {
+              "url": {
+                "type": "string",
+                "description": "Payload URL"
+              },
+              "content_type": {
+                "type": "string",
+                "description": "Content type (json or form)",
+                "enum": [
+                  "json",
+                  "form"
+                ],
+                "default": "json"
+              },
+              "secret": {
+                "type": "string",
+                "description": "Webhook secret for payload signing"
+              }
+            },
+            "required": [
+              "url"
+            ]
+          },
+          "events": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Events to subscribe to (e.g., push, pull_request, issues). Use ['*'] for all.",
+            "default": [
+              "push"
+            ]
+          },
+          "active": {
+            "type": "boolean",
+            "description": "Whether the webhook is active",
+            "default": true
+          }
+        },
+        "required": [
+          "owner",
+          "repo",
+          "config"
+        ]
+      }
+    },
+    {
+      "name": "list_webhooks",
+      "description": "List webhooks configured for a repository",
+      "method": "GET",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/hooks",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
+        },
+        "required": [
+          "owner",
+          "repo"
+        ]
+      }
+    },
+    {
+      "name": "fork_repo",
+      "description": "Fork a repository to the authenticated user's account or a specified organization",
+      "method": "POST",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/forks",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner to fork from"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name to fork"
+          },
+          "organization": {
+            "type": "string",
+            "description": "Organization to fork into (omit to fork to your account)"
+          },
+          "name": {
+            "type": "string",
+            "description": "Custom name for the fork (defaults to original name)"
+          }
+        },
+        "required": [
+          "owner",
+          "repo"
+        ]
+      }
+    },
+    {
+      "name": "star_repo",
+      "description": "Star a repository for the authenticated user",
+      "method": "PUT",
+      "path": "/user/starred/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          }
+        },
+        "required": [
+          "owner",
+          "repo"
+        ]
+      }
+    },
+    {
+      "name": "unstar_repo",
+      "description": "Remove a star from a repository",
+      "method": "DELETE",
+      "path": "/user/starred/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D",
       "input_schema": {
         "type": "object",
         "properties": {
-          "owner": { "type": "string", "description": "Repository owner" },
-          "repo": { "type": "string", "description": "Repository name" },
-          "title": { "type": "string", "description": "Issue title" },
-          "body": { "type": "string", "description": "Issue body (markdown)" },
-          "labels": { "type": "array", "items": { "type": "string" }, "description": "Label names" }
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          }
         },
-        "required": ["owner", "repo", "title"]
+        "required": [
+          "owner",
+          "repo"
+        ]
       }
     },
     {
-      "name": "list_pull_requests",
-      "description": "List pull requests for a repository",
+      "name": "compare_commits",
+      "description": "Compare two commits, branches, or tags. Shows files changed and diff stats between base and head.",
       "method": "GET",
-      "path": "/repos/{owner}/{repo}/pulls",
+      "path": "/repos/%7B%7Bowner%7D%7D/%7B%7Brepo%7D%7D/compare/%7B%7Bbasehead%7D%7D",
       "input_schema": {
         "type": "object",
         "properties": {
-          "owner": { "type": "string", "description": "Repository owner" },
-          "repo": { "type": "string", "description": "Repository name" },
-          "state": { "type": "string", "enum": ["open", "closed", "all"], "default": "open" }
+          "owner": {
+            "type": "string",
+            "description": "Repository owner"
+          },
+          "repo": {
+            "type": "string",
+            "description": "Repository name"
+          },
+          "basehead": {
+            "type": "string",
+            "description": "Comparison in format base...head (e.g., main...feature-branch, v1.0.0...v2.0.0)"
+          },
+          "per_page": {
+            "type": "integer",
+            "description": "Results per page (max 100)",
+            "default": 30
+          },
+          "page": {
+            "type": "integer",
+            "description": "Page number",
+            "default": 1
+          }
         },
-        "required": ["owner", "repo"]
+        "required": [
+          "owner",
+          "repo",
+          "basehead"
+        ]
       }
     }
   ]