Confluence GET Request
conf_getRead any Confluence data with token-efficient output by specifying JMESPath filters to reduce response size.
Instructions
Read any Confluence data. Returns TOON format by default (30-60% fewer tokens than JSON).
IMPORTANT - Cost Optimization:
ALWAYS use
jqparam to filter response fields. Unfiltered responses are very expensive!Use
limitquery param to restrict result count (e.g.,limit: "5")If unsure about available fields, first fetch ONE item with
limit: "1"and NO jq filter to explore the schema, then use jq in subsequent calls
Schema Discovery Pattern:
First call:
path: "/wiki/api/v2/spaces", queryParams: {"limit": "1"}(no jq) - explore available fieldsThen use:
jq: "results[*].{id: id, key: key, name: name}"- extract only what you need
Output format: TOON (default, token-efficient) or JSON (outputFormat: "json")
Common paths:
/wiki/api/v2/spaces- list spaces/wiki/api/v2/pages- list pages (usespace-idquery param)/wiki/api/v2/pages/{id}- get page details/wiki/api/v2/pages/{id}/body- get page body (body-format: storage, atlas_doc_format, view)/wiki/rest/api/search- search content (cqlquery param)
JQ examples: results[*].id, results[0], results[*].{id: id, title: title}
API reference: https://developer.atlassian.com/cloud/confluence/rest/v2/
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | The Confluence API endpoint path (without base URL). Must start with "/". Examples: "/wiki/api/v2/spaces", "/wiki/api/v2/pages", "/wiki/api/v2/pages/{id}" | |
| queryParams | No | Optional query parameters as key-value pairs. Examples: {"limit": "25", "cursor": "...", "space-id": "123", "body-format": "storage"} | |
| jq | No | JMESPath expression to filter/transform the response. IMPORTANT: Always use this to extract only needed fields and reduce token costs. Examples: "results[*].{id: id, title: title}" (extract specific fields), "results[0]" (first result), "results[*].id" (IDs only). See https://jmespath.org | |
| outputFormat | No | Output format: "toon" (default, 30-60% fewer tokens) or "json". TOON is optimized for LLMs with tabular arrays and minimal syntax. |