# Confluence — how to use (mcp.ai)

Confluence via linguagem natural: crie, busque e edite páginas, espaços e conteúdo da wiki. Plataforma fornece a aplicação OAuth, você só clica em Conectar e autoriza seu site Atlassian. Vários sites podem ser conectados no mesmo MCP.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_confluence?ms=1781044260000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `confluence_add_content_label`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/confluence`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/confluence/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/confluence/add/content/label` — Tool to add labels to a piece of content. use after obtaining the content id to tag pages or blog posts with metadata labels.
  - body: { id: string, labels: object[] }
- `POST https://api.mcp.ai/api/confluence/confluence/get/space/by/id` — Tool to retrieve a confluence space by its id. use when you need detailed metadata of a specific space.
  - body: { id: string }
- `POST https://api.mcp.ai/api/confluence/create/blogpost` — Tool to create a new confluence blog post. use when you need to publish content in a specific space.
  - body: { body: object, title: string, labels?: object[], status: string, spaceId: string, metadata?: object, parentId?: string }
- `POST https://api.mcp.ai/api/confluence/create/blogpost/property` — Tool to create a property on a specified blog post. use when you need to add custom metadata to a blog post.
  - body: { id: string, key: string, value: object }
- `POST https://api.mcp.ai/api/confluence/create/content/property/for/whiteboard` — Tool to create a new content property on a whiteboard. use when you need to attach custom metadata to a confluence whiteboard.
  - body: { key: string, value: object, whiteboard_id: string }
- `POST https://api.mcp.ai/api/confluence/create/page` — Tool to create a new confluence page in a specified space. use when you need to create new documentation or content.
  - body: { body: object, type?: string, title: string, spaceId: string, parentId?: string }
- `POST https://api.mcp.ai/api/confluence/create/page/property` — Tool to create a property on a confluence page. use when you need to add custom metadata or settings to a page.
  - body: { key: string, value: string, page_id: string }
- `POST https://api.mcp.ai/api/confluence/create/private/space` — Tool to create a private confluence space. use when you need an isolated workspace viewable only by its creator.
  - body: { key: string, name: string, description?: object }
- `POST https://api.mcp.ai/api/confluence/create/space` — Tool to create a new confluence space. use when setting up a new knowledge area for organization.
  - body: { key: string, name: string, type?: string, metadata?: object, description?: object }
- `POST https://api.mcp.ai/api/confluence/create/space/property` — Tool to create a new property on a confluence space. use after confirming the space id when adding custom metadata.
  - body: { key: string, value: object, spaceId: string, version?: object }
- `POST https://api.mcp.ai/api/confluence/create/whiteboard` — Tool to create a new confluence whiteboard. use when you need to start a collaborative whiteboard session.
  - body: { title?: string, spaceId: string, parentId?: string }
- `POST https://api.mcp.ai/api/confluence/delete/blogpost/property` — Tool to delete a blog post property. use when you need to remove custom metadata from a specified blog post.
  - body: { id: string, propertyKey: string }
- `POST https://api.mcp.ai/api/confluence/delete/content/property/for/page/by/id` — Tool to delete a content property from a page by property id. use when you need to remove custom metadata from a page for cleanup or auditing.
  - body: { pageId: string, propertyId: string }
- `POST https://api.mcp.ai/api/confluence/delete/content/property/for/whiteboard/by/id` — Tool to delete a content property from a whiteboard by property id. use when you need to remove custom metadata from a whiteboard.
  - body: { propertyId: string, whiteboardId: string }
- `POST https://api.mcp.ai/api/confluence/delete/page` — Tool to delete a confluence page. use with caution as this will permanently remove the page from the space.
  - body: { id: string }
- `POST https://api.mcp.ai/api/confluence/delete/space` — Tool to delete a confluence space by its key. use when you need to permanently remove a space.
  - body: { space_key: string }
- `POST https://api.mcp.ai/api/confluence/delete/space/property` — Tool to delete a space property. use when you need to remove a property from a confluence space after review.
  - body: { propertyKey: string, spaceIdOrKey: string }
