`confluence_search`

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

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

Search Confluence pages by keyword or CQL query. Returns matching pages with ID, title, space, and content excerpt.

Parameters

Name	Type	Required	Description
`cql`	string	yes	CQL query string (e.g., “text ~ \“search term\"", “space = DEV AND type = page”)
`limit`	number	no	Number of results to return (default 25, max 100)

Example call

Arguments

{
  "cql": "text ~ \"project roadmap\""
}

curl

curl -X POST https://gateway.pipeworx.io/confluence/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"confluence_search","arguments":{"cql":"text ~ \"project roadmap\""}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('confluence_search', {
  "cql": "text ~ \"project roadmap\""
});

More examples

{
  "cql": "space = ENG AND type = page",
  "limit": 100
}

Response shape

Always returns: total, results

Field	Type	Description
`total`	number	Total number of search results
`results`	array	Array of search result items

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total number of search results"
    },
    "results": {
      "type": "array",
      "description": "Array of search result items",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": [
              "string",
              "null"
            ],
            "description": "Page ID"
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Page title"
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Content type (page, attachment, etc)"
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Page status (current, draft, etc)"
          },
          "space": {
            "type": [
              "string",
              "null"
            ],
            "description": "Space name containing the page"
          },
          "excerpt": {
            "type": [
              "string",
              "null"
            ],
            "description": "Content excerpt from search result"
          }
        }
      }
    }
  },
  "required": [
    "total",
    "results"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

confluence_search