`jira_search`

Pack: jira · Endpoint: https://gateway.pipeworx.io/jira/mcp

Search Jira issues using JQL queries. Returns issue keys, summaries, status, assignee, and priority. Use to find tasks by project, status, assignee, or custom criteria.

Parameters

Name	Type	Required	Description
`jql`	string	yes	JQL query (e.g., “project = PROJ AND status = Open ORDER BY created DESC”)
`max_results`	number	no	Maximum results to return (default 20, max 100)
`fields`	string	no	Comma-separated field names to include (e.g., “summary,status,assignee”)

Example call

Arguments

{
  "jql": "project = PROJ AND status = Open ORDER BY created DESC"
}

curl

curl -X POST https://gateway.pipeworx.io/jira/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"jira_search","arguments":{"jql":"project = PROJ AND status = Open ORDER BY created DESC"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('jira_search', {
  "jql": "project = PROJ AND status = Open ORDER BY created DESC"
});

More examples

{
  "jql": "assignee = currentUser() AND status != Done",
  "max_results": 50,
  "fields": "summary,status,priority,assignee"
}

Response shape

Field	Type	Description
`expand`	string	Expansion options applied
`startAt`	number	Index of first result returned
`maxResults`	number	Maximum results per request
`total`	number	Total number of issues matching query
`issues`	array	List of issues matching the JQL query
`error`	string	Error code if connection failed
`message`	string	Error message if connection failed

Full JSON Schema

{
  "type": "object",
  "properties": {
    "expand": {
      "type": "string",
      "description": "Expansion options applied"
    },
    "startAt": {
      "type": "number",
      "description": "Index of first result returned"
    },
    "maxResults": {
      "type": "number",
      "description": "Maximum results per request"
    },
    "total": {
      "type": "number",
      "description": "Total number of issues matching query"
    },
    "issues": {
      "type": "array",
      "description": "List of issues matching the JQL query",
      "items": {
        "type": "object",
        "properties": {
          "expand": {
            "type": "string",
            "description": "Expansion options for this issue"
          },
          "id": {
            "type": "string",
            "description": "Issue ID"
          },
          "key": {
            "type": "string",
            "description": "Issue key (e.g., PROJ-123)"
          },
          "self": {
            "type": "string",
            "description": "API URL for this issue"
          },
          "fields": {
            "type": "object",
            "description": "Issue fields (summary, status, assignee, etc.)"
          }
        }
      }
    },
    "error": {
      "type": "string",
      "description": "Error code if connection failed"
    },
    "message": {
      "type": "string",
      "description": "Error message if connection failed"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

jira_search