`linear_search`

Pack: linear · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/linear_search for the schema, then POST the same URL with its arguments for the data.

Search Linear issues by keyword or text. Returns matching issues with ID, title, state, priority, and URL.

Parameters

Name	Type	Required	Description
`query`	string	yes	Search query text
`first`	number	no	Number of results to return (default 20, max 50)

Example call

Arguments

{
  "query": "database performance"
}

curl

curl -X POST https://gateway.pipeworx.io/linear/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"linear_search","arguments":{"query":"database performance"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('linear_search', {
  "query": "database performance"
});

More examples

{
  "query": "authentication",
  "first": 15
}

Response shape

Always returns: issues

Field	Type	Description
`issues`	array	Search results matching query

Full JSON Schema

{
  "type": "object",
  "properties": {
    "issues": {
      "type": "array",
      "description": "Search results matching query",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Issue ID"
          },
          "identifier": {
            "type": "string",
            "description": "Issue identifier (e.g., ABC-123)"
          },
          "title": {
            "type": "string",
            "description": "Issue title"
          },
          "state": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "State name"
              }
            }
          },
          "priority": {
            "type": "number",
            "description": "Priority level"
          },
          "priorityLabel": {
            "type": "string",
            "description": "Human-readable priority label"
          },
          "assignee": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "Assignee name"
              }
            }
          },
          "url": {
            "type": "string",
            "description": "Issue URL"
          },
          "updatedAt": {
            "type": "string",
            "description": "Last update timestamp"
          }
        }
      }
    }
  },
  "required": [
    "issues"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the linear pack

{
  "mcpServers": {
    "linear": {
      "url": "https://gateway.pipeworx.io/linear/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

linear_search