@crypto512/jicon-mcp 2.3.26 → 2.4.1

package/TOOL_LIST.md

@@ -3,6 +3,37 @@
 ## Overview
 This document provides a comprehensive reference of all available tools in the Jira, Confluence, and Tempo MCP server.
 
+## ⚠️ Breaking changes in 2.4.1
+
+Tool names and a few parameters were standardized for consistency (every tool is now
+`<module>_<verb>_<noun>`). Update any saved prompts, automations, or permission configs.
+
+| Old name | New name |
+|----------|----------|
+| `fullurl` | `url_build` |
+| `parseurl` | `url_parse` |
+| `help` | `jicon_help` |
+| `whoami` | `user_whoami` |
+| `resolve_user` | `user_resolve` |
+| `jira_get_sprints` | `jira_list_sprints` |
+| `jira_get_issue_types` | `jira_list_issue_types` |
+| `jira_get_fields` | `jira_search_fields` |
+| `tempo_get_accounts` | `tempo_list_accounts` |
+| `tempo_get_teams` | `tempo_list_teams` |
+| `confluence_draft_create` | `confluence_create_draft` |
+| `confluence_draft_save` | `confluence_save_draft` |
+| `confluence_draft_open` | `confluence_open_draft` |
+| `confluence_draft_list` | `confluence_list_drafts` |
+| `confluence_draft_delete` | `confluence_delete_draft` |
+| `confluence_review_publish` | `confluence_publish_review` |
+| `confluence_review_discard` | `confluence_discard_review` |
+| `confluence_review_list` | `confluence_list_reviews` |
+
+**Parameter changes:** the result-cap parameter is now `limit` everywhere (was
+`maxResults`/`maxActivities`/`maxComments`/`maxChanges`); all numeric id parameters accept a
+number or a numeric string; Tempo `dateFrom`/`dateTo` accept date expressions (e.g.
+`"last_week"`) in addition to `YYYY-MM-DD`.
+
 ## Summary
 
 **Tool Categories**:
@@ -75,7 +106,7 @@ jira_update_issue({ issueKey: "PROJ-123", fields: {...}, autoRetry: true })
 
 **Tools supporting autoRetry:**
 - `jira_update_issue` - Auto-retries on 409 (refetches issue)
-- `confluence_review_publish` - Auto-retries on 409 (refetches page version)
+- `confluence_publish_review` - Auto-retries on 409 (refetches page version)
 - `tempo_update_worklog` - Auto-retries on 409 (refetches worklog)
 
 **Response on successful retry:**
@@ -115,7 +146,7 @@ When XHTML validation fails, the response includes element ID and suggested acti
 2. buffer_transform(inputs, code) → tableBufferId (98% token reduction)
 3. confluence_load(pageId) → pageBufferId, structure
 4. buffer_edit(pageBufferId, after=ID, fromBufferId=tableBufferId)
-5. confluence_draft_create(pageId, pageBufferId, autoRetry=true) → draft URL
+5. confluence_create_draft(pageId, pageBufferId, autoRetry=true) → draft URL
 ```
 
 #### Tempo Time Report
@@ -132,8 +163,8 @@ When XHTML validation fails, the response includes element ID and suggested acti
 2. buffer_edit(bufferId, after=ID, content) → updated structure
 3. buffer_validate_xhtml(bufferId) → check before publish
    - If errors: buffer_get_element(elementId) → inspect → buffer_edit(replace=ID) → retry
-4. confluence_draft_create(pageId, bufferId) → draft for review
-5. confluence_review_publish(reviewDraftId, autoRetry=true) → published
+4. confluence_create_draft(pageId, bufferId) → draft for review
+5. confluence_publish_review(reviewDraftId, autoRetry=true) → published
 ```
 
 #### Batch Confluence Page Summarization
@@ -165,8 +196,8 @@ When XHTML validation fails, the response includes element ID and suggested acti
 | Epic Link | Lien d'épopée | Epic-Link |
 
 **Before writing JQL:**
-1. `jira_get_issue_types()` - Discover actual type names
-2. `jira_get_fields(search="epic")` - Discover field names and IDs
+1. `jira_list_issue_types()` - Discover actual type names
+2. `jira_search_fields(search="epic")` - Discover field names and IDs
 3. Use `cf[ID]` syntax for language-independent queries: `cf[10014] = PROJ-123`
 
 The server automatically handles localized changelog field names for activity tracking.
@@ -327,7 +358,7 @@ The server automatically handles localized changelog field names for activity tr
 
 ---
 
-### jira_get_issue_types
+### jira_list_issue_types
 **Description**: Get all available issue types in this Jira instance
 **Use Cases**: Discover type names before filtering by type in JQL, find localized or custom type names
 
@@ -339,7 +370,7 @@ The server automatically handles localized changelog field names for activity tr
 
 ---
 
-### jira_get_fields
+### jira_search_fields
 **Description**: Get Jira fields (system and custom). Requires a search term or "all".
 **Use Cases**: Discover field names in user's language, find custom field IDs for JQL, identify Epic Link field
 
@@ -351,7 +382,7 @@ The server automatically handles localized changelog field names for activity tr
 **Returns**: List of fields with id, name, custom, clauseNames, schemaType
 
 **Example workflow for Epic Link in any language**:
