fenix-mcp 1.10.0__py3-none-any.whl → 1.11.1__py3-none-any.whl

fenix_mcp/__init__.py

@@ -8,4 +8,4 @@ Fênix Cloud MCP Server (Python edition).
 __all__ = ["__version__"]
 
 
-__version__ = "1.10.0"
+__version__ = "1.11.1"

fenix_mcp/application/tool_base.py

@@ -70,6 +70,30 @@ MarkdownStr = Annotated[
     ),
 ]
 
+# Mermaid diagram hint for markdown fields
+MERMAID_HINT = """
+💡 **Tip**: You can use Mermaid code blocks to create visual diagrams.
+
+Flowchart example:
+```mermaid
+graph TD
+    A[Start] --> B{Decision}
+    B -->|Yes| C[Action 1]
+    B -->|No| D[Action 2]
+```
+
+Sequence diagram example:
+```mermaid
+sequenceDiagram
+    participant U as User
+    participant A as API
+    U->>A: Request
+    A-->>U: Response
+```
+
+Supported types: flowchart, sequenceDiagram, classDiagram, gantt, pie, mindmap, gitGraph.
+"""
+
 # Short title/name strings (1-300 chars)
 TitleStr = Annotated[
     str,

fenix_mcp/application/tools/intelligence.py

@@ -10,6 +10,7 @@ from pydantic import Field, field_validator
 
 from fenix_mcp.application.presenters import text
 from fenix_mcp.application.tool_base import (
+    MERMAID_HINT,
     CategoryStr,
     DateTimeStr,
     MarkdownStr,
@@ -73,7 +74,7 @@ class IntelligenceRequest(ToolRequest):
     action: IntelligenceAction = Field(description=ACTION_FIELD_DESCRIPTION)
     title: Optional[TitleStr] = Field(default=None, description="Memory title.")
     content: Optional[MarkdownStr] = Field(
-        default=None, description="Memory content/text (Markdown)."
+        default=None, description=f"Memory content/text (Markdown).{MERMAID_HINT}"
     )
     metadata: Optional[MarkdownStr] = Field(
         default=None,

fenix_mcp/application/tools/knowledge.py

@@ -10,6 +10,7 @@ from pydantic import Field
 
 from fenix_mcp.application.presenters import text
 from fenix_mcp.application.tool_base import (
+    MERMAID_HINT,
     CategoryStr,
     DateTimeStr,
     DescriptionStr,
@@ -226,7 +227,7 @@ class KnowledgeRequest(ToolRequest):
     )
     work_title: Optional[TitleStr] = Field(default=None, description="Work item title.")
     work_description: Optional[MarkdownStr] = Field(
-        default=None, description="Work item description (Markdown)."
+        default=None, description=f"Work item description (Markdown).{MERMAID_HINT}"
     )
     work_type: Optional[str] = Field(
         default="task",
@@ -324,7 +325,7 @@ class KnowledgeRequest(ToolRequest):
         default=None, description="Documentation description."
     )
     doc_content: Optional[MarkdownStr] = Field(
-        default=None, description="Documentation content (Markdown)."
+        default=None, description=f"Documentation content (Markdown).{MERMAID_HINT}"
     )
     doc_status: Optional[str] = Field(
         default=None,

fenix_mcp/application/tools/productivity.py

@@ -10,6 +10,7 @@ from pydantic import Field
 
 from fenix_mcp.application.presenters import text
 from fenix_mcp.application.tool_base import (
+    MERMAID_HINT,
     CategoryStr,
     DateTimeStr,
     MarkdownStr,
@@ -77,7 +78,8 @@ class ProductivityRequest(ToolRequest):
         default=None, description="TODO title (required for create)."
     )
     content: Optional[MarkdownStr] = Field(
-        default=None, description="Markdown content (required for create)."
+        default=None,
+        description=f"Markdown content (required for create).{MERMAID_HINT}",
     )
     status: Optional[str] = Field(
         default=None,

fenix_mcp/infrastructure/fenix_api/client.py

@@ -33,7 +33,6 @@ class FenixApiClient:
 
     base_url: str
     personal_access_token: Optional[str]
-    core_documents_token: Optional[str] = None
     timeout: float = 30.0
     _http: HttpClient = field(init=False, repr=False)
 
@@ -71,11 +70,6 @@ class FenixApiClient:
             headers.pop("Authorization", None)
         self._http.default_headers = headers
 
-    def update_core_documents_token(self, token: Optional[str]) -> None:
-        """Update the MCP token used to access public core document endpoints."""
-
-        self.core_documents_token = token
-
     def _build_params(
         self,
         *,
@@ -137,38 +131,16 @@ class FenixApiClient:
         return self._request("GET", "/api/auth/profile")
 
     # ------------------------------------------------------------------
-    # Core documents
+    # Core documents (requires PAT authentication)
     # ------------------------------------------------------------------
 
     def list_core_documents(self, *, return_content: bool = False) -> Any:
-        params = self._build_params(optional={"returnContent": return_content})
-        headers = (
-            {"x-mcp-token": self.core_documents_token}
-            if self.core_documents_token
-            else None
-        )
-        return self._request(
-            "GET", "/api/core-documents/mcp/all", params=params, headers=headers
-        )
-
-    def get_core_document_by_name(
-        self, name: str, *, return_content: bool = False
-    ) -> Any:
-        params = self._build_params(optional={"returnContent": return_content})
-        headers = (
-            {"x-mcp-token": self.core_documents_token}
-            if self.core_documents_token
-            else None
-        )
-        return self._request(
-            "GET", f"/api/core-documents/mcp/{name}", params=params, headers=headers
-        )
-
-    def list_core_documents_auth(self, *, return_content: bool = False) -> Any:
+        """List all core documents. Requires valid PAT."""
         params = self._build_params(optional={"returnContent": return_content})
         return self._request("GET", "/api/core-documents", params=params)
 
     def get_core_document(self, name: str, *, return_content: bool = False) -> Any:
+        """Get a core document by name. Requires valid PAT."""
         params = self._build_params(optional={"returnContent": return_content})
         return self._request("GET", f"/api/core-documents/{name}", params=params)
 

{fenix_mcp-1.10.0.dist-info → fenix_mcp-1.11.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fenix-mcp
-Version: 1.10.0
+Version: 1.11.1
 Summary: Fênix Cloud MCP server implemented in Python
 Author: Fenix Inc
 Requires-Python: >=3.10

{fenix_mcp-1.10.0.dist-info → fenix_mcp-1.11.1.dist-info}/RECORD

@@ -1,14 +1,14 @@
-fenix_mcp/__init__.py,sha256=3PxTTWdV2eIo9b1Kbb5YH180Z0_H6btnEjdqz98JwlQ,181
+fenix_mcp/__init__.py,sha256=wxNxqqpM42ftMbpmNbeurEBsHypAnfgnwhv6pwyRJIw,181
 fenix_mcp/main.py,sha256=iJV-9btNMDJMObvcn7wBQdbLLKjkYCQ1ANGEwHGHlMU,2857
 fenix_mcp/application/presenters.py,sha256=fGME54PdCDhTBhXO-JUB9yLdBHiE1aeXLTC2fCuxnxM,689
-fenix_mcp/application/tool_base.py,sha256=YJk7aSVGjXEvAkXrOHOuUjCFhYni9NPKFyPKiZqkrCc,4235
+fenix_mcp/application/tool_base.py,sha256=ZCb9g4ij5Hbb0410NEZTYXvPWq-Zkg8ZCsinTa3gCY4,4741
 fenix_mcp/application/tool_registry.py,sha256=bPT5g8GfxG_qu28R1WaDOZHvtmG6TPDvZi8eWj1T9xE,1250
 fenix_mcp/application/tools/__init__.py,sha256=Gi1YvYh-KdL9HD8gLVrknHrxiKKEOhHBEZ02KBXJaKQ,796
 fenix_mcp/application/tools/health.py,sha256=m5DxhoRbdwl6INzd6PISxv1NAv-ljCrezsr773VB0wE,834
 fenix_mcp/application/tools/initialize.py,sha256=YfsE3fVYiqGEwvaI_jg5-0K7pGURXxpB3WNwETmGBPc,5499
-fenix_mcp/application/tools/intelligence.py,sha256=fXfjBwAQmZCn3Zc8BqFnQFAJkpd9JsfOPa_uXJj-bMU,15778
-fenix_mcp/application/tools/knowledge.py,sha256=XWi5qac0cXkmnll2Adi3pbiY60I4s-RA3UI5Nowu4ak,61009
-fenix_mcp/application/tools/productivity.py,sha256=wyJ7-2VqgI2cdrliBD_ejwNvQhN1DecpXSQVrCxcUpQ,11231
+fenix_mcp/application/tools/intelligence.py,sha256=wsph1GwiQX3aX5NtFIZlM7I5xo1N3KT-cMlVfZuaHpU,15811
+fenix_mcp/application/tools/knowledge.py,sha256=AQBSispBde0-jAhlKjHrek9FNUaZzqhn293yyocYUQ0,61057
+fenix_mcp/application/tools/productivity.py,sha256=Wmefwg6yuXkHwwQT999d9D4lQf0UY_jnCTDlBe2YRTg,11273
 fenix_mcp/application/tools/user_config.py,sha256=O5AVg7IUKL9uIoUoBSFovBDHl9jofhKWzhFK7CnKi4s,6470
 fenix_mcp/domain/initialization.py,sha256=AZhdSNITQ7O3clELBuqGvjJc-c8pFKc7zQz-XR2xXPc,6933
 fenix_mcp/domain/intelligence.py,sha256=j1kkxT-pjuzLQeAGDd2H8gd3O1aeUIRgHFnMGvNwQYg,8636
@@ -19,11 +19,11 @@ fenix_mcp/infrastructure/config.py,sha256=zhJ3hhsP-bRfICcdq8rIDh5NGDe_u7AGpcgjcc
 fenix_mcp/infrastructure/context.py,sha256=kiDiamiPbHZpTGyZMylcQwtLhfaDXrxAkWSst_DWQNw,470
 fenix_mcp/infrastructure/http_client.py,sha256=QLIPhGYR_cBQGsbIO4RTR6ksyvkQt-OKHQU1JhPyap8,2470
 fenix_mcp/infrastructure/logging.py,sha256=bHrWlSi_0HshRe3--BK_5nzUszW-gh37q6jsd0ShS2Y,1371
-fenix_mcp/infrastructure/fenix_api/client.py,sha256=YIoDIUQdNd7zzt2X3OsgajjxH5Jqb_85A6BvQDN6H6o,28693
+fenix_mcp/infrastructure/fenix_api/client.py,sha256=Sv3hCIFuO0llbv7RDtyLweBNRh82HxZLxDpQVV4UvXg,27709
 fenix_mcp/interface/mcp_server.py,sha256=5UM2NJuNbwHkmCEprIFataJ5nFZiO8efTtP_oW3_iX0,2331
 fenix_mcp/interface/transports.py,sha256=PxdhfjH8UMl03f7nuCLc-M6tMx6-Y-btVz_mSqXKrSI,8138
-fenix_mcp-1.10.0.dist-info/METADATA,sha256=1GZaLx3YrJbSaeeVJ9SzvF4Zdh1fkc67AnpA2SqiLhk,7261
-fenix_mcp-1.10.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fenix_mcp-1.10.0.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
-fenix_mcp-1.10.0.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
-fenix_mcp-1.10.0.dist-info/RECORD,,
+fenix_mcp-1.11.1.dist-info/METADATA,sha256=o_I6x0qfkw0u73O3ow5zkBzDqqf0Zfs-CUNtyUM3sRc,7261
+fenix_mcp-1.11.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fenix_mcp-1.11.1.dist-info/entry_points.txt,sha256=o52x_YHBupEd-1Z1GSfUjv3gJrx5_I-EkHhCgt1WBaE,49
+fenix_mcp-1.11.1.dist-info/top_level.txt,sha256=2G1UtKpwjaIGQyE7sRoHecxaGLeuexfjrOUjv9DDKh4,10
+fenix_mcp-1.11.1.dist-info/RECORD,,