Support resolving Confluence short URLs (tinyui links) to page IDs

[bjoern-wahle]

Problem

Confluence short URLs (tinyui links) like https://COMPANY.atlassian.net/wiki/x/0-TJU cannot be resolved to their page IDs using the current MCP tools.

These short links are commonly used in:

• Runbook URLs in alert definitions
• Documentation references
• Slack messages and emails

Currently, to fetch a page from a short URL, users must:

1. Manually search for the page by title/content using searchConfluenceUsingCql
2. Find the matching page in results by checking the tinyui field in _links
3. Extract the page ID
4. Construct the ARI manually: ari:cloud:confluence:{cloudId}:page/{pageId}

This is cumbersome and error-prone, especially when you only have the short URL.

Proposed Solution

Add support for short URL resolution in one of these ways:

Option A: Accept short URLs in fetch tool

Allow the fetch tool to accept Confluence short URLs directly and resolve them internally:
fetch({ id: "https://COMPANY.atlassian.net/wiki/x/0-TJU" })

Option B: Add a resolveConfluenceShortUrl tool

New tool that converts a short URL to a page ID or ARI:
resolveConfluenceShortUrl({
cloudId: "...",
shortCode: "0-TJU"
})
// Returns: { pageId: "1355412691", ari: "ari:cloud:confluence:...:page/1355412691" }

Option C: Accept short URLs in getConfluencePage

Allow pageId parameter to accept tinyui codes:
getConfluencePage({ cloudId: "...", pageId: "x/0-TJU" })

Additional Context

• The tinyui code appears in search results under _links.tinyui but CQL doesn't support querying by tinyui
• The Confluence REST API may have an endpoint to resolve these links (needs investigation)
• Short URLs require authentication to follow redirects, so fetch cannot resolve them

[aviita]

This can be done with fairly simple converter script. Do your own mcp in the meantime to run a conversion.

Tiny url ID needs ’==’ appended, then needs to be base64 decoded. This contains a Byte array with integer in little endian format you need to then parse.

It is simple to test this as you have both page id and tiny url in Page info of any page.