Skip to content

The open-source app everyone uses to manage agents at work

3.0 KB
Raw Blame
{
  "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": "Grant Read and Write only when those actions are intended. A Read-only key is supported; the key cannot exceed the owning user\u2019s workspace access.",
          "placeholder": "Paste your Linear API key"
        }
      ],
      "keyPlacement": {
        "location": "header",
        "name": "Authorization",
        "prefix": "Bearer "
      },
      "consoleLinks": {
        "docs": "https://linear.app/docs/api-and-webhooks"
      },
      "warnings": [
        "Linear\u2019s standard MCP endpoint exposes read and write tools; review the discovered catalog and Paperclip action policies."
      ]
    }
  ]
}