sienge-ecbiesek-mcp 1.2.0__py3-none-any.whl → 1.2.2__py3-none-any.whl

{sienge_ecbiesek_mcp-1.2.0.dist-info → sienge_ecbiesek_mcp-1.2.2.dist-info}/METADATA

@@ -1,30 +1,9 @@
 Metadata-Version: 2.4
 Name: sienge-ecbiesek-mcp
-Version: 1.2.0
+Version: 1.2.2
 Summary: 🏗️ Model Context Protocol (MCP) server for Sienge API integration - Brazilian construction ERP system. Connect Claude AI to Sienge with 50+ powerful tools for comprehensive business management including financials, projects, and operations.
 Author-email: ECBIESEK <ti@ecbiesek.com>
-License: MIT License
-        
-        Copyright (c) 2025 Sienge MCP Contributors
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-        
+License: MIT
 Project-URL: Homepage, https://github.com/INOTECH-ecbiesek/Sienge-MCP
 Project-URL: Documentation, https://github.com/INOTECH-ecbiesek/Sienge-MCP#readme
 Project-URL: Repository, https://github.com/INOTECH-ecbiesek/Sienge-MCP.git

sienge_ecbiesek_mcp-1.2.2.dist-info/RECORD

@@ -0,0 +1,11 @@
+sienge_ecbiesek_mcp-1.2.2.dist-info/licenses/LICENSE,sha256=leWD46QLXsQ43M8fE_KgOo5Sf0YB9_X8EVqGdV0Dsc0,1101
+sienge_mcp/__init__.py,sha256=LgXn5BfGLTWmLi5p1JbweikNexTc_1wLHBfGJBxwX7M,297
+sienge_mcp/metadata.py,sha256=wN_XSjUkHJ0QA38CaCtAR7ImsYndSvBPrTmRe8gSLdM,1109
+sienge_mcp/server.py,sha256=2pAJcpF29bjOM4rd6rc-yzWYIdGWjYr5BlVc3pxsD8E,102160
+sienge_mcp/server2.py,sha256=2pAJcpF29bjOM4rd6rc-yzWYIdGWjYr5BlVc3pxsD8E,102160
+sienge_mcp/utils/logger.py,sha256=3Ty7SGcpxAC3vruoRJEK78iZb7wxnDv__EESYQrIMB4,5712
+sienge_ecbiesek_mcp-1.2.2.dist-info/METADATA,sha256=8s5o0xPW1E4d-bp9qL7VZ08bx1JgfhbgTOFIFtXTYdo,11406
+sienge_ecbiesek_mcp-1.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+sienge_ecbiesek_mcp-1.2.2.dist-info/entry_points.txt,sha256=jxEu6gvTw3ci0mjDfqbi0rBLRpeuscwwRk9-H-UOnO8,63
+sienge_ecbiesek_mcp-1.2.2.dist-info/top_level.txt,sha256=FCvuhB9JQPKGY0Q8aKoVc7akqG5htoJyfj-eJvVUmWM,11
+sienge_ecbiesek_mcp-1.2.2.dist-info/RECORD,,

sienge_mcp/__init__.py

@@ -3,7 +3,7 @@ Sienge MCP Server Package
 Model Context Protocol integration for Sienge API
 """
 
-__version__ = "1.0.0"
-__author__ = "Sienge MCP Contributors"
-__email__ = "contributors@sienge-mcp.com"
-__description__ = "Sienge MCP Server - Model Context Protocol integration for Sienge API"
+__version__ = "1.2.2"
+__author__ = "ECBIESEK"
+__email__ = "ti@ecbiesek.com"
+__description__ = "🏗️ Model Context Protocol (MCP) server for Sienge API integration - Brazilian construction ERP system"

sienge_mcp/server.py

@@ -660,7 +660,7 @@ async def _svc_get_purchase_invoices(*, limit: int = 50, date_from: str = None)
 
 
 @mcp.tool
-async def test_sienge_connection() -> Dict:
+async def test_sienge_connection(_meta: Optional[Dict] = None) -> Dict:
     """Testa a conexão com a API do Sienge"""
     try:
         # Usar serviço interno
@@ -701,7 +701,8 @@ async def test_sienge_connection() -> Dict:
 
 @mcp.tool
 async def get_sienge_customers(
-    limit: Optional[int] = 50, offset: Optional[int] = 0, search: Optional[str] = None, customer_type_id: Optional[str] = None
+    limit: Optional[int] = 50, offset: Optional[int] = 0, search: Optional[str] = None, customer_type_id: Optional[str] = None,
+    _meta: Optional[Dict] = None
 ) -> Dict:
     """
     Busca clientes no Sienge com filtros
