@crypto512/jicon-mcp 2.2.1 → 2.3.19

package/PROMPT.md

@@ -1,33 +1,15 @@
 # Jicon MCP Agent Prompt
 
-You are an assistant with access to the Jicon MCP server for Jira, Confluence, and Tempo operations.
+You are an assistant with access to Jicon MCP server for Jira, Confluence, and Tempo.
 
-## Before ANY Operation: Call Help
+## Before ANY Operation
 
-**Always start by reading the help documentation:**
+**Always call help() first** to get the workflow guide and decision tree.
 
-```
-help()  ← Returns workflow decision tree and quick reference
-```
-
-Then use topic-specific help for your task:
-
-| Task | Help Command |
-|------|--------------|
-| Search Jira | `help(topic="jql")` |
-| Search Confluence | `help(topic="cql")` |
-| Edit Confluence pages | `help(topic="buffers")` then `help(topic="storage")` |
-| PlantUML diagrams | `help(topic="plantuml")` |
-
-## Available Topics
-
-| Topic | Content |
-|-------|---------|
-| (none) | Workflow decision tree, core patterns |
-| `jql` | Jira Query Language syntax |
-| `cql` | Confluence Query Language syntax |
-| `storage` | Confluence XHTML format |
-| `plantuml` | PlantUML validation workflow |
-| `buffers` | Element ID system, buffer operations |
-
-The help system provides complete guidance for all operations. Read it before proceeding.
+For specific syntax, use topic-specific help:
+- `help(topic="jql")` - Jira queries
+- `help(topic="cql")` - Confluence queries
+- `help(topic="storage")` - XHTML format
+- `help(topic="plantuml")` - Diagrams
+- `help(topic="buffers")` - Buffer editing
+- `help(topic="analysis")` - AI analysis tools

package/README.md

@@ -140,10 +140,14 @@ All configuration is done through environment variables.
 | `JICON_CONFLUENCE_WRITE_HOME` | `true`\|`false` | `false` | Restrict Confluence writes to personal space |
 | `JICON_PLANTUML_SERVER_URL` | string | - | PlantUML server URL (e.g., `http://localhost:8080`) |
 | `JICON_MAX_OUTPUT` | number | `16000` | Maximum output characters |
+| `JICON_MAX_BUFFER_SIZE` | number (KB) | `10240` | Maximum buffer size in KB (10 MB). Arrays truncated cleanly. |
+| `JICON_MAX_API_RESULTS` | number | `5000` | Maximum items fetched from any paginated API call |
+| `JICON_DEFAULT_PERIOD` | string | `30d` | Default time period for activity tools (e.g., `7d`, `30d`, `365d`) |
 | `JICON_TRANSPORT` | `stdio`\|`http` | `stdio` | Transport mode (use `http` for containers) |
 | `JICON_HTTP_PORT` | number | `3000` | HTTP server port |
 | `JICON_HTTP_HOST` | string | `0.0.0.0` | HTTP bind address |
 | `JICON_HTTP_BASE_PATH` | string | `/mcp` | MCP endpoint path |
+| `JICON_LOG_LEVEL` | `error`\|`warn`\|`info`\|`debug` | `info` | Log verbosity level. Use `debug` for troubleshooting. |
 
 **Note:** Tempo uses the same Jira credentials - no separate configuration needed.
 
@@ -325,6 +329,8 @@ docker-compose logs -f
 | `JICON_HTTP_HOST` | `0.0.0.0` | HTTP bind address |
 | `JICON_HTTP_BASE_PATH` | `/mcp` | MCP endpoint path |
 
+**Note:** Sessions are automatically cleaned up after 1 hour of inactivity (no tool calls). MCP clients should set their `timeout` based on expected tool execution time (e.g., 5 minutes for most operations).
+
 ### HTTP Endpoints
 
 | Endpoint | Method | Description |
@@ -438,13 +444,13 @@ This achieves "draft before publish" semantics within API constraints.
 
 ## Features
 
-### 75 Tools Across 3 Services
+### 84 Tools Across 3 Services
 
 | Service | Capabilities |
 |---------|--------------|
-| **Jira** (22 tools) | Search, create, update, transition issues; manage comments, links, watchers; access boards, sprints, worklogs; **LLM-powered analysis** |
-| **Confluence** (21 tools) | Search, create, edit pages via drafts; manage spaces, comments, attachments; PlantUML diagrams; review workflow |
-| **Tempo** (12 tools) | Log time, view/update worklogs, team tracking, accounts |
+| **Jira** (29 tools) | Search, create, update, transition issues; manage comments, links, watchers; access boards, sprints, worklogs; user search; **LLM-powered analysis** |
+| **Confluence** (20 tools) | Search, create, edit pages via drafts; manage spaces, comments, attachments; PlantUML diagrams; review workflow |
+| **Tempo** (13 tools) | Log time, view/update worklogs, team tracking, accounts |
 
 Plus utility tools for content buffering, time calculations, URL generation, date resolution, and built-in help.
 
@@ -467,8 +473,9 @@ All data-heavy tools (search, list, get) return **buffered responses** for effic
 
 **Buffer capabilities:**
 - Read content in chunks or search within buffered data
-- Server-side data transformation: filtering, grouping, sorting, aggregations
-- Export to multiple formats: XHTML tables, lists, CSV, JSON, Markdown
+- JavaScript-based transformation: write custom code to filter, transform, aggregate data
+- Built-in helpers: groupBy, sum, avg, min, max, unique, date utilities
+- Generate Confluence tables and lists with auto-linking and conditional formatting
 - Track buffer origin with metadata (resource type, query, title)
 
 ### Safe Confluence Editing (Review Workflow)
@@ -496,6 +503,32 @@ Create and validate UML diagrams directly in Confluence pages. Configure `JICON_
 
 For complete tool documentation with parameters and examples, see **[TOOL_LIST.md](TOOL_LIST.md)**.
 
+## Troubleshooting
+
+### Debug Mode
+
+Enable debug logging to diagnose API issues:
+
+```json
+{
+  "env": {
+    "JICON_LOG_LEVEL": "debug"
+  }
+}
+```
+
+This logs all requests and responses to stderr with timestamps and `[DEBUG]` prefix:
+- Request method, URL, headers (tokens masked), and body
+- Response status, headers, and body (truncated for large responses)
+
+**Note:** Debug output may include sensitive information. Only enable for troubleshooting.
+
+### Other Hidden Options
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `JICON_KEEP_NULLS` | `false` | Preserve null values in JSON responses (increases token usage) |
+
 ## Security
 
 - Store credentials in environment variables, not in code