-1. Call `jira_get_fields(search="epic")` — matches name, id, clauseNames, AND schemaType
+1. Call `jira_search_fields(search="epic")` — matches name, id, clauseNames, AND schemaType
 2. Look for field with `schemaType = "com.pyxis.greenhopper.jira:gh-epic-link"`
 3. Use `cf[ID]` from clauseNames in JQL: `cf[10014] IS EMPTY`
 
@@ -366,7 +397,7 @@ The server automatically handles localized changelog field names for activity tr
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | query | string | ✓ | Search text (display name, username, or email) |
-| maxResults | number | ✗ | Maximum results (default: 20) |
+| limit | number | ✗ | Maximum results (default: 20) |
 
 **Returns**: Inline list of matching users with `key`, `name`, `displayName`, `emailAddress`.
 
@@ -432,7 +463,7 @@ jira_list_boards(type="scrum")             # Only Scrum boards
 
 ---
 
-### jira_get_sprints
+### jira_list_sprints
 **Description**: List all sprints for a board
 **Use Cases**: View active sprints, check sprint schedules
 
@@ -530,7 +561,7 @@ Fetches comments, status changes, priority changes, and assignee changes - forma
 | includeStatusChanges | boolean | ✗ | Include status changes (default: true) |
 | includePriorityChanges | boolean | ✗ | Include priority changes (default: true) |
 | includeAssigneeChanges | boolean | ✗ | Include assignee changes (default: true) |
-| maxActivities | number | ✗ | Maximum activities to return (default: 50) |
+| limit | number | ✗ | Maximum activities to return (default: 50) |
 | commentMaxLength | number | ✗ | Max length for comment text (default: 500) |
 
 **At least one scoping parameter required**: `projectKey`, `jql`, or `issueKeys`
@@ -566,7 +597,7 @@ Fetches comments, status changes, priority changes, and assignee changes - forma
 | issueKeys | string[] | ✗ | Specific issue keys to include |
 | since | string | ✗ | Time range: "7d", "30d", "365d", or ISO date (default: "30d"). Provide explicitly for accurate results. |
 | authorKey | string | ✗ | Filter by comment author username |
-| maxComments | number | ✗ | Maximum comments to return (default: all) |
+| limit | number | ✗ | Maximum comments to return (default: all) |
 
 **At least one scoping parameter required**: `projectKey`, `jql`, or `issueKeys`
 
@@ -586,7 +617,7 @@ Fetches comments, status changes, priority changes, and assignee changes - forma
 | issueKeys | string[] | ✗ | Specific issue keys to include |
 | since | string | ✗ | Time range: "7d", "30d", "365d", or ISO date (default: "30d"). Provide explicitly for accurate results. |
 | fields | string[] | ✗ | Fields to track (default: ["status", "priority", "assignee", "resolution"]) |
-| maxChanges | number | ✗ | Maximum changes to return (default: 50) |
+| limit | number | ✗ | Maximum changes to return (default: 50) |
 
 **At least one scoping parameter required**: `projectKey`, `jql`, or `issueKeys`
 
@@ -614,7 +645,7 @@ Fetches comments, status changes, priority changes, and assignee changes - forma
 | issueKey | string | ✓ | Epic or parent issue key (e.g., PROJ-123) |
 | includeComments | boolean | ✗ | Include recent comments (default: true) |
 | commentDays | number | ✗ | Days of comments to include (default: 14) |
-| maxComments | number | ✗ | Max comments per issue (default: 5) |
+| limit | number | ✗ | Max comments per issue (default: 5) |
 
 **Returns**: Comprehensive markdown analysis including:
 - **Issue Hierarchy**: Breakdown by type (Epic, Story, Task, Sub-task) with completion percentages
@@ -703,12 +734,12 @@ Provides quick overview without the heavy metrics of `jira_analyze_epic` - no ti
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| sprintId | number | ✓ | Sprint ID (from `jira_get_sprints`) |
+| sprintId | number | ✓ | Sprint ID (from `jira_list_sprints`) |
 | includeComments | boolean | ✗ | Include recent comments (default: true) |
 | commentDays | number | ✗ | Days of comments to include (default: 7) |
 | includeRisks | boolean | ✗ | Calculate risk indicators (default: true) |
 
-**Finding sprintId**: Call `jira_get_sprints(boardId)` first. BoardId can be found in Jira URLs like `/secure/RapidBoard.jspa?rapidView=123`.
+**Finding sprintId**: Call `jira_list_sprints(boardId)` first. BoardId can be found in Jira URLs like `/secure/RapidBoard.jspa?rapidView=123`.
 
 **Returns**: Comprehensive markdown analysis including:
 - **Sprint Metadata**: Name, state, dates, duration, days remaining
@@ -789,7 +820,7 @@ Time tracking shows **71% of estimate used** for **65% completion**.
 ### confluence_search_content
 **Description**: Search Confluence content using CQL. Auto-fetches all results.
 **Use Cases**: Find pages, search by keyword, filter by space
-**CQL Syntax**: See `help(topic="cql")` for valid fields and examples.
+**CQL Syntax**: See `jicon_help(topic="cql")` for valid fields and examples.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -811,7 +842,7 @@ Time tracking shows **71% of estimate used** for **65% completion**.
 
 **Response includes**: `pageId`, `version`, `bufferId`, `contentSize`, metadata
 