- `POST https://api.mcp.ai/api/confluence/get/attachment/labels` — Tool to list labels on an attachment. use after confirming the attachment id to fetch its labels.
  - body: { id: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/confluence/get/attachments` — Tool to retrieve attachments of a confluence page. use after confirming page id to list its attachments (supports pagination).
  - body: { limit?: integer, start?: integer, pageId: string, mediaType?: string }
- `POST https://api.mcp.ai/api/confluence/get/audit/logs` — Tool to retrieve confluence audit records. use when you need to fetch and filter audit logs for compliance or troubleshooting.
  - body: { to?: string, from_?: string, limit?: integer, start?: integer, searchString?: string }
- `POST https://api.mcp.ai/api/confluence/get/blog/posts` — Tool to retrieve a list of blog posts. use when you need a paginated list of confluence blog posts.
  - body: { limit?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/confluence/get/blog/posts/for/label` — Tool to list all blog posts under a specific label. use when you have a label id and need to retrieve associated blog posts.
  - body: { id: string, limit?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/confluence/get/blogpost/by/id` — Tool to retrieve a specific confluence blog post by its id. use when you have a blog post id and need detailed metadata and content.
  - body: { id: string }
- `POST https://api.mcp.ai/api/confluence/get/blogpost/labels` — Tool to retrieve labels of a specific confluence blog post by id. use after obtaining the blog post id to list its labels.
  - body: { id: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/confluence/get/blogpost/like/count` — Tool to get like count for a confluence blog post. use after confirming the blog post id to retrieve total likes.
  - body: { id: string }
- `POST https://api.mcp.ai/api/confluence/get/blogpost/operations` — Tool to retrieve permitted operations for a confluence blog post. use after confirming the blog post id to see allowed actions.
  - body: { id: string }
- `POST https://api.mcp.ai/api/confluence/get/blogpost/version/details` — Tool to retrieve details for a specific version of a blog post. use when you have a blogpostid and versionnumber and need detailed metadata for that version.
  - body: { blogpostId: string, versionNumber: integer }
- `POST https://api.mcp.ai/api/confluence/get/blogpost/versions` — Tool to retrieve all versions of a specific blog post. use when you have a blogpostid and need to list version numbers.
  - body: { limit?: integer, cursor?: string, blogpostId: string }
- `POST https://api.mcp.ai/api/confluence/get/blogposts` — Tool to retrieve a list of blog posts. use when you need blog post ids.
  - body: { limit?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/confluence/get/child/pages` — Tool to list all direct child pages of a given confluence page. use when you have a parent page id and need to discover its direct descendants.
  - body: { id: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/confluence/get/content/properties/for/blog/post` — Tool to retrieve all content properties on a blog post. use when you need to list metadata properties set on a specific confluence blog post.
  - body: { limit?: integer, start?: integer, blogpost_id: string }
- `POST https://api.mcp.ai/api/confluence/get/content/properties/for/page` — Tool to retrieve all content properties on a page. use when you need to list metadata properties set on a specific confluence page.
  - body: { limit?: integer, cursor?: string, page_id: string }
- `POST https://api.mcp.ai/api/confluence/get/content/restrictions` — Tool to retrieve restrictions on a confluence content item. use when you need to see who can view or edit a page or blog post.
  - body: { id: string, expand?: string[] }
- `POST https://api.mcp.ai/api/confluence/get/current/user` — Tool to get information about the currently authenticated user. use when you need to check user details or permissions.
- `POST https://api.mcp.ai/api/confluence/get/inline/comments/for/blog/post` — Tool to retrieve inline comments for a confluence blog post. use when you need inline comment details by blog post id.
  - body: { id: string, limit?: integer, start?: integer, expand?: string, location?: string, parentVersion?: integer }
- `POST https://api.mcp.ai/api/confluence/get/labels` — Tool to retrieve all labels in a confluence site. use when you need to list or page through labels.
  - body: { limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/confluence/get/labels/for/page` — Tool to retrieve labels of a specific confluence page by id. use after obtaining the page id to list its labels.
  - body: { id: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/confluence/get/labels/for/space` — Tool to list labels on a space. use when you need to retrieve labels for a specific space.
  - body: { id: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/confluence/get/labels/for/space/content` — Tool to list labels on all content in a space. use when you need to retrieve or filter content labels by space, with pagination and optional prefix filtering.
  - body: { id: string, limit?: integer, start?: integer, prefix?: string }
- `POST https://api.mcp.ai/api/confluence/get/page/ancestors` — Tool to retrieve all ancestors for a given confluence page by its id. use when you need the full page hierarchy.
  - body: { id: string }
- `POST https://api.mcp.ai/api/confluence/get/page/by/id` — Tool to retrieve a confluence page by its id. use when you have a page id and need its detailed metadata and content.
  - body: { id: string, draft?: boolean, version?: integer }
- `POST https://api.mcp.ai/api/confluence/get/page/like/count` — Tool to get like count for a confluence page. use after confirming the page id to retrieve total likes.
  - body: { id: string }
- `POST https://api.mcp.ai/api/confluence/get/page/versions` — Tool to retrieve all versions of a specific confluence page. use after confirming the page id to audit its edit history.
  - body: { id: string, limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/confluence/get/pages` — Tool to retrieve a list of pages. use when you need a paginated list of confluence pages.
  - body: { sort?: string, type?: string, label?: string[], limit?: integer, start?: integer, expand?: string[], status?: string, spaceId?: string, authorId?: string, direction?: string }
- `POST https://api.mcp.ai/api/confluence/get/space/by/id` — Tool to retrieve a confluence space by its id. use when you need detailed metadata of a specific space.
  - body: { id: string }
- `POST https://api.mcp.ai/api/confluence/get/space/contents` — Tool to retrieve content in a confluence space. use when you need to list pages, blogposts, or attachments of a specific space key.
  - body: { type?: string, limit?: integer, start?: integer, status?: string, spaceKey: string, postingDay?: string }
- `POST https://api.mcp.ai/api/confluence/get/space/properties` — Tool to get properties of a confluence space. use when you need to retrieve custom metadata or settings stored as space properties.
  - body: { id: string, key?: string[], limit?: integer, start?: integer }
- `POST https://api.mcp.ai/api/confluence/get/spaces` — Tool to retrieve a list of confluence spaces. use when you need a paginated list of spaces with optional filtering.
  - body: { type?: string, label?: string[], limit?: integer, start?: integer, expand?: string[], status?: string, spaceKey?: string[] }
- `POST https://api.mcp.ai/api/confluence/get/user/anonymous` — Tool to retrieve information about the anonymous user. use when you need to obtain guest user details before unauthenticated interactions.
- `POST https://api.mcp.ai/api/confluence/search/content` — Searches for content by filtering pages from the confluence v2 api with intelligent ranking. since the native search endpoint is deprecated, this action: 1. fetches pages from the v2 pages endpoint wi
  - body: { limit?: integer, query: string, start?: integer, expand?: string, spaceKey?: string }
- `POST https://api.mcp.ai/api/confluence/search/users` — Searches for users using user-specific queries from the confluence query language (cql).
  - body: { limit?: integer, cursor?: string, accountId?: string }
- `POST https://api.mcp.ai/api/confluence/update/blogpost` — Tool to update a confluence blog post's title or content. use when you need to modify an existing blog post. ensure you have the latest version number before calling.
  - body: { id: string, body: object, type?: string, title: string, status?: string, spaceId: string, version: object }
- `POST https://api.mcp.ai/api/confluence/update/blogpost/property` — Tool to update a property of a specified blog post. use when you need to modify custom metadata on a blog post.
  - body: { id: string, value: object, propertyKey: string }
- `POST https://api.mcp.ai/api/confluence/update/content/property/for/page/by/id` — Tool to update a content property on a confluence page. use when you need to modify an existing metadata property by its id.
  - body: { value: object, pageId: string, propertyId: string }
- `POST https://api.mcp.ai/api/confluence/update/content/property/for/whiteboard/by/id` — Tool to update a content property on a whiteboard. use when you need to modify metadata on a confluence whiteboard.
  - body: { value: object, propertyId: string, whiteboardId: string }
- `POST https://api.mcp.ai/api/confluence/update/page` — Tool to update an existing confluence page. use when you need to modify existing documentation or content.
  - body: { id: string, body: object, type?: string, title: string, spaceId: string, version: object }
- `POST https://api.mcp.ai/api/confluence/update/space/property` — Tool to update a space property. use when you need to modify custom metadata stored on a confluence space (requires fetching the current property version first).
  - body: { value: object, spaceKey: string, propertyKey: string }

## Example prompts
- "Crie uma página 'Onboarding' no espaço da Engenharia"
- "Busque páginas que mencionam 'política de férias'"
- "Liste as páginas atualizadas esta semana no espaço de Produto"

## More
- Page: https://mcp.ai/confluence
- Agent spec (llms.txt): https://mcp.ai/confluence/llms.txt
- Postman collection: https://mcp.ai/confluence/postman.json