{
    "schemaVersion": 1,
    "slug": "linear",
    "name": "Linear",
    "description": "Create, update, and read Linear issues.",
    "categories": [
        "productivity"
    ],
    "featured": true,
    "branding": {
        "logoUrl": "/brands/apps/linear.svg",
        "darkLogoUrl": "/brands/apps/linear-dark.svg"
    },
    "urlPatterns": [
        "https://mcp.linear.app/*"
    ],
    "methods": [
        {
            "key": "mcp-oauth",
            "transport": "mcp_remote",
            "auth": "oauth",
            "ownershipModes": [
                "dcr",
                "customer"
            ],
            "whenToUse": "Use the provider-hosted connection for the quickest setup.",
            "defaults": {
                "serverUrl": "https://mcp.linear.app/mcp",
                "authorizationEndpoint": "https://linear.app/oauth/authorize",
                "tokenEndpoint": "https://api.linear.app/oauth/token",
                "scopesHint": [
                    "read",
                    "write"
                ]
            },
            "guidanceMd": "Connect Linear for issues and projects. Paperclip registers its own OAuth client with Linear MCP; no developer-console setup is needed.",
            "riskTier": "S2",
            "requiredResourceFilters": [
                "workspace",
                "team",
                "project"
            ],
            "credentialSources": {
                "vercelConnect": {
                    "services": [
                        "linear"
                    ],
                    "principalModes": [
                        "user"
                    ],
                    "scopes": [
                        "read",
                        "write"
                    ],
                    "header": {
                        "name": "Authorization",
                        "prefix": "Bearer "
                    }
                }
            },
            "label": "Sign in with Linear",
            "consoleLinks": {
                "docs": "https://linear.app/docs/mcp"
            }
        },
        {
            "key": "mcp-api-key",
            "transport": "mcp_remote",
            "auth": "api_key",
            "ownershipModes": [
                "customer"
            ],
            "whenToUse": "Use a Linear API key when browser sign-in is not suitable.",
            "defaults": {
                "serverUrl": "https://mcp.linear.app/mcp"
            },
            "guidanceMd": "Create a Linear API key with the permissions needed for the actions you intend to allow. A key restricted to Read is supported for read-only use; workspace and role access still apply.",
            "riskTier": "S2",
            "label": "Use an API key",
            "credentialFields": [
                {
                    "key": "authorization",
                    "label": "Linear API key",
                    "type": "password",
                    "required": true,
                    "secret": true,
                    "helperMd": "Choose intended permissions and teams when creating the personal API key. Read-only is supported with Read permission only.",
                    "placeholder": "Paste your Linear API key"
                }
            ],
            "keyPlacement": {
                "location": "header",
                "name": "Authorization",
                "prefix": "Bearer "
            },
            "consoleLinks": {
                "docs": "https://linear.app/docs/api-and-webhooks"
            },
            "warnings": [
                "Linear’s standard MCP endpoint exposes read and write tools; review the discovered catalog and Paperclip action policies."
            ]
        }
    ],
    "docsUrl": "https://linear.app/docs/mcp",
    "redirectConstraints": "https-or-loopback-http"
}