-**Usage**: Content is stored in buffer with `contentType: "xhtml"` and returns `structure` with element IDs. Use `buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId)` to add content, then `confluence_draft_create(pageId, bufferId)` for user review.
+**Usage**: Content is stored in buffer with `contentType: "xhtml"` and returns `structure` with element IDs. Use `buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId)` to add content, then `confluence_create_draft(pageId, bufferId)` for user review.
 
 ---
 
@@ -827,7 +858,7 @@ Time tracking shows **71% of estimate used** for **65% completion**.
 
 **Response includes**: `pageId`, `version`, `bufferId`, `contentSize`, metadata
 
-**Usage**: Content is stored in buffer with `contentType: "xhtml"` and returns `structure` with element IDs. Use `buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId)` to add content, then `confluence_draft_create(pageId, bufferId)` for user review.
+**Usage**: Content is stored in buffer with `contentType: "xhtml"` and returns `structure` with element IDs. Use `buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId)` to add content, then `confluence_create_draft(pageId, bufferId)` for user review.
 
 ---
 
@@ -835,7 +866,7 @@ Time tracking shows **71% of estimate used** for **65% completion**.
 **Description**: Load an EXISTING page or draft into a buffer for editing. Auto-resolves URLs, pageIds, draftIds, or SPACE/Title.
 **Use Cases**: Load any Confluence content with a single tool, handle URL input from users
 
-**For NEW pages**: `buffer_create(contentType="xhtml")` → `confluence_draft_create(spaceKey, title, bufferId)`
+**For NEW pages**: `buffer_create(contentType="xhtml")` → `confluence_create_draft(spaceKey, title, bufferId)`
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
@@ -862,7 +893,7 @@ Time tracking shows **71% of estimate used** for **65% completion**.
 ```
 1. confluence_load("URL or SPACE/Title") → bufferId, structure, pageId
 2. buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId) → add content
-3. confluence_draft_create(pageId=..., bufferId=...) → draft for review (links to original page)
+3. confluence_create_draft(pageId=..., bufferId=...) → draft for review (links to original page)
 4. User publishes via Confluence UI (updates original page)
 5. For more edits: confluence_load(same input) → auto-resolves
 ```
@@ -876,10 +907,10 @@ buffer_edit(bufferId=pageBuffer, after=5, fromBufferId=newContentBuffer)
 
 > **Note**: All page content changes go through the draft workflow.
 > AI creates/edits drafts; user publishes manually via Confluence UI:
-> - **Edit existing**: `confluence_load(input)` → `buffer_edit(bufferId, ...)` → `buffer_validate_xhtml(bufferId)` → `confluence_draft_create(pageId, bufferId)` → user publishes
-> - **Create new**: `buffer_create(content, contentType="xhtml")` → `buffer_validate_xhtml(bufferId)` → `confluence_draft_create(spaceKey, title, bufferId)` → user publishes
+> - **Edit existing**: `confluence_load(input)` → `buffer_edit(bufferId, ...)` → `buffer_validate_xhtml(bufferId)` → `confluence_create_draft(pageId, bufferId)` → user publishes
+> - **Create new**: `buffer_create(content, contentType="xhtml")` → `buffer_validate_xhtml(bufferId)` → `confluence_create_draft(spaceKey, title, bufferId)` → user publishes
 > - **After publish**: Draft ID becomes invalid; use `confluence_load("SPACE/Title")` to edit again
-> - **XHTML syntax**: Call `help(topic="storage")` for HTML vs XHTML differences
+> - **XHTML syntax**: Call `jicon_help(topic="storage")` for HTML vs XHTML differences
 
 ---
 
@@ -939,7 +970,7 @@ buffer_edit(bufferId=pageBuffer, after=5, fromBufferId=newContentBuffer)
 
 **Notes**:
 - This is the **default space** when the user does not specify a target space
-- Use the returned `spaceKey` with `confluence_draft_create(spaceKey=...)` or `confluence_search_content(cql="space=...")`
+- Use the returned `spaceKey` with `confluence_create_draft(spaceKey=...)` or `confluence_search_content(cql="space=...")`
 - Returns 404 if user has no personal space configured
 
 ---
@@ -1021,7 +1052,7 @@ confluence_get_pages(pageIds=["111", "222", "333"])
 
 ---
 
-### confluence_draft_list
+### confluence_list_drafts
 **Description**: List user's UNPUBLISHED draft pages (work-in-progress content)
 **Use Cases**: View pending drafts, find drafts to continue editing
 **NOTE**: To find published pages you edited, use `confluence_search_content(cql="contributor=currentUser()")`
@@ -1034,7 +1065,7 @@ confluence_get_pages(pageIds=["111", "222", "333"])
 
 ---
 
-### confluence_draft_open
+### confluence_open_draft
 **Description**: Load existing draft into buffer for editing
 **Use Cases**: Continue editing a draft, prepare draft for publishing
 
@@ -1044,11 +1075,11 @@ confluence_get_pages(pageIds=["111", "222", "333"])
 
 **Response includes**: `draftId`, `bufferId`, `structure` (element IDs), `title`, `spaceKey`, `version`, `url`, `contentPreview`
 
-**Usage**: Content is stored in buffer with element IDs. Use `buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId)` to modify, then `confluence_draft_save` to checkpoint.
+**Usage**: Content is stored in buffer with element IDs. Use `buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId)` to modify, then `confluence_save_draft` to checkpoint.
 
 ---
 
-### confluence_draft_create
+### confluence_create_draft
 **Description**: Create a draft for user review - either a new page or as an edit to an existing page
 **Use Cases**: Start new page as draft, edit existing page through draft workflow
 