@@ -750,7 +751,7 @@ async def get_sienge_customers(
 
 
 @mcp.tool
-async def get_sienge_customer_types() -> Dict:
+async def get_sienge_customer_types(_meta: Optional[Dict] = None) -> Dict:
     """Lista tipos de clientes disponíveis"""
     # Usar serviço interno
     result = await _svc_get_customer_types()
@@ -785,8 +786,8 @@ async def get_sienge_customer_types() -> Dict:
 
 @mcp.tool
 async def get_sienge_enterprises(
-    limit: int = 100, offset: int = 0, company_id: int = None, enterprise_type: int = None
-) -> Dict:
+    limit: int = 100, offset: int = 0, company_id: int = None, enterprise_type: int = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     ALIAS: get_sienge_projects → get_sienge_enterprises
     Busca empreendimentos/obras (compatibilidade com checklist)
@@ -803,8 +804,8 @@ async def get_sienge_enterprises(
 async def get_sienge_suppliers(
     limit: int = 50,
     offset: int = 0,
-    search: str = None
-) -> Dict:
+    search: str = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     ALIAS: get_sienge_creditors → get_sienge_suppliers
     Busca fornecedores (compatibilidade com checklist)
@@ -874,8 +875,8 @@ async def search_sienge_finances(
 @mcp.tool
 async def get_sienge_accounts_payable(
     start_date: str = None, end_date: str = None, creditor_id: str = None, 
-    status: str = None, limit: int = 50
-) -> Dict:
+    status: str = None, limit: int = 50,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     ALIAS: get_sienge_bills → get_sienge_accounts_payable
     Busca contas a pagar (compatibilidade com checklist)
@@ -890,7 +891,8 @@ async def get_sienge_accounts_payable(
 
 
 @mcp.tool
-async def list_sienge_purchase_invoices(limit: int = 50, date_from: str = None) -> Dict:
+async def list_sienge_purchase_invoices(limit: int = 50, date_from: str = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Lista notas fiscais de compra (versão list/plural esperada pelo checklist)
     
@@ -929,7 +931,8 @@ async def list_sienge_purchase_invoices(limit: int = 50, date_from: str = None)
 
 
 @mcp.tool
-async def list_sienge_purchase_requests(limit: int = 50, status: str = None) -> Dict:
+async def list_sienge_purchase_requests(limit: int = 50, status: str = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Lista solicitações de compra (versão list/plural esperada pelo checklist)
     
@@ -971,7 +974,8 @@ async def list_sienge_purchase_requests(limit: int = 50, status: str = None) ->
 
 
 @mcp.tool
-async def get_sienge_creditors(limit: Optional[int] = 50, offset: Optional[int] = 0, search: Optional[str] = None) -> Dict:
+async def get_sienge_creditors(limit: Optional[int] = 50, offset: Optional[int] = 0, search: Optional[str] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca credores/fornecedores
 
@@ -1015,7 +1019,8 @@ async def get_sienge_creditors(limit: Optional[int] = 50, offset: Optional[int]
 
 
 @mcp.tool
-async def get_sienge_creditor_bank_info(creditor_id: str) -> Dict:
+async def get_sienge_creditor_bank_info(creditor_id: str,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta informações bancárias de um credor
 
@@ -1061,7 +1066,7 @@ async def get_sienge_accounts_receivable(
     origins_ids: Optional[List[str]] = None,
     bearers_id_in: Optional[List[int]] = None,
     bearers_id_not_in: Optional[List[int]] = None,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta parcelas do contas a receber via API bulk-data
     MELHORADO: Suporte a polling assíncrono para requests 202
@@ -1140,8 +1145,8 @@ async def get_sienge_accounts_receivable(
 
 @mcp.tool
 async def get_sienge_accounts_receivable_by_bills(
-    bills_ids: List[int], correction_indexer_id: Optional[int] = None, correction_date: Optional[str] = None
-) -> Dict:
+    bills_ids: List[int], correction_indexer_id: Optional[int] = None, correction_date: Optional[str] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta parcelas dos títulos informados via API bulk-data
     MELHORADO: Suporte a polling assíncrono para requests 202
@@ -1205,7 +1210,7 @@ async def get_sienge_bills(
     creditor_id: Optional[str] = None,
     status: Optional[str] = None,
     limit: Optional[int] = 50,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta títulos a pagar (contas a pagar) - REQUER startDate obrigatório
 
@@ -1278,7 +1283,7 @@ async def get_sienge_purchase_orders(
     status: Optional[str] = None,
     date_from: Optional[str] = None,
     limit: Optional[int] = 50,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta pedidos de compra
 
@@ -1326,7 +1331,8 @@ async def get_sienge_purchase_orders(
 
 
 @mcp.tool
-async def get_sienge_purchase_order_items(purchase_order_id: str) -> Dict:
+async def get_sienge_purchase_order_items(purchase_order_id: str,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta itens de um pedido de compra específico
 
@@ -1356,7 +1362,8 @@ async def get_sienge_purchase_order_items(purchase_order_id: str) -> Dict:
 
 
 @mcp.tool
-async def get_sienge_purchase_requests(purchase_request_id: Optional[str] = None, limit: Optional[int] = 50) -> Dict:
+async def get_sienge_purchase_requests(purchase_request_id: Optional[str] = None, limit: Optional[int] = 50,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta solicitações de compra
 
@@ -1397,7 +1404,8 @@ async def get_sienge_purchase_requests(purchase_request_id: Optional[str] = None
 
 
 @mcp.tool
-async def create_sienge_purchase_request(description: str, project_id: str, items: List[Dict[str, Any]]) -> Dict:
+async def create_sienge_purchase_request(description: str, project_id: str, items: List[Dict[str, Any]],
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Cria nova solicitação de compra
 
@@ -1440,7 +1448,8 @@ async def create_sienge_purchase_request(description: str, project_id: str, item
 
 
 @mcp.tool
-async def get_sienge_purchase_invoice(sequential_number: int) -> Dict:
+async def get_sienge_purchase_invoice(sequential_number: int,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta nota fiscal de compra por número sequencial
 
@@ -1461,7 +1470,8 @@ async def get_sienge_purchase_invoice(sequential_number: int) -> Dict:
 
 
 @mcp.tool
-async def get_sienge_purchase_invoice_items(sequential_number: int) -> Dict:
+async def get_sienge_purchase_invoice_items(sequential_number: int,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta itens de uma nota fiscal de compra
 
@@ -1502,7 +1512,7 @@ async def create_sienge_purchase_invoice(
     issue_date: str,
     series: Optional[str] = None,
     notes: Optional[str] = None,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Cadastra uma nova nota fiscal de compra
 
@@ -1552,7 +1562,7 @@ async def add_items_to_purchase_invoice(
     copy_notes_purchase_orders: bool = True,
     copy_notes_resources: bool = False,
     copy_attachments_purchase_orders: bool = True,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Insere itens em uma nota fiscal a partir de entregas de pedidos de compra
 
@@ -1603,7 +1613,7 @@ async def get_sienge_purchase_invoices_deliveries_attended(
     purchase_order_item_number: Optional[int] = None,
     limit: Optional[int] = 100,
     offset: Optional[int] = 0,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Lista entregas atendidas entre pedidos de compra e notas fiscais
 
@@ -1657,7 +1667,8 @@ async def get_sienge_purchase_invoices_deliveries_attended(
 
 
 @mcp.tool
-async def get_sienge_stock_inventory(cost_center_id: str, resource_id: Optional[str] = None) -> Dict:
+async def get_sienge_stock_inventory(cost_center_id: str, resource_id: Optional[str] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta inventário de estoque por centro de custo
 
@@ -1694,7 +1705,8 @@ async def get_sienge_stock_inventory(cost_center_id: str, resource_id: Optional[
 
 
 @mcp.tool
-async def get_sienge_stock_reservations(limit: Optional[int] = 50) -> Dict:
+async def get_sienge_stock_reservations(limit: Optional[int] = 50,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Lista reservas de estoque
 
@@ -1734,7 +1746,7 @@ async def get_sienge_projects(
     enterprise_type: Optional[int] = None,
     receivable_register: Optional[str] = None,
     only_buildings_enabled: Optional[bool] = False,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca empreendimentos/obras no Sienge
     CORRIGIDO: Mapeamento correto da chave de resposta
@@ -1792,7 +1804,8 @@ async def get_sienge_projects(
 
 
 @mcp.tool
-async def get_sienge_enterprise_by_id(enterprise_id: int) -> Dict:
+async def get_sienge_enterprise_by_id(enterprise_id: int,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca um empreendimento específico por ID no Sienge
 
@@ -1813,7 +1826,8 @@ async def get_sienge_enterprise_by_id(enterprise_id: int) -> Dict:
 
 
 @mcp.tool
-async def get_sienge_enterprise_groupings(enterprise_id: int) -> Dict:
+async def get_sienge_enterprise_groupings(enterprise_id: int,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca agrupamentos de unidades de um empreendimento específico
 
@@ -1840,7 +1854,8 @@ async def get_sienge_enterprise_groupings(enterprise_id: int) -> Dict:
 
 
 @mcp.tool
-async def get_sienge_units(limit: Optional[int] = 50, offset: Optional[int] = 0) -> Dict:
+async def get_sienge_units(limit: Optional[int] = 50, offset: Optional[int] = 0,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta unidades cadastradas no Sienge
 
@@ -1886,7 +1901,7 @@ async def get_sienge_unit_cost_tables(
     description: Optional[str] = None,
     status: Optional[str] = "Active",
     integration_enabled: Optional[bool] = None,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta tabelas de custos unitários
 
@@ -1934,8 +1949,8 @@ async def search_sienge_data(
     query: str,
     entity_type: Optional[str] = None,
     limit: Optional[int] = 20,
-    filters: Optional[Dict[str, Any]] = None
-) -> Dict:
+    filters: Optional[Dict[str, Any]] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca universal no Sienge - compatível com ChatGPT/OpenAI MCP
     
@@ -2112,7 +2127,7 @@ async def _search_specific_entity(entity_type: str, query: str, limit: int, filt
 
 
 @mcp.tool
-async def list_sienge_entities() -> Dict:
+async def list_sienge_entities(_meta: Optional[Dict] = None) -> Dict:
     """
     Lista todas as entidades disponíveis no Sienge MCP para busca
     
@@ -2206,8 +2221,8 @@ async def get_sienge_data_paginated(
     page: int = 1,
     page_size: int = 20,
     filters: Optional[Dict[str, Any]] = None,
-    sort_by: Optional[str] = None
-) -> Dict:
+    sort_by: Optional[str] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca dados do Sienge com paginação avançada - compatível com ChatGPT
     
@@ -2328,8 +2343,8 @@ async def search_sienge_financial_data(
     search_type: str = "both",
     amount_min: Optional[float] = None,
     amount_max: Optional[float] = None,
-    customer_creditor_search: Optional[str] = None
-) -> Dict:
+    customer_creditor_search: Optional[str] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca avançada em dados financeiros do Sienge - Contas a Pagar e Receber
     
@@ -2479,13 +2494,50 @@ async def search_sienge_financial_data(
         }
 
 
+async def _svc_test_connection() -> Dict:
+    """Serviço interno: testar conexão com a API do Sienge"""
+    try:
+        # Usar serviço interno
+        result = await _svc_get_customer_types()
+
+        if result["success"]:
+            auth_method = "Bearer Token" if SIENGE_API_KEY else "Basic Auth"
+            return {
+                "success": True,
+                "message": "✅ Conexão com API do Sienge estabelecida com sucesso!",
+                "api_status": "Online",
+                "auth_method": auth_method,
+                "timestamp": datetime.now().isoformat(),
+                "request_id": result.get("request_id"),
+                "latency_ms": result.get("latency_ms"),
+                "cache": result.get("cache")
+            }
+        else:
+            return {
+                "success": False,
+                "message": "❌ Falha ao conectar com API do Sienge",
+                "error": result.get("error"),
+                "details": result.get("message"),
+                "timestamp": datetime.now().isoformat(),
+                "request_id": result.get("request_id")
+            }
+    except Exception as e:
+        return {
+            "success": False,
+            "message": "❌ Erro ao testar conexão",
+            "error": str(e),
+            "timestamp": datetime.now().isoformat(),
+        }
+
+
 @mcp.tool
-async def get_sienge_dashboard_summary() -> Dict:
-    """
-    Obtém um resumo tipo dashboard com informações gerais do Sienge
-    Útil para visão geral rápida do sistema
-    """
-    
+async def test_sienge_connection(_meta: Optional[Dict] = None) -> Dict:
+    """Testa a conexão com a API do Sienge"""
+    return await _svc_test_connection()
+
+
+async def _svc_get_dashboard_summary() -> Dict:
+    """Serviço interno: obter resumo do dashboard"""
     # Data atual e períodos
     today = datetime.now()
     current_month_start = today.replace(day=1).strftime("%Y-%m-%d")
@@ -2496,7 +2548,7 @@ async def get_sienge_dashboard_summary() -> Dict:
     
     # 1. Testar conexão
     try:
-        connection_test = await test_sienge_connection()
+        connection_test = await _svc_test_connection()
         dashboard_data["connection"] = connection_test
     except Exception as e:
         errors.append(f"Teste de conexão: {str(e)}")
@@ -2504,16 +2556,14 @@ async def get_sienge_dashboard_summary() -> Dict:
     
     # 2. Contar clientes (amostra)
     try:
-        # CORRIGIDO: Usar serviço interno
         customers_result = await _svc_get_customers(limit=1)
-        dashboard_data["customers"] = {"available": customers_result["success"]}
+        dashboard_data["customers_available"] = customers_result["success"]
     except Exception as e:
         errors.append(f"Clientes: {str(e)}")
-        dashboard_data["customers"] = {"available": False}
+        dashboard_data["customers_available"] = False
     
     # 3. Contar projetos (amostra)
     try:
-        # CORRIGIDO: Usar serviço interno
         projects_result = await _svc_get_projects(limit=5)
         if projects_result["success"]:
             data = projects_result["data"]
@@ -2533,7 +2583,6 @@ async def get_sienge_dashboard_summary() -> Dict:
     
     # 4. Títulos a pagar do mês atual
     try:
-        # CORRIGIDO: Usar serviço interno
         bills_result = await _svc_get_bills(
             start_date=current_month_start,
             end_date=current_month_end,
@@ -2557,7 +2606,6 @@ async def get_sienge_dashboard_summary() -> Dict:
     
     # 5. Tipos de clientes
     try:
-        # CORRIGIDO: Usar serviço interno
         customer_types_result = await _svc_get_customer_types()
         if customer_types_result["success"]:
             data = customer_types_result["data"]
@@ -2594,6 +2642,15 @@ async def get_sienge_dashboard_summary() -> Dict:
     }
 
 
+@mcp.tool
+async def get_sienge_dashboard_summary(_meta: Optional[Dict] = None) -> Dict:
+    """
+    Obtém um resumo tipo dashboard com informações gerais do Sienge
+    Útil para visão geral rápida do sistema
+    """
+    return await _svc_get_dashboard_summary()
+
+
 # ============ UTILITÁRIOS ============
 
 

sienge_mcp/server2.py

@@ -660,7 +660,7 @@ async def _svc_get_purchase_invoices(*, limit: int = 50, date_from: str = None)
 
 
 @mcp.tool
-async def test_sienge_connection() -> Dict:
+async def test_sienge_connection(_meta: Optional[Dict] = None) -> Dict:
     """Testa a conexão com a API do Sienge"""
     try:
         # Usar serviço interno
@@ -701,7 +701,8 @@ async def test_sienge_connection() -> Dict:
 
 @mcp.tool
 async def get_sienge_customers(
-    limit: Optional[int] = 50, offset: Optional[int] = 0, search: Optional[str] = None, customer_type_id: Optional[str] = None
+    limit: Optional[int] = 50, offset: Optional[int] = 0, search: Optional[str] = None, customer_type_id: Optional[str] = None,
+    _meta: Optional[Dict] = None
 ) -> Dict:
     """
     Busca clientes no Sienge com filtros
@@ -750,7 +751,7 @@ async def get_sienge_customers(
 
 
 @mcp.tool
-async def get_sienge_customer_types() -> Dict:
+async def get_sienge_customer_types(_meta: Optional[Dict] = None) -> Dict:
     """Lista tipos de clientes disponíveis"""
     # Usar serviço interno
     result = await _svc_get_customer_types()
@@ -785,8 +786,8 @@ async def get_sienge_customer_types() -> Dict:
 
 @mcp.tool
 async def get_sienge_enterprises(
-    limit: int = 100, offset: int = 0, company_id: int = None, enterprise_type: int = None
-) -> Dict:
+    limit: int = 100, offset: int = 0, company_id: int = None, enterprise_type: int = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     ALIAS: get_sienge_projects → get_sienge_enterprises
     Busca empreendimentos/obras (compatibilidade com checklist)
@@ -803,8 +804,8 @@ async def get_sienge_enterprises(
 async def get_sienge_suppliers(
     limit: int = 50,
     offset: int = 0,
-    search: str = None
-) -> Dict:
+    search: str = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     ALIAS: get_sienge_creditors → get_sienge_suppliers
     Busca fornecedores (compatibilidade com checklist)
@@ -874,8 +875,8 @@ async def search_sienge_finances(
 @mcp.tool
 async def get_sienge_accounts_payable(
     start_date: str = None, end_date: str = None, creditor_id: str = None, 
-    status: str = None, limit: int = 50
-) -> Dict:
+    status: str = None, limit: int = 50,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     ALIAS: get_sienge_bills → get_sienge_accounts_payable
     Busca contas a pagar (compatibilidade com checklist)
@@ -890,7 +891,8 @@ async def get_sienge_accounts_payable(
 
 
 @mcp.tool
-async def list_sienge_purchase_invoices(limit: int = 50, date_from: str = None) -> Dict:
+async def list_sienge_purchase_invoices(limit: int = 50, date_from: str = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Lista notas fiscais de compra (versão list/plural esperada pelo checklist)
     
@@ -929,7 +931,8 @@ async def list_sienge_purchase_invoices(limit: int = 50, date_from: str = None)
 
 
 @mcp.tool
-async def list_sienge_purchase_requests(limit: int = 50, status: str = None) -> Dict:
+async def list_sienge_purchase_requests(limit: int = 50, status: str = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Lista solicitações de compra (versão list/plural esperada pelo checklist)
     
@@ -971,7 +974,8 @@ async def list_sienge_purchase_requests(limit: int = 50, status: str = None) ->
 
 
 @mcp.tool
-async def get_sienge_creditors(limit: Optional[int] = 50, offset: Optional[int] = 0, search: Optional[str] = None) -> Dict:
+async def get_sienge_creditors(limit: Optional[int] = 50, offset: Optional[int] = 0, search: Optional[str] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca credores/fornecedores
 
@@ -1015,7 +1019,8 @@ async def get_sienge_creditors(limit: Optional[int] = 50, offset: Optional[int]
 
 
 @mcp.tool
-async def get_sienge_creditor_bank_info(creditor_id: str) -> Dict:
+async def get_sienge_creditor_bank_info(creditor_id: str,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta informações bancárias de um credor
 
@@ -1061,7 +1066,7 @@ async def get_sienge_accounts_receivable(
     origins_ids: Optional[List[str]] = None,
     bearers_id_in: Optional[List[int]] = None,
     bearers_id_not_in: Optional[List[int]] = None,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta parcelas do contas a receber via API bulk-data
     MELHORADO: Suporte a polling assíncrono para requests 202
@@ -1140,8 +1145,8 @@ async def get_sienge_accounts_receivable(
 
 @mcp.tool
 async def get_sienge_accounts_receivable_by_bills(
-    bills_ids: List[int], correction_indexer_id: Optional[int] = None, correction_date: Optional[str] = None
-) -> Dict:
+    bills_ids: List[int], correction_indexer_id: Optional[int] = None, correction_date: Optional[str] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta parcelas dos títulos informados via API bulk-data
     MELHORADO: Suporte a polling assíncrono para requests 202
@@ -1205,7 +1210,7 @@ async def get_sienge_bills(
     creditor_id: Optional[str] = None,
     status: Optional[str] = None,
     limit: Optional[int] = 50,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta títulos a pagar (contas a pagar) - REQUER startDate obrigatório
 
@@ -1278,7 +1283,7 @@ async def get_sienge_purchase_orders(
     status: Optional[str] = None,
     date_from: Optional[str] = None,
     limit: Optional[int] = 50,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta pedidos de compra
 
@@ -1326,7 +1331,8 @@ async def get_sienge_purchase_orders(
 
 
 @mcp.tool
-async def get_sienge_purchase_order_items(purchase_order_id: str) -> Dict:
+async def get_sienge_purchase_order_items(purchase_order_id: str,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta itens de um pedido de compra específico
 
@@ -1356,7 +1362,8 @@ async def get_sienge_purchase_order_items(purchase_order_id: str) -> Dict:
 
 
 @mcp.tool
-async def get_sienge_purchase_requests(purchase_request_id: Optional[str] = None, limit: Optional[int] = 50) -> Dict:
+async def get_sienge_purchase_requests(purchase_request_id: Optional[str] = None, limit: Optional[int] = 50,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta solicitações de compra
 
@@ -1397,7 +1404,8 @@ async def get_sienge_purchase_requests(purchase_request_id: Optional[str] = None
 
 
 @mcp.tool
-async def create_sienge_purchase_request(description: str, project_id: str, items: List[Dict[str, Any]]) -> Dict:
+async def create_sienge_purchase_request(description: str, project_id: str, items: List[Dict[str, Any]],
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Cria nova solicitação de compra
 
@@ -1440,7 +1448,8 @@ async def create_sienge_purchase_request(description: str, project_id: str, item
 
 
 @mcp.tool
-async def get_sienge_purchase_invoice(sequential_number: int) -> Dict:
+async def get_sienge_purchase_invoice(sequential_number: int,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta nota fiscal de compra por número sequencial
 
@@ -1461,7 +1470,8 @@ async def get_sienge_purchase_invoice(sequential_number: int) -> Dict:
 
 
 @mcp.tool
-async def get_sienge_purchase_invoice_items(sequential_number: int) -> Dict:
+async def get_sienge_purchase_invoice_items(sequential_number: int,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta itens de uma nota fiscal de compra
 
@@ -1502,7 +1512,7 @@ async def create_sienge_purchase_invoice(
     issue_date: str,
     series: Optional[str] = None,
     notes: Optional[str] = None,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Cadastra uma nova nota fiscal de compra
 
@@ -1552,7 +1562,7 @@ async def add_items_to_purchase_invoice(
     copy_notes_purchase_orders: bool = True,
     copy_notes_resources: bool = False,
     copy_attachments_purchase_orders: bool = True,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Insere itens em uma nota fiscal a partir de entregas de pedidos de compra
 
@@ -1603,7 +1613,7 @@ async def get_sienge_purchase_invoices_deliveries_attended(
     purchase_order_item_number: Optional[int] = None,
     limit: Optional[int] = 100,
     offset: Optional[int] = 0,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Lista entregas atendidas entre pedidos de compra e notas fiscais
 
@@ -1657,7 +1667,8 @@ async def get_sienge_purchase_invoices_deliveries_attended(
 
 
 @mcp.tool
-async def get_sienge_stock_inventory(cost_center_id: str, resource_id: Optional[str] = None) -> Dict:
+async def get_sienge_stock_inventory(cost_center_id: str, resource_id: Optional[str] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta inventário de estoque por centro de custo
 
@@ -1694,7 +1705,8 @@ async def get_sienge_stock_inventory(cost_center_id: str, resource_id: Optional[
 
 
 @mcp.tool
-async def get_sienge_stock_reservations(limit: Optional[int] = 50) -> Dict:
+async def get_sienge_stock_reservations(limit: Optional[int] = 50,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Lista reservas de estoque
 
@@ -1734,7 +1746,7 @@ async def get_sienge_projects(
     enterprise_type: Optional[int] = None,
     receivable_register: Optional[str] = None,
     only_buildings_enabled: Optional[bool] = False,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca empreendimentos/obras no Sienge
     CORRIGIDO: Mapeamento correto da chave de resposta
@@ -1792,7 +1804,8 @@ async def get_sienge_projects(
 
 
 @mcp.tool
-async def get_sienge_enterprise_by_id(enterprise_id: int) -> Dict:
+async def get_sienge_enterprise_by_id(enterprise_id: int,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca um empreendimento específico por ID no Sienge
 
@@ -1813,7 +1826,8 @@ async def get_sienge_enterprise_by_id(enterprise_id: int) -> Dict:
 
 
 @mcp.tool
-async def get_sienge_enterprise_groupings(enterprise_id: int) -> Dict:
+async def get_sienge_enterprise_groupings(enterprise_id: int,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca agrupamentos de unidades de um empreendimento específico
 
@@ -1840,7 +1854,8 @@ async def get_sienge_enterprise_groupings(enterprise_id: int) -> Dict:
 
 
 @mcp.tool
-async def get_sienge_units(limit: Optional[int] = 50, offset: Optional[int] = 0) -> Dict:
+async def get_sienge_units(limit: Optional[int] = 50, offset: Optional[int] = 0,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta unidades cadastradas no Sienge
 
@@ -1886,7 +1901,7 @@ async def get_sienge_unit_cost_tables(
     description: Optional[str] = None,
     status: Optional[str] = "Active",
     integration_enabled: Optional[bool] = None,
-) -> Dict:
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Consulta tabelas de custos unitários
 
@@ -1934,8 +1949,8 @@ async def search_sienge_data(
     query: str,
     entity_type: Optional[str] = None,
     limit: Optional[int] = 20,
-    filters: Optional[Dict[str, Any]] = None
-) -> Dict:
+    filters: Optional[Dict[str, Any]] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca universal no Sienge - compatível com ChatGPT/OpenAI MCP
     
@@ -2112,7 +2127,7 @@ async def _search_specific_entity(entity_type: str, query: str, limit: int, filt
 
 
 @mcp.tool
-async def list_sienge_entities() -> Dict:
+async def list_sienge_entities(_meta: Optional[Dict] = None) -> Dict:
     """
     Lista todas as entidades disponíveis no Sienge MCP para busca
     
@@ -2206,8 +2221,8 @@ async def get_sienge_data_paginated(
     page: int = 1,
     page_size: int = 20,
     filters: Optional[Dict[str, Any]] = None,
-    sort_by: Optional[str] = None
-) -> Dict:
+    sort_by: Optional[str] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca dados do Sienge com paginação avançada - compatível com ChatGPT
     
@@ -2328,8 +2343,8 @@ async def search_sienge_financial_data(
     search_type: str = "both",
     amount_min: Optional[float] = None,
     amount_max: Optional[float] = None,
-    customer_creditor_search: Optional[str] = None
-) -> Dict:
+    customer_creditor_search: Optional[str] = None,
+    _meta: Optional[Dict] = None) -> Dict:
     """
     Busca avançada em dados financeiros do Sienge - Contas a Pagar e Receber
     
@@ -2479,13 +2494,50 @@ async def search_sienge_financial_data(
         }
 
 
+async def _svc_test_connection() -> Dict:
+    """Serviço interno: testar conexão com a API do Sienge"""
+    try:
+        # Usar serviço interno
+        result = await _svc_get_customer_types()
+
+        if result["success"]:
+            auth_method = "Bearer Token" if SIENGE_API_KEY else "Basic Auth"
+            return {
+                "success": True,
+                "message": "✅ Conexão com API do Sienge estabelecida com sucesso!",
+                "api_status": "Online",
+                "auth_method": auth_method,
+                "timestamp": datetime.now().isoformat(),
+                "request_id": result.get("request_id"),
+                "latency_ms": result.get("latency_ms"),
+                "cache": result.get("cache")
+            }
+        else:
+            return {
+                "success": False,
+                "message": "❌ Falha ao conectar com API do Sienge",
+                "error": result.get("error"),
+                "details": result.get("message"),
+                "timestamp": datetime.now().isoformat(),
+                "request_id": result.get("request_id")
+            }
+    except Exception as e:
+        return {
+            "success": False,
+            "message": "❌ Erro ao testar conexão",
+            "error": str(e),
+            "timestamp": datetime.now().isoformat(),
+        }
+
+
 @mcp.tool
-async def get_sienge_dashboard_summary() -> Dict:
-    """
-    Obtém um resumo tipo dashboard com informações gerais do Sienge
-    Útil para visão geral rápida do sistema
-    """
-    
+async def test_sienge_connection(_meta: Optional[Dict] = None) -> Dict:
+    """Testa a conexão com a API do Sienge"""
+    return await _svc_test_connection()
+
+
+async def _svc_get_dashboard_summary() -> Dict:
+    """Serviço interno: obter resumo do dashboard"""
     # Data atual e períodos
     today = datetime.now()
     current_month_start = today.replace(day=1).strftime("%Y-%m-%d")
@@ -2496,7 +2548,7 @@ async def get_sienge_dashboard_summary() -> Dict:
     
     # 1. Testar conexão
     try:
-        connection_test = await test_sienge_connection()
+        connection_test = await _svc_test_connection()
         dashboard_data["connection"] = connection_test
     except Exception as e:
         errors.append(f"Teste de conexão: {str(e)}")
@@ -2504,16 +2556,14 @@ async def get_sienge_dashboard_summary() -> Dict:
     
     # 2. Contar clientes (amostra)
     try:
-        # CORRIGIDO: Usar serviço interno
         customers_result = await _svc_get_customers(limit=1)
-        dashboard_data["customers"] = {"available": customers_result["success"]}
+        dashboard_data["customers_available"] = customers_result["success"]
     except Exception as e:
         errors.append(f"Clientes: {str(e)}")
-        dashboard_data["customers"] = {"available": False}
+        dashboard_data["customers_available"] = False
     
     # 3. Contar projetos (amostra)
     try:
-        # CORRIGIDO: Usar serviço interno
         projects_result = await _svc_get_projects(limit=5)
         if projects_result["success"]:
             data = projects_result["data"]
@@ -2533,7 +2583,6 @@ async def get_sienge_dashboard_summary() -> Dict:
     
     # 4. Títulos a pagar do mês atual
     try:
-        # CORRIGIDO: Usar serviço interno
         bills_result = await _svc_get_bills(
             start_date=current_month_start,
             end_date=current_month_end,
@@ -2557,7 +2606,6 @@ async def get_sienge_dashboard_summary() -> Dict:
     
     # 5. Tipos de clientes
     try:
-        # CORRIGIDO: Usar serviço interno
         customer_types_result = await _svc_get_customer_types()
         if customer_types_result["success"]:
             data = customer_types_result["data"]
@@ -2594,6 +2642,15 @@ async def get_sienge_dashboard_summary() -> Dict:
     }
 
 
+@mcp.tool
+async def get_sienge_dashboard_summary(_meta: Optional[Dict] = None) -> Dict:
+    """
+    Obtém um resumo tipo dashboard com informações gerais do Sienge
+    Útil para visão geral rápida do sistema
+    """
+    return await _svc_get_dashboard_summary()
+
+
 # ============ UTILITÁRIOS ============
 
 

sienge_ecbiesek_mcp-1.2.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-sienge_ecbiesek_mcp-1.2.0.dist-info/licenses/LICENSE,sha256=leWD46QLXsQ43M8fE_KgOo5Sf0YB9_X8EVqGdV0Dsc0,1101
-sienge_mcp/__init__.py,sha256=Pjl4hgBCWhVJ_BBZXaP7SuZfH7Z1JWZbSs8MV5sUle8,287
-sienge_mcp/metadata.py,sha256=wN_XSjUkHJ0QA38CaCtAR7ImsYndSvBPrTmRe8gSLdM,1109
-sienge_mcp/server.py,sha256=dAFYZ7G1610JhAqBFTZ1ZXaCPl8cfiq66gK09MC50JY,99522
-sienge_mcp/server2.py,sha256=dAFYZ7G1610JhAqBFTZ1ZXaCPl8cfiq66gK09MC50JY,99522
-sienge_mcp/utils/logger.py,sha256=3Ty7SGcpxAC3vruoRJEK78iZb7wxnDv__EESYQrIMB4,5712
-sienge_ecbiesek_mcp-1.2.0.dist-info/METADATA,sha256=giTZJyOFa04_qgy_245TInCOnTSEchdQ5nzXObVwfh8,12672
-sienge_ecbiesek_mcp-1.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-sienge_ecbiesek_mcp-1.2.0.dist-info/entry_points.txt,sha256=jxEu6gvTw3ci0mjDfqbi0rBLRpeuscwwRk9-H-UOnO8,63
-sienge_ecbiesek_mcp-1.2.0.dist-info/top_level.txt,sha256=FCvuhB9JQPKGY0Q8aKoVc7akqG5htoJyfj-eJvVUmWM,11
-sienge_ecbiesek_mcp-1.2.0.dist-info/RECORD,,