first commit

mcp_servers/legacy_tim_mcp/README.md

@@ -0,0 +1,28 @@
+# Legacy TIM MCP Server
+
+Servidor MCP HTTP simples para adaptar os serviços externos do `agent_contas_first` ao contrato esperado pelo `agent_framework_oci`:
+
+- `GET /mcp/tools/list`
+- `POST /mcp/tools/call` com `{ "tool_name": "...", "arguments": {...} }`
+
+Por padrão roda com integração real (`TIM_MCP_USE_MOCK=false`). Para teste local sem APIs TIM, configure explicitamente `TIM_MCP_USE_MOCK=true`.
+
+## Subir local
+
+```bash
+cd mcp_servers/legacy_tim_mcp
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+cp .env.example .env
+uvicorn main:app --host 0.0.0.0 --port 8100 --reload
+```
+
+## Teste direto
+
+```bash
+curl -s http://localhost:8100/health
+curl -s http://localhost:8100/mcp/tools/call \
+  -H 'Content-Type: application/json' \
+  -d '{"tool_name":"consultar_fatura","arguments":{"msisdn":"11999999999","invoice_id":"FAT-2026-06"}}'
+```