@@ -1074,7 +1105,7 @@ confluence_get_pages(pageIds=["111", "222", "333"])
 
    **Important**: When `pageId` is provided, `bufferId` must originate from that page (validated). Space, title, and parent are auto-populated from the original page.
 
-**WARNING**: `pageId` must be a real page ID, NOT a draft ID. If you pass a draft ID, you'll get an error suggesting `confluence_draft_open` instead.
+**WARNING**: `pageId` must be a real page ID, NOT a draft ID. If you pass a draft ID, you'll get an error suggesting `confluence_open_draft` instead.
 
 **Response includes**: `draftId`, `bufferId`, `structure` (element IDs), `title`, `spaceKey`, `version`, `url` (clickable to preview), `contentSummary`, `editingExistingPage` (when editing)
 
@@ -1088,7 +1119,7 @@ confluence_get_pages(pageIds=["111", "222", "333"])
    → bufferId, structure (element IDs)
 2. buffer_validate_xhtml(bufferId)
    → If errors: buffer_edit(bufferId, replace=errorElementId, content="<fixed>")
-3. confluence_draft_create(spaceKey, title, bufferId)
+3. confluence_create_draft(spaceKey, title, bufferId)
    → draftId, url for preview
 4. User reviews and publishes via Confluence UI
 ```
@@ -1101,16 +1132,16 @@ confluence_get_pages(pageIds=["111", "222", "333"])
    → modify content
 3. buffer_validate_xhtml(bufferId)
    → check for errors
-4. confluence_draft_create(pageId=..., bufferId=...)
+4. confluence_create_draft(pageId=..., bufferId=...)
    → draft for review
 5. User reviews and publishes in Confluence UI (updates original page)
 ```
 
-**Why buffer-first?** Enables validation with element IDs for surgical error fixing. Call `help(topic="storage")` for XHTML syntax (HTML vs XHTML differences).
+**Why buffer-first?** Enables validation with element IDs for surgical error fixing. Call `jicon_help(topic="storage")` for XHTML syntax (HTML vs XHTML differences).
 
 ---
 
-### confluence_draft_save
+### confluence_save_draft
 **Description**: Save buffer content to draft (delete + recreate pattern)
 **Use Cases**: Checkpoint work, persist edits before publishing
 
@@ -1128,7 +1159,7 @@ confluence_get_pages(pageIds=["111", "222", "333"])
 
 ---
 
-### confluence_draft_delete
+### confluence_delete_draft
 **Description**: Permanently delete a draft
 **Use Cases**: Clean up abandoned drafts, remove unwanted content
 
@@ -1140,7 +1171,7 @@ confluence_get_pages(pageIds=["111", "222", "333"])
 
 ---
 
-### confluence_review_list
+### confluence_list_reviews
 **Description**: List all "[jicon-mcp REVIEW]" drafts for cleanup or management
 **Use Cases**: Find abandoned review drafts, manage multiple review workflows, clean up after publishing
 
@@ -1150,11 +1181,11 @@ confluence_get_pages(pageIds=["111", "222", "333"])
 
 **Response includes**: `reviewDrafts` array with `reviewDraftId`, `title`, `originalTitle`, `originalPageId`, `spaceKey`, `spaceName`, `createdDate`, `editUrl`; `total`, `message`
 
-**Note**: Review drafts are created when using `confluence_draft_create` with a `pageId` parameter to edit an existing page. They are linked to the original page via a label.
+**Note**: Review drafts are created when using `confluence_create_draft` with a `pageId` parameter to edit an existing page. They are linked to the original page via a label.
 
 ---
 
-### confluence_review_publish
+### confluence_publish_review
 **Description**: Publish a review draft to apply changes to the original page
 **Use Cases**: Apply reviewed changes to the original page, complete the review workflow
 
@@ -1174,7 +1205,7 @@ confluence_get_pages(pageIds=["111", "222", "333"])
 
 ---
 
-### confluence_review_discard
+### confluence_discard_review
 **Description**: Discard a review draft without applying changes to the original page
 **Use Cases**: Cancel a review, abandon changes, clean up unwanted review drafts
 
@@ -1195,7 +1226,7 @@ confluence_get_pages(pageIds=["111", "222", "333"])
 
 ### JQL (Jira Query Language) Examples
 
