Tools Reference
The Secure MCP Server exposes 7 MCP tools to connected AI clients. This page documents each one — what it does, its parameters, and an example prompt you can give your AI client.
Two things apply to every tool:
- Everything runs as you. Each tool calls the Confluence REST API using your own session token (
api.asUser), so it can only ever see or change content your Confluence account already has permission to — read and write alike. - Availability depends on admin settings. An admin can enable or disable whole categories of tools for the site. If a category is disabled, its tools disappear from your client's tool list and any call to them is rejected. See Admin Guide → Controlling which tools are available.
The tools fall into three categories, matching the admin toggles:
| Category | Tools | Admin toggle |
|---|---|---|
| Read | confluence_search_pages, confluence_get_spaces, confluence_get_page, confluence_get_page_comments | Read |
| Page editing | confluence_create_page, confluence_update_page | Create pages |
| Comments | confluence_add_comment | Add comments |
Storage Format: the page-editing and comment tools accept a body in Confluence Storage Format — an XHTML-based markup using tags like
<p>,<h2>, and<ul><li>. AI clients generally produce this for you; you don't need to write it by hand.
Read tools
confluence_search_pages
Search Confluence pages and blog posts using a CQL query or plain keywords. Returns titles, spaces, and version info.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | A CQL query, or plain natural-language keywords. Plain keywords match on any word (OR), so a short list of terms is safe. |
limit | number | No | Maximum results to return. Default 10, maximum 50. |
start | number | No | Pagination offset. Default 0; increment by limit for the next page. |
Example prompt: "Search Confluence for our Q3 roadmap."
confluence_get_spaces
List the Confluence spaces you can access, narrowed by any admin space restrictions.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Maximum number of spaces to return. Default 25. |
type | string | No | Filter by space type: global or personal. |
status | string | No | Filter by space status: current or archived. |
Example prompt: "List the spaces I have access to."
confluence_get_page
Get the full rendered content and metadata (title, space, version, last-modified date, labels) of a page by its ID.
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id | string | Yes | The ID of the Confluence page to retrieve. |
Example prompt: "Show me the content of the 'Onboarding Guide' page."
confluence_get_page_comments
Get the footer comments on a page. Each comment's text is returned with HTML stripped and truncated to 300 characters.
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id | string | Yes | The ID of the Confluence page. |
limit | number | No | Maximum number of comments to return. Default 25. |
Example prompt: "Get the comments on page 12345."
Page-editing tools
confluence_create_page
Create a new Confluence page. The body must be in Confluence Storage Format.
| Parameter | Type | Required | Description |
|---|---|---|---|
space_key | string | Yes | Key of the space to create the page in (e.g. DEV). |
title | string | Yes | Page title. |
content | string | Yes | Page body in Confluence Storage Format. |
parent_page_id | string | No | ID of a parent page to nest the new page under. |
Example prompt: "Draft a new page called 'Sprint 24 Notes' in the DEV space summarizing this conversation."
confluence_update_page
Update an existing page. You must supply the page's current version number; the tool increments it for the update.
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id | string | Yes | ID of the page to update. |
title | string | Yes | New page title. |
content | string | Yes | New page body in Confluence Storage Format. |
current_version | number | Yes | The page's current version number (incremented automatically). |
Example prompt: "Update page 12345 to add a new section about rollback steps."
Comment tools
confluence_add_comment
Add a top-level footer comment to a page, posted as you. The body must be in Confluence Storage Format.
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id | string | Yes | ID of the page to comment on. |
content | string | Yes | Comment body in Confluence Storage Format. |
Example prompt: "Add a comment to page 12345 summarizing the decision we reached."