{
  "schemaVersion": 1,
  "slug": "github",
  "name": "GitHub",
  "description": "Give agents access to GitHub repositories, issues, and pull requests.",
  "categories": [
    "developer"
  ],
  "featured": true,
  "branding": {
    "logoUrl": "/brands/apps/github.svg",
    "darkLogoUrl": "/brands/apps/github-dark.svg"
  },
  "urlPatterns": [
    "https://api.githubcopilot.com/mcp/*",
    "https://github.com/*"
  ],
  "methods": [
    {
      "key": "managed",
      "transport": "mcp_remote",
      "auth": "oauth",
      "ownershipModes": [
        "platform_shared"
      ],
      "whenToUse": "Connect your GitHub account for durable MCP, shell Git, gh, and repository access.",
      "defaults": {
        "serverUrl": "https://api.githubcopilot.com/mcp/"
      },
      "guidanceMd": "Authorize Paperclip, then choose selected repositories in GitHub. You can edit repository access later from GitHub's installation settings.",
      "riskTier": "S3",
      "label": "Connect GitHub",
      "purpose": "tool",
      "oauthStrategy": "paperclip_cloud_connector",
      "connectorProfile": "github.code",
      "grantKinds": [
        "user",
        "agent"
      ],
      "warnings": [
        "Shell Git and gh receive this identity for the run and are not constrained by per-tool Ask-first controls."
      ],
      "requiredResourceFilters": [
        "organization",
        "repository"
      ]
    },
    {
      "key": "mcp-key",
      "transport": "mcp_remote",
      "auth": "api_key",
      "ownershipModes": [
        "customer"
      ],
      "whenToUse": "Use the provider-hosted connection for the quickest setup.",
      "defaults": {
        "serverUrl": "https://api.githubcopilot.com/mcp/"
      },
      "guidanceMd": "Create a fine-grained token limited to the repositories agents should use.",
      "riskTier": "S3",
      "label": "Personal access token (advanced)",
      "purpose": "tool",
      "credentialFields": [
        {
          "key": "authorization",
          "label": "GitHub token",
          "type": "password",
          "required": true,
          "placeholder": "github_pat_...",
          "secret": true,
          "helperMd": "Repository contents, issues, pull requests and other granted toolsets; selected repos and installation/PAT permissions apply. Create a key with read and write permissions for these actions; Paperclip cannot increase an existing key’s permissions."
        }
      ],
      "keyPlacement": {
        "location": "header",
        "name": "Authorization",
        "prefix": "Bearer "
      },
      "requiredResourceFilters": [
        "organization",
        "repository"
      ]
    }
  ]
}