-> **Note**: Type, status, and priority names below are in English. Use `jira_get_issue_types()` and `jira_get_fields(search="epic")` to discover actual names for your Jira instance. Functions like `currentUser()`, `openSprints()`, `startOfDay()` work in all languages.
+> **Note**: Type, status, and priority names below are in English. Use `jira_list_issue_types()` and `jira_search_fields(search="epic")` to discover actual names for your Jira instance. Functions like `currentUser()`, `openSprints()`, `startOfDay()` work in all languages.
 
 ```jql
 # Find open bugs assigned to you
@@ -1248,7 +1279,7 @@ AND lastModified >= now("-30d")
 
 ### Workflow 2: Sprint Planning
 1. `jira_get_board` - Get board info
-2. `jira_get_sprints` - Find active sprint
+2. `jira_list_sprints` - Find active sprint
 3. `jira_get_sprint_issues` - Review sprint items
 4. `jira_search_issues` - Find candidates for next sprint
 5. `jira_update_issue` - Assign to sprint
@@ -1257,7 +1288,7 @@ AND lastModified >= now("-30d")
 1. `confluence_search_content` - Find existing page
 2. `confluence_get_page` - Read current content (returns bufferId with `structure` element IDs)
 3. `buffer_edit` - Modify content using element IDs (e.g., `after=2`, `replace=5`)
-4. `confluence_draft_create` - Create draft for user review
+4. `confluence_create_draft` - Create draft for user review
 5. User reviews draft at URL
 6. User publishes via Confluence UI (click "Publish" button)
 7. `confluence_add_comment` - Note changes
@@ -1272,10 +1303,10 @@ AND lastModified >= now("-30d")
 6. `jira_link_issues` - Link related issues
 
 ### Workflow 5: Create Page via Draft
-1. `confluence_draft_create` - Create draft + buffer with `structure` (element IDs), get preview URL
+1. `confluence_create_draft` - Create draft + buffer with `structure` (element IDs), get preview URL
 2. Click URL to preview draft in browser
 3. `buffer_edit` - Modify content using element IDs (e.g., `after=1`, `plantuml="..."`)
-4. `confluence_draft_save` - Checkpoint changes, get new URL
+4. `confluence_save_draft` - Checkpoint changes, get new URL
 5. Repeat steps 2-4 as needed
 6. User publishes via Confluence UI (click "Publish" button)
 
@@ -1370,7 +1401,7 @@ AND lastModified >= now("-30d")
 
 ---
 
-### tempo_get_accounts
+### tempo_list_accounts
 **Description**: Get all Tempo accounts
 **Use Cases**: List accounts for time tracking, find account keys
 
@@ -1394,7 +1425,7 @@ AND lastModified >= now("-30d")
 
 ---
 
-### tempo_get_teams
+### tempo_list_teams
 **Description**: Get all Tempo teams
 **Use Cases**: List teams, find team IDs
 
@@ -1500,7 +1531,7 @@ Buffer tools are used for local content management. All buffer operations are in
 ### buffer_create
 **Description**: Create a new buffer with initial content. Returns bufferId and structure.
 
-**TIP**: Call `help(topic="storage")` for XHTML syntax. Call `help(topic="plantuml")` for diagram syntax.
+**TIP**: Call `jicon_help(topic="storage")` for XHTML syntax. Call `jicon_help(topic="plantuml")` for diagram syntax.
 
 **Content types**:
 - **xhtml**: Confluence storage format. Returns element IDs for `buffer_edit`.
@@ -1533,7 +1564,7 @@ buffer_create({ content: [{"key":"PROJ-1"}], contentType: "json" })    // Native
 //    -> returns bufferId, structure: [{id:1, type:"h1", text:"Title"}, {id:2, type:"p", text:"Intro"}]
 // 2. buffer_edit({ bufferId, after: 1, content: "<p>New paragraph</p>" })
 //    -> inserts after h1, returns structure with new element id:3
-// 3. confluence_draft_create({ spaceKey, title, bufferId }) -> user reviews at URL
+// 3. confluence_create_draft({ spaceKey, title, bufferId }) -> user reviews at URL
 // 4. User publishes via Confluence UI (click "Publish" button)
 ```
 
@@ -1545,7 +1576,7 @@ buffer_create({ content: [{"key":"PROJ-1"}], contentType: "json" })    // Native
 //      { after: 2, plantuml: "@startuml\nclass User\n@enduml" }
 //    ]})
 //    -> All PlantUML validated in batch before any changes, rolled back on error
-// 3. confluence_draft_create({ spaceKey, title, bufferId })
+// 3. confluence_create_draft({ spaceKey, title, bufferId })
 // NOTE: Embedding PlantUML macros directly in content is NOT allowed - use plantuml parameter.
 ```
 
@@ -1650,7 +1681,7 @@ buffer_get_element({
 // }
 ```
 
-**Tip**: When `confluence_draft_create` or `confluence_draft_save` fails with an XHTML error, the error response includes `suggestedActions` with a `buffer_get_element` call to inspect the problematic element.
+**Tip**: When `confluence_create_draft` or `confluence_save_draft` fails with an XHTML error, the error response includes `suggestedActions` with a `buffer_get_element` call to inspect the problematic element.
 
 ---
 
