{
    "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"
            ]
        }
    ]
}