@@ -2015,7 +2046,7 @@ buffer_transform({
 2. buffer_transform(inputs, code) → bufferId with XHTML table
 3. confluence_load(pageId) → page bufferId
 4. buffer_edit(pageBufferId, after=ID, fromBufferId=tableBufferId)
-5. confluence_draft_create(pageId, pageBufferId) → draft for review
+5. confluence_create_draft(pageId, pageBufferId) → draft for review
 ```
 
 ---
@@ -2146,7 +2177,7 @@ buffer_edit({
 })
 
 // 4. Create draft linked to original page
-confluence_draft_create({ pageId: "123", bufferId: "buf_A" })
+confluence_create_draft({ pageId: "123", bufferId: "buf_A" })
 // -> Works! bufferId_A originated from pageId 123
 ```
 
@@ -2210,7 +2241,7 @@ buffer_get_structure({ bufferId: "buf_xxx" })
 
 **Response includes**: `valid`, `errorCount`, `warningCount`, `errors`, `warnings`
 
-**Note**: XHTML validation is automatically applied before Confluence write operations (`confluence_draft_create`, `confluence_draft_save`).
+**Note**: XHTML validation is automatically applied before Confluence write operations (`confluence_create_draft`, `confluence_save_draft`).
 
 ---
 
@@ -2233,18 +2264,18 @@ buffer_get_structure({ bufferId: "buf_xxx" })
 | `jira_comment` | `jira_get_issue_comments` |
 | `jira_project` | `jira_list_projects`, `jira_get_project` |
 | `jira_board` | `jira_get_board` |
-| `jira_sprint` | `jira_get_sprints` |
+| `jira_sprint` | `jira_list_sprints` |
 | `jira_worklog` | `jira_get_issue_worklogs` |
 | `jira_worklog_total` | `jira_get_total_worklogs` |
 | `tempo_worklog` | `tempo_get_worklogs`, `tempo_get_worklog`, `tempo_get_team_worklogs`, `tempo_get_epic_worklogs` |
-| `tempo_account` | `tempo_get_accounts`, `tempo_get_account` |
-| `tempo_team` | `tempo_get_teams`, `tempo_get_team` |
+| `tempo_account` | `tempo_list_accounts`, `tempo_get_account` |
+| `tempo_team` | `tempo_list_teams`, `tempo_get_team` |
 | `confluence_page` | `confluence_search_content` |
 | `confluence_page_content` | `confluence_get_pages` |
 | `confluence_space` | `confluence_list_spaces`, `confluence_get_space` |
 | `confluence_comment` | `confluence_get_comments` |
 | `confluence_attachment` | `confluence_list_attachments` |
-| `confluence_draft` | `confluence_draft_list` |
+| `confluence_draft` | `confluence_list_drafts` |
 
 **Response includes**: `bufferId`, `schemaType`, `description`, `itemCount` (for arrays), `legend` (property definitions), `fields` (with type, required, optional, searchable, writable, jqlName, description, sample)
 
@@ -2334,7 +2365,7 @@ Utility tools for time calculations. Always available with any Jira, Confluence,
 
 Utility tools for URL construction and parsing. Always available with any Jira, Confluence, or Tempo action.
 
-### fullurl
+### url_build
 **Description**: Convert Jira issue keys, Confluence page IDs, or relative paths into full URLs
 **Use Cases**: Generate clickable links for display, resolve relative Confluence paths
 
@@ -2356,14 +2387,14 @@ Utility tools for URL construction and parsing. Always available with any Jira,
 
 **Examples**:
 ```typescript
-fullurl("PROJ-123")           // → https://jira.example.com/browse/PROJ-123
-fullurl("123456")             // → https://confluence.example.com/pages/viewpage.action?pageId=123456
-fullurl("/display/DOCS/Home") // → https://confluence.example.com/display/DOCS/Home
+url_build("PROJ-123")           // → https://jira.example.com/browse/PROJ-123
+url_build("123456")             // → https://confluence.example.com/pages/viewpage.action?pageId=123456
+url_build("/display/DOCS/Home") // → https://confluence.example.com/display/DOCS/Home
 ```
 
 ---
 
-### parseurl
+### url_parse
 **Description**: Parse a Jira or Confluence URL to extract identifiers (pageId, issueKey, draftId, etc.)
 **Use Cases**: Extract IDs from URLs users share, prepare input for other tools
 
@@ -2386,11 +2417,11 @@ fullurl("/display/DOCS/Home") // → https://confluence.example.com/display/DOCS
 
 **Workflow**:
 ```
-1. parseurl(url) → extract identifier (check for warning)
+1. url_parse(url) → extract identifier (check for warning)
 2. Use extracted ID with appropriate tool (jira_get_issue, confluence_get_page, confluence_load, etc.)
 ```
 
-**Tip**: `confluence_load` can accept URLs directly and parses them internally, so you can often skip `parseurl` for Confluence workflows.
+**Tip**: `confluence_load` can accept URLs directly and parses them internally, so you can often skip `url_parse` for Confluence workflows.
 
 ---
 
@@ -2398,7 +2429,7 @@ fullurl("/display/DOCS/Home") // → https://confluence.example.com/display/DOCS
 
 Unified help system for all Jicon workflows and syntax guides. Always available with any Jira, Confluence, or Tempo action.
 
-### help
+### jicon_help
 **Description**: Get Jicon MCP Server help - workflows and syntax guides
 **Use Cases**: Learn workflows, understand tool sequences, get syntax references
 
@@ -2412,7 +2443,7 @@ Unified help system for all Jicon workflows and syntax guides. Always available
 - Tempo workflows (log work, get worklogs)
 - LLM-powered analysis tools (activity digest, comments, changelog, epic analysis)
 - Buffer patterns for large responses and editing
-- Utility tools (fullurl, workload_convert)
+- Utility tools (url_build, workload_convert)
 - Decision tree for when to call each topic
 
 **Available Topics**:
@@ -2428,15 +2459,15 @@ Unified help system for all Jicon workflows and syntax guides. Always available
 
 **Examples**:
 ```typescript
-help()                       // Get workflow overview and decision tree
-help(topic="jql")            // JQL syntax guide
-help(topic="storage")        // Basic Confluence formatting
-help(topic="plantuml")       // PlantUML diagram syntax
-help(topic="buffers")        // Buffer management guide
-help(topic="analysis")       // LLM analysis tools guide
+jicon_help()                       // Get workflow overview and decision tree
+jicon_help(topic="jql")            // JQL syntax guide
+jicon_help(topic="storage")        // Basic Confluence formatting
+jicon_help(topic="plantuml")       // PlantUML diagram syntax
+jicon_help(topic="buffers")        // Buffer management guide
+jicon_help(topic="analysis")       // LLM analysis tools guide
 ```
 
-**Tip**: Start with `help()` to understand the overall workflow. For AI analysis tasks (e.g., "What happened on project X?"), check `help(topic="analysis")`.
+**Tip**: Start with `jicon_help()` to understand the overall workflow. For AI analysis tasks (e.g., "What happened on project X?"), check `jicon_help(topic="analysis")`.
 
 ---
 
@@ -2492,11 +2523,11 @@ date_resolve(expression="this_month") // Current month to date
 
 ---
 
-## Whoami Tools (1)
+## Whoami Tools (2)
 
 Unified user identity across all configured services.
 
-### whoami
+### user_whoami
 **Description**: Get the currently authenticated user identity from all configured services
 **Use Cases**: Verify credentials, get user keys for JQL/Tempo queries (assignee, reporter)
 
@@ -2527,6 +2558,29 @@ Unified user identity across all configured services.
 - Errors are collected in `errors` array if any service fails
 - Available in all permission modes (readonly, full, custom)
 
+### user_resolve
+**Description**: Resolve a userkey or username to display name across Jira and Confluence
+**Use Cases**: Look up display names for userkeys found in page content, worklogs, or issue fields
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| userKey | string | Yes | Username or userkey to resolve |
+| source | string | No | `"jira"` or `"confluence"` (auto-detect if omitted) |
+
+**Returns**:
+```json
+{
+  "username": "john.doe",
+  "displayName": "John Doe"
+}
+```
+
+**Notes**:
+- Use `"confluence"` source for Confluence hex userkeys (e.g., `ff8080816ea2c5b3...`)
+- Use `"jira"` source for Jira usernames or JIRAUSER keys
+- Results are cached per session — safe to call repeatedly
+- Available in all permission modes (readonly, full, custom)
+
 ---
 
 ## PlantUML Tools (3)
@@ -2543,7 +2597,7 @@ PlantUML validation and rendering via external server. Configure with `JICON_PLA
 !include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
 !include https://raw.githubusercontent.com/awslabs/aws-icons-for-plantuml/main/dist/AWSCommon.puml
 ```
-Include expansion is enabled by default. Whitelisted URLs: `plantuml-stdlib/*`, `plantuml/*`, `awslabs/aws-icons-for-plantuml/*`. See `help(topic="plantuml")` for examples.
+Include expansion is enabled by default. Whitelisted URLs: `plantuml-stdlib/*`, `plantuml/*`, `awslabs/aws-icons-for-plantuml/*`. See `jicon_help(topic="plantuml")` for examples.
 
 ### plantuml_validate
 **Description**: Validate PlantUML diagram syntax using a real PlantUML server
@@ -2646,9 +2700,9 @@ All data-heavy tools (search, list, get) **always** return buffered responses wi
 - `buffer_grep(bufferId, pattern)` - Search within buffered data
 
 **Always-Buffered Tools:**
-- **Jira**: `jira_search_issues`, `jira_get_issue`, `jira_get_issues`, `jira_list_projects`, `jira_get_project`, `jira_get_board`, `jira_get_sprints`, `jira_get_sprint_issues`, `jira_get_issue_comments`, `jira_get_issue_worklogs`, `jira_get_total_worklogs`
-- **Confluence**: `confluence_search_content`, `confluence_get_pages`, `confluence_list_spaces`, `confluence_get_space`, `confluence_get_comments`, `confluence_list_attachments`, `confluence_draft_list`
-- **Tempo**: `tempo_get_worklogs`, `tempo_get_worklog`, `tempo_get_accounts`, `tempo_get_account`, `tempo_get_teams`, `tempo_get_team`, `tempo_get_team_worklogs`, `tempo_get_epic_worklogs`
+- **Jira**: `jira_search_issues`, `jira_get_issue`, `jira_get_issues`, `jira_list_projects`, `jira_get_project`, `jira_get_board`, `jira_list_sprints`, `jira_get_sprint_issues`, `jira_get_issue_comments`, `jira_get_issue_worklogs`, `jira_get_total_worklogs`
+- **Confluence**: `confluence_search_content`, `confluence_get_pages`, `confluence_list_spaces`, `confluence_get_space`, `confluence_get_comments`, `confluence_list_attachments`, `confluence_list_drafts`
+- **Tempo**: `tempo_get_worklogs`, `tempo_get_worklog`, `tempo_list_accounts`, `tempo_get_account`, `tempo_list_teams`, `tempo_get_team`, `tempo_get_team_worklogs`, `tempo_get_epic_worklogs`
 
 **Buffer Management:**
 - **TTL**: Buffers expire after 1 hour by default; edited buffers reset to 1 day TTL
@@ -2658,20 +2712,20 @@ All data-heavy tools (search, list, get) **always** return buffered responses wi
 ### Buffer Workflows
 
 **Creating new Confluence pages (draft workflow):**
-1. `confluence_draft_create` → creates server draft + buffer with `structure` (element IDs), returns clickable preview URL
+1. `confluence_create_draft` → creates server draft + buffer with `structure` (element IDs), returns clickable preview URL
 2. User clicks URL to review draft in Confluence UI (can edit there)
-3. If changes needed: `confluence_draft_open` → re-reads user's edits into buffer with updated structure
+3. If changes needed: `confluence_open_draft` → re-reads user's edits into buffer with updated structure
 4. `buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId)` → edit using element IDs
-5. `confluence_draft_save` → checkpoint: deletes old draft, creates new with buffer content, returns new URL
+5. `confluence_save_draft` → checkpoint: deletes old draft, creates new with buffer content, returns new URL
 6. Repeat steps 2-5 until user approves
 7. User publishes via Confluence UI (click "Publish" button)
 
 **Editing existing Confluence pages (draft workflow):**
 1. `confluence_load(URL or pageId)` → page content is buffered, returns `bufferId`, `pageId`, `version`, and `structure`
 2. `buffer_edit(bufferId, after=ID, content/plantuml/fromBufferId)` → edit using element IDs
-3. `confluence_draft_create(pageId, bufferId)` → creates draft linked to original page for user review
+3. `confluence_create_draft(pageId, bufferId)` → creates draft linked to original page for user review
 4. User reviews draft at URL
-5. If changes needed: repeat via `confluence_draft_open` → edit → `confluence_draft_save`
+5. If changes needed: repeat via `confluence_open_draft` → edit → `confluence_save_draft`
 6. User publishes via Confluence UI (click "Publish" button)
 
 **Buffer composition (when content created separately):**
@@ -2679,7 +2733,7 @@ If you created content in a separate buffer and need to insert it into a page:
 1. `confluence_load(pageId)` → `bufferId_A` (page buffer with structure)
 2. `buffer_create(content, contentType="xhtml")` → `bufferId_B` (new content)
 3. `buffer_edit(bufferId=bufferId_A, after=5, fromBufferId=bufferId_B)` → merges B into A
-4. `confluence_draft_create(pageId, bufferId=bufferId_A)` → works because bufferId_A originated from pageId
+4. `confluence_create_draft(pageId, bufferId=bufferId_A)` → works because bufferId_A originated from pageId
 
 ### Buffer Content Types
 
@@ -2704,7 +2758,7 @@ Tools enforce type-safe buffer access - each tool only accepts buffers of the ty
 | Buffer Type | Tools That REQUIRE This Type |
 |-------------|------------------------------|
 | **json** | `buffer_transform`, `buffer_get_items` |
-| **xhtml** | `buffer_get_structure`, `buffer_get_element`, `buffer_validate_xhtml`, `confluence_draft_create` (with bufferId), `confluence_draft_save` |
+| **xhtml** | `buffer_get_structure`, `buffer_get_element`, `buffer_validate_xhtml`, `confluence_create_draft` (with bufferId), `confluence_save_draft` |
 | **any** | `buffer_grep`, `buffer_list`, `buffer_clear`, `buffer_edit` (string mode) |
 
 **Error Messages**: When you use a tool with the wrong buffer type, you get a helpful error:
@@ -2744,7 +2798,7 @@ buffer_edit({ bufferId: accumulatorBufferId, after: lastRowId, fromBufferId: bat
 
 // 4. Insert into page and create draft
 buffer_edit({ bufferId: pageBufferId, after: ID, fromBufferId: accumulatorBufferId })
-confluence_draft_create({ pageId, bufferId: pageBufferId })  // → draft for review
+confluence_create_draft({ pageId, bufferId: pageBufferId })  // → draft for review
 ```
 
 ### XHTML Structure Editing
@@ -2856,7 +2910,7 @@ buffer_validate_xhtml({
 - PlantUML syntax (requires PlantUML server - returns error if unavailable)
 
 **Automatic Validation:**
-XHTML content is automatically validated before Confluence writes (`confluence_draft_create`, `confluence_draft_save`).
+XHTML content is automatically validated before Confluence writes (`confluence_create_draft`, `confluence_save_draft`).
 
 ### JSON Transform Workflows
 
@@ -2903,7 +2957,7 @@ confluence_load("DOCS/Bug Report")
 // → { bufferId: "buf_page", pageId: "123", structure: [...] }
 
 buffer_edit({ bufferId: "buf_page", after: 5, fromBufferId: "buf_table" })
-confluence_draft_create({ pageId: "123", bufferId: "buf_page" })
+confluence_create_draft({ pageId: "123", bufferId: "buf_page" })
 // → Draft for user review
 ```
 
@@ -2949,7 +3003,7 @@ buffer_transform({
 
 ### Buffer Lifecycle & Staleness Prevention
 
-**Automatic Invalidation**: When write operations succeed (`confluence_draft_save`, `jira_update_issue`, `tempo_update_worklog`, etc.), any cached buffers for that resource are automatically invalidated.
+**Automatic Invalidation**: When write operations succeed (`confluence_save_draft`, `jira_update_issue`, `tempo_update_worklog`, etc.), any cached buffers for that resource are automatically invalidated.
 
 **Version Conflict Handling**: If a write fails due to a version conflict (HTTP 409), the error includes actionable hints suggesting you re-fetch the resource.
 
@@ -2959,7 +3013,7 @@ buffer_transform({
 
 Drafts allow iterative content development with user confirmation before publishing.
 
-**API Limitation:** Confluence Server/Data Center REST API does not support updating drafts. The `confluence_draft_save` tool works around this by:
+**API Limitation:** Confluence Server/Data Center REST API does not support updating drafts. The `confluence_save_draft` tool works around this by:
 1. Deleting the existing draft
 2. Creating a new draft with the updated content
 3. Returning the new draft ID and URL