decodingtrust-agent-sdk 0.1.0__py3-none-any.whl

dt_arena/mcp_server/telecom/mcp_server.py

@@ -0,0 +1,1059 @@
+#!/usr/bin/env python3
+"""
+Telecom MCP Server
+Model Context Protocol (MCP) server for comprehensive telecom operations.
+Provides tools for managing customers, accounts, bills, orders, tickets, SMS, emails, outages, and calendar events.
+Interacts with the telecom Flask server via HTTP requests.
+"""
+import os
+import sys
+import requests
+from typing import Any, Dict
+
+from fastmcp import FastMCP
+
+
+# Telecom server configuration
+timeout = 30
+TELECOM_HOST = os.getenv("TELECOM_HOST", "localhost")
+TELECOM_PORT = os.getenv("TELECOM_PORT", "10301")
+
+# Create FastMCP server instance
+mcp = FastMCP("Telecom Server")
+
+
+def send_request(endpoint: str, params: dict = None) -> dict:
+    """Send GET request to telecom server."""
+    url = f"http://{TELECOM_HOST}:{TELECOM_PORT}/{endpoint}"
+    resp = requests.get(url, params=params, timeout=timeout)
+    return resp.json()
+
+
+def send_post_request(endpoint: str, data: dict) -> dict:
+    """Send POST request to telecom server."""
+    url = f"http://{TELECOM_HOST}:{TELECOM_PORT}/{endpoint}"
+    resp = requests.post(url, json=data, timeout=timeout)
+    return resp.json()
+
+
+# ============================================================================
+# CUSTOMER TOOLS
+# ============================================================================
+
+@mcp.tool(name="query_customer")
+def query_customer(customer_id: str) -> dict:
+    """
+    Query customer information by customer ID.
+    
+    Args:
+        customer_id: The customer ID to query
+    
+    Returns:
+        Dictionary with customer information or error message
+    """
+    return send_request("query_customer", params={"id": customer_id})
+
+
+@mcp.tool(name="add_customer")
+def add_customer(data: Dict[str, Any]) -> dict:
+    """
+    Add a new customer record.
+    
+    Args:
+        data: Dictionary with customer record fields. Required fields typically include:
+            - id (str): Customer ID (unique identifier)
+            - name (str): Customer name
+            - email (str): Customer email address
+            - phone (str): Customer phone number
+            - address (str): Customer address
+            - city (str): City
+            - state (str): State
+            - zip_code (str): ZIP code
+            - country (str): Country
+            - status (str): Customer status (e.g., "active", "inactive")
+            Additional fields may be required based on the CSV schema.
+    
+    Returns:
+        Dictionary with success or error message
+    
+    Example:
+        add_customer({
+            "id": "CUST001",
+            "name": "John Doe",
+            "email": "john@example.com",
+            "phone": "555-1234",
+            "address": "123 Main St",
+            "city": "San Francisco",
+            "state": "CA",
+            "zip_code": "94102",
+            "country": "USA",
+            "status": "active"
+        })
+    """
+    return send_post_request("add_customer", data)
+
+
+@mcp.tool(name="remove_customer")
+def remove_customer(customer_id: str) -> dict:
+    """
+    Remove a customer record by customer ID.
+    
+    Args:
+        customer_id: The customer ID to remove
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    return send_post_request("remove_customer", {"id": customer_id})
+
+
+@mcp.tool(name="update_customer")
+def update_customer(
+    customer_id: str,
+    field: str = None,
+    value: Any = None,
+    updates: dict = None
+) -> dict:
+    """
+    Update a customer record by customer ID.
+    
+    Args:
+        customer_id: The customer ID to update
+        field: Single field name to update (use with value)
+        value: Value to set for the field
+        updates: Dictionary of field:value pairs to update
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    data = {"id": customer_id}
+    if updates:
+        data["updates"] = updates
+    elif field:
+        data["field"] = field
+        data["value"] = value
+    return send_post_request("update_customer", data)
+
+
+# ============================================================================
+# ACCOUNT TOOLS
+# ============================================================================
+
+@mcp.tool(name="query_account")
+def query_account(customer_id: str) -> dict:
+    """
+    Query account information by customer ID.
+    
+    Args:
+        customer_id: The customer ID to query account for
+    
+    Returns:
+        Dictionary with account information or error message
+    """
+    return send_request("query_account", params={"customer_id": customer_id})
+
+
+@mcp.tool(name="add_account")
+def add_account(data: Dict[str, Any]) -> dict:
+    """
+    Add a new account record.
+    
+    Args:
+        data: Dictionary with account record fields. Required fields typically include:
+            - customer_id (str): Customer ID (foreign key, required)
+            - account_number (str): Account number
+            - account_type (str): Type of account (e.g., "mobile", "internet", "landline")
+            - plan (str): Service plan name
+            - status (str): Account status (e.g., "active", "suspended", "cancelled")
+            - activation_date (str): Account activation date
+            - balance (str/float): Current account balance
+            Additional fields may be required based on the CSV schema.
+    
+    Returns:
+        Dictionary with success or error message
+    
+    Example:
+        add_account({
+            "customer_id": "CUST001",
+            "account_number": "ACC123456",
+            "account_type": "mobile",
+            "plan": "Premium",
+            "status": "active",
+            "activation_date": "2024-01-15",
+            "balance": "0.00"
+        })
+    """
+    return send_post_request("add_account", data)
+
+
+@mcp.tool(name="remove_account")
+def remove_account(customer_id: str) -> dict:
+    """
+    Remove an account record by customer ID.
+    
+    Args:
+        customer_id: The customer ID whose account to remove
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    return send_post_request("remove_account", {"customer_id": customer_id})
+
+
+@mcp.tool(name="update_account")
+def update_account(
+    customer_id: str,
+    field: str = None,
+    value: Any = None,
+    updates: dict = None
+) -> dict:
+    """
+    Update an account record by customer ID.
+    
+    Args:
+        customer_id: The customer ID whose account to update
+        field: Single field name to update (use with value)
+        value: Value to set for the field
+        updates: Dictionary of field:value pairs to update
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    data = {"customer_id": customer_id}
+    if updates:
+        data["updates"] = updates
+    elif field:
+        data["field"] = field
+        data["value"] = value
+    return send_post_request("update_account", data)
+
+
+# ============================================================================
+# BILL TOOLS
+# ============================================================================
+
+@mcp.tool(name="query_bill")
+def query_bill(customer_id: str) -> dict:
+    """
+    Query bill information by customer ID.
+    
+    Args:
+        customer_id: The customer ID to query bills for
+    
+    Returns:
+        Dictionary with bill information or error message
+    """
+    return send_request("query_bill", params={"customer_id": customer_id})
+
+
+@mcp.tool(name="add_bill")
+def add_bill(data: Dict[str, Any]) -> dict:
+    """
+    Add a new bill record.
+    
+    Args:
+        data: Dictionary with bill record fields. Required fields typically include:
+            - customer_id (str): Customer ID (foreign key, required)
+            - bill_id (str): Bill ID (unique identifier)
+            - bill_date (str): Bill date
+            - due_date (str): Due date
+            - amount (str/float): Bill amount
+            - status (str): Payment status (e.g., "paid", "unpaid", "overdue")
+            - service_period (str): Service period covered by the bill
+            Additional fields may be required based on the CSV schema.
+    
+    Returns:
+        Dictionary with success or error message
+    
+    Example:
+        add_bill({
+            "customer_id": "CUST001",
+            "bill_id": "BILL001",
+            "bill_date": "2024-01-01",
+            "due_date": "2024-01-31",
+            "amount": "99.99",
+            "status": "unpaid",
+            "service_period": "2024-01"
+        })
+    """
+    return send_post_request("add_bill", data)
+
+
+@mcp.tool(name="remove_bill")
+def remove_bill(customer_id: str) -> dict:
+    """
+    Remove a bill record by customer ID.
+    
+    Args:
+        customer_id: The customer ID whose bill to remove
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    return send_post_request("remove_bill", {"customer_id": customer_id})
+
+
+@mcp.tool(name="update_bill")
+def update_bill(
+    customer_id: str,
+    field: str = None,
+    value: Any = None,
+    updates: dict = None
+) -> dict:
+    """
+    Update a bill record by customer ID.
+    
+    Args:
+        customer_id: The customer ID whose bill to update
+        field: Single field name to update (use with value)
+        value: Value to set for the field
+        updates: Dictionary of field:value pairs to update
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    data = {"customer_id": customer_id}
+    if updates:
+        data["updates"] = updates
+    elif field:
+        data["field"] = field
+        data["value"] = value
+    return send_post_request("update_bill", data)
+
+
+# ============================================================================
+# CALENDAR EVENT TOOLS
+# ============================================================================
+
+@mcp.tool(name="query_calendar_event")
+def query_calendar_event(event_id: str) -> dict:
+    """
+    Query calendar event information by event ID.
+    
+    Args:
+        event_id: The calendar event ID to query
+    
+    Returns:
+        Dictionary with calendar event information or error message
+    """
+    return send_request("query_calendar_event", params={"id": event_id})
+
+
+@mcp.tool(name="add_calendar_event")
+def add_calendar_event(data: Dict[str, Any]) -> dict:
+    """
+    Add a new calendar event record.
+    
+    Args:
+        data: Dictionary with calendar event record fields. Required fields typically include:
+            - id (str): Event ID (unique identifier)
+            - title (str): Event title
+            - description (str): Event description
+            - start_date (str): Event start date/time
+            - end_date (str): Event end date/time
+            - location (str): Event location
+            - attendees (str): Comma-separated list of attendees
+            - event_type (str): Type of event (e.g., "meeting", "appointment", "call")
+            Additional fields may be required based on the CSV schema.
+    
+    Returns:
+        Dictionary with success or error message
+    
+    Example:
+        add_calendar_event({
+            "id": "EVT001",
+            "title": "Customer Meeting",
+            "description": "Discuss service upgrade",
+            "start_date": "2024-02-01 10:00:00",
+            "end_date": "2024-02-01 11:00:00",
+            "location": "Office",
+            "attendees": "john@example.com,jane@example.com",
+            "event_type": "meeting"
+        })
+    """
+    return send_post_request("add_calendar_event", data)
+
+
+@mcp.tool(name="remove_calendar_event")
+def remove_calendar_event(event_id: str) -> dict:
+    """
+    Remove a calendar event record by event ID.
+    
+    Args:
+        event_id: The calendar event ID to remove
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    return send_post_request("remove_calendar_event", {"id": event_id})
+
+
+@mcp.tool(name="update_calendar_event")
+def update_calendar_event(
+    event_id: str,
+    field: str = None,
+    value: Any = None,
+    updates: dict = None
+) -> dict:
+    """
+    Update a calendar event record by event ID.
+    
+    Args:
+        event_id: The calendar event ID to update
+        field: Single field name to update (use with value)
+        value: Value to set for the field
+        updates: Dictionary of field:value pairs to update
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    data = {"id": event_id}
+    if updates:
+        data["updates"] = updates
+    elif field:
+        data["field"] = field
+        data["value"] = value
+    return send_post_request("update_calendar_event", data)
+
+
+# ============================================================================
+# EMAIL TOOLS
+# ============================================================================
+
+@mcp.tool(name="query_email")
+def query_email(email_id: str) -> dict:
+    """
+    Query email information by email ID.
+    
+    Args:
+        email_id: The email ID to query
+    
+    Returns:
+        Dictionary with email information or error message
+    """
+    return send_request("query_email", params={"id": email_id})
+
+
+@mcp.tool(name="add_email")
+def add_email(data: Dict[str, Any]) -> dict:
+    """
+    Add a new email record.
+    
+    Args:
+        data: Dictionary with email record fields. Required fields typically include:
+            - id (str): Email ID (unique identifier)
+            - from_address (str): Sender email address
+            - to_address (str): Recipient email address(es)
+            - subject (str): Email subject
+            - body (str): Email body/content
+            - date (str): Email date/time
+            - status (str): Email status (e.g., "sent", "received", "draft")
+            - customer_id (str): Associated customer ID (if applicable)
+            Additional fields may be required based on the CSV schema.
+    
+    Returns:
+        Dictionary with success or error message
+    
+    Example:
+        add_email({
+            "id": "EMAIL001",
+            "from_address": "support@telecom.com",
+            "to_address": "customer@example.com",
+            "subject": "Service Update",
+            "body": "Your service has been updated.",
+            "date": "2024-01-15 14:30:00",
+            "status": "sent",
+            "customer_id": "CUST001"
+        })
+    """
+    return send_post_request("add_email", data)
+
+
+@mcp.tool(name="remove_email")
+def remove_email(email_id: str) -> dict:
+    """
+    Remove an email record by email ID.
+    
+    Args:
+        email_id: The email ID to remove
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    return send_post_request("remove_email", {"id": email_id})
+
+
+@mcp.tool(name="update_email")
+def update_email(
+    email_id: str,
+    field: str = None,
+    value: Any = None,
+    updates: dict = None
+) -> dict:
+    """
+    Update an email record by email ID.
+    
+    Args:
+        email_id: The email ID to update
+        field: Single field name to update (use with value)
+        value: Value to set for the field
+        updates: Dictionary of field:value pairs to update
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    data = {"id": email_id}
+    if updates:
+        data["updates"] = updates
+    elif field:
+        data["field"] = field
+        data["value"] = value
+    return send_post_request("update_email", data)
+
+
+# ============================================================================
+# ORDER TOOLS
+# ============================================================================
+
+@mcp.tool(name="query_order")
+def query_order(order_id: str) -> dict:
+    """
+    Query order information by order ID.
+    
+    Args:
+        order_id: The order ID to query
+    
+    Returns:
+        Dictionary with order information or error message
+    """
+    return send_request("query_order", params={"order_id": order_id})
+
+
+@mcp.tool(name="add_order")
+def add_order(data: Dict[str, Any]) -> dict:
+    """
+    Add a new order record.
+    
+    Args:
+        data: Dictionary with order record fields. Required fields typically include:
+            - order_id (str): Order ID (unique identifier)
+            - customer_id (str): Customer ID (foreign key)
+            - order_date (str): Order date
+            - product (str): Product/service ordered
+            - quantity (str/int): Quantity ordered
+            - price (str/float): Order price
+            - status (str): Order status (e.g., "pending", "completed", "cancelled")
+            - delivery_date (str): Expected delivery date
+            Additional fields may be required based on the CSV schema.
+    
+    Returns:
+        Dictionary with success or error message
+    
+    Example:
+        add_order({
+            "order_id": "ORD001",
+            "customer_id": "CUST001",
+            "order_date": "2024-01-15",
+            "product": "Premium Plan",
+            "quantity": "1",
+            "price": "99.99",
+            "status": "pending",
+            "delivery_date": "2024-01-20"
+        })
+    """
+    return send_post_request("add_order", data)
+
+
+@mcp.tool(name="remove_order")
+def remove_order(order_id: str) -> dict:
+    """
+    Remove an order record by order ID.
+    
+    Args:
+        order_id: The order ID to remove
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    return send_post_request("remove_order", {"order_id": order_id})
+
+
+@mcp.tool(name="update_order")
+def update_order(
+    order_id: str,
+    field: str = None,
+    value: Any = None,
+    updates: dict = None
+) -> dict:
+    """
+    Update an order record by order ID.
+    
+    Args:
+        order_id: The order ID to update
+        field: Single field name to update (use with value)
+        value: Value to set for the field
+        updates: Dictionary of field:value pairs to update
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    data = {"order_id": order_id}
+    if updates:
+        data["updates"] = updates
+    elif field:
+        data["field"] = field
+        data["value"] = value
+    return send_post_request("update_order", data)
+
+
+# ============================================================================
+# OUTAGE TOOLS
+# ============================================================================
+
+@mcp.tool(name="query_outage")
+def query_outage(area: str) -> dict:
+    """
+    Query outage information by area.
+    
+    Args:
+        area: The area to query outages for
+    
+    Returns:
+        Dictionary with outage information or error message
+    """
+    return send_request("query_outage", params={"area": area})
+
+
+@mcp.tool(name="add_outage")
+def add_outage(data: Dict[str, Any]) -> dict:
+    """
+    Add a new outage record.
+    
+    Args:
+        data: Dictionary with outage record fields. Required fields typically include:
+            - area (str): Affected area (unique identifier)
+            - start_time (str): Outage start time
+            - end_time (str): Outage end time (if resolved)
+            - status (str): Outage status (e.g., "active", "resolved", "scheduled")
+            - description (str): Outage description
+            - affected_customers (str/int): Number of affected customers
+            - severity (str): Severity level (e.g., "low", "medium", "high", "critical")
+            Additional fields may be required based on the CSV schema.
+    
+    Returns:
+        Dictionary with success or error message
+    
+    Example:
+        add_outage({
+            "area": "Downtown",
+            "start_time": "2024-01-15 10:00:00",
+            "end_time": "2024-01-15 12:00:00",
+            "status": "resolved",
+            "description": "Power outage affecting service",
+            "affected_customers": "150",
+            "severity": "high"
+        })
+    """
+    return send_post_request("add_outage", data)
+
+
+@mcp.tool(name="remove_outage")
+def remove_outage(area: str) -> dict:
+    """
+    Remove an outage record by area.
+    
+    Args:
+        area: The area whose outage to remove
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    return send_post_request("remove_outage", {"area": area})
+
+
+@mcp.tool(name="update_outage")
+def update_outage(
+    area: str,
+    field: str = None,
+    value: Any = None,
+    updates: dict = None
+) -> dict:
+    """
+    Update an outage record by area.
+    
+    Args:
+        area: The area whose outage to update
+        field: Single field name to update (use with value)
+        value: Value to set for the field
+        updates: Dictionary of field:value pairs to update
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    data = {"area": area}
+    if updates:
+        data["updates"] = updates
+    elif field:
+        data["field"] = field
+        data["value"] = value
+    return send_post_request("update_outage", data)
+
+
+# ============================================================================
+# SMS TOOLS
+# ============================================================================
+
+@mcp.tool(name="query_sms")
+def query_sms(sms_id: str) -> dict:
+    """
+    Query SMS log information by SMS ID.
+    
+    Args:
+        sms_id: The SMS ID to query
+    
+    Returns:
+        Dictionary with SMS information or error message
+    """
+    return send_request("query_sms", params={"id": sms_id})
+
+
+@mcp.tool(name="add_sms")
+def add_sms(data: Dict[str, Any]) -> dict:
+    """
+    Add a new SMS log record.
+    
+    Args:
+        data: Dictionary with SMS record fields. Required fields typically include:
+            - id (str): SMS ID (unique identifier)
+            - from_number (str): Sender phone number
+            - to_number (str): Recipient phone number
+            - message (str): SMS message content
+            - date (str): SMS date/time
+            - status (str): SMS status (e.g., "sent", "received", "delivered", "failed")
+            - customer_id (str): Associated customer ID (if applicable)
+            Additional fields may be required based on the CSV schema.
+    
+    Returns:
+        Dictionary with success or error message
+    
+    Example:
+        add_sms({
+            "id": "SMS001",
+            "from_number": "+15551234567",
+            "to_number": "+15559876543",
+            "message": "Your service has been activated.",
+            "date": "2024-01-15 14:30:00",
+            "status": "sent",
+            "customer_id": "CUST001"
+        })
+    """
+    return send_post_request("add_sms", data)
+
+
+@mcp.tool(name="remove_sms")
+def remove_sms(sms_id: str) -> dict:
+    """
+    Remove an SMS log record by SMS ID.
+    
+    Args:
+        sms_id: The SMS ID to remove
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    return send_post_request("remove_sms", {"id": sms_id})
+
+
+@mcp.tool(name="update_sms")
+def update_sms(
+    sms_id: str,
+    field: str = None,
+    value: Any = None,
+    updates: dict = None
+) -> dict:
+    """
+    Update an SMS log record by SMS ID.
+    
+    Args:
+        sms_id: The SMS ID to update
+        field: Single field name to update (use with value)
+        value: Value to set for the field
+        updates: Dictionary of field:value pairs to update
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    data = {"id": sms_id}
+    if updates:
+        data["updates"] = updates
+    elif field:
+        data["field"] = field
+        data["value"] = value
+    return send_post_request("update_sms", data)
+
+
+# ============================================================================
+# TICKET TOOLS
+# ============================================================================
+
+@mcp.tool(name="query_ticket")
+def query_ticket(ticket_id: str) -> dict:
+    """
+    Query ticket information by ticket ID.
+    
+    Args:
+        ticket_id: The ticket ID to query
+    
+    Returns:
+        Dictionary with ticket information or error message
+    """
+    return send_request("query_ticket", params={"id": ticket_id})
+
+
+@mcp.tool(name="add_ticket")
+def add_ticket(data: Dict[str, Any]) -> dict:
+    """
+    Add a new ticket record.
+    
+    Args:
+        data: Dictionary with ticket record fields. Required fields typically include:
+            - id (str): Ticket ID (unique identifier)
+            - customer_id (str): Customer ID (foreign key)
+            - subject (str): Ticket subject
+            - description (str): Ticket description/issue details
+            - status (str): Ticket status (e.g., "open", "in_progress", "resolved", "closed")
+            - priority (str): Priority level (e.g., "low", "medium", "high", "urgent")
+            - created_date (str): Ticket creation date/time
+            - assigned_to (str): Agent/user assigned to the ticket
+            - resolution (str): Resolution details (if resolved)
+            Additional fields may be required based on the CSV schema.
+    
+    Returns:
+        Dictionary with success or error message
+    
+    Example:
+        add_ticket({
+            "id": "TKT001",
+            "customer_id": "CUST001",
+            "subject": "Service interruption",
+            "description": "Customer experiencing service outage",
+            "status": "open",
+            "priority": "high",
+            "created_date": "2024-01-15 10:00:00",
+            "assigned_to": "agent1",
+            "resolution": ""
+        })
+    """
+    return send_post_request("add_ticket", data)
+
+
+@mcp.tool(name="remove_ticket")
+def remove_ticket(ticket_id: str) -> dict:
+    """
+    Remove a ticket record by ticket ID.
+    
+    Args:
+        ticket_id: The ticket ID to remove
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    return send_post_request("remove_ticket", {"id": ticket_id})
+
+
+@mcp.tool(name="update_ticket")
+def update_ticket(
+    ticket_id: str,
+    field: str = None,
+    value: Any = None,
+    updates: dict = None
+) -> dict:
+    """
+    Update a ticket record by ticket ID.
+    
+    Args:
+        ticket_id: The ticket ID to update
+        field: Single field name to update (use with value)
+        value: Value to set for the field
+        updates: Dictionary of field:value pairs to update
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    data = {"id": ticket_id}
+    if updates:
+        data["updates"] = updates
+    elif field:
+        data["field"] = field
+        data["value"] = value
+    return send_post_request("update_ticket", data)
+
+
+# ============================================================================
+# FORUM TOOLS
+# ============================================================================
+
+@mcp.tool(name="query_forum_thread")
+def query_forum_thread(thread_id: str) -> dict:
+    """
+    Query a forum thread by its thread ID.
+
+    Args:
+        thread_id: The forum thread ID (e.g., "FTHR001")
+
+    Returns:
+        Dictionary with thread information: id, title, topic, created_at_iso, status, author_id, author_type
+    """
+    return send_request("query_forum_thread", params={"id": thread_id})
+
+
+@mcp.tool(name="query_forum_posts_by_thread")
+def query_forum_posts_by_thread(thread_id: str) -> dict:
+    """
+    List all posts in a forum thread, sorted by creation time.
+
+    Args:
+        thread_id: The forum thread ID whose posts to retrieve (e.g., "FTHR001")
+
+    Returns:
+        Dictionary with list of posts: id, thread_id, author_id, author_type, content, created_at_iso
+    """
+    return send_request("query_forum_posts_by_thread", params={"thread_id": thread_id})
+
+
+@mcp.tool(name="query_forum_post")
+def query_forum_post(post_id: str) -> dict:
+    """
+    Query a single forum post by its post ID.
+
+    Args:
+        post_id: The forum post ID (e.g., "FPOST001")
+
+    Returns:
+        Dictionary with post information: id, thread_id, author_id, author_type, content, created_at_iso
+    """
+    return send_request("query_forum_post", params={"id": post_id})
+
+
+# ============================================================================
+# CUSTOMER-BASED LOOKUP TOOLS
+# ============================================================================
+
+@mcp.tool(name="query_tickets_by_customer")
+def query_tickets_by_customer(customer_id: str) -> dict:
+    """
+    List all support tickets for a customer, sorted by creation date (newest first).
+
+    Args:
+        customer_id: The customer ID to look up tickets for
+
+    Returns:
+        Dictionary with list of tickets: id, customer_id, issue, created_at_iso, status
+    """
+    return send_request("query_tickets_by_customer", params={"customer_id": customer_id})
+
+
+@mcp.tool(name="query_calendar_events_by_customer")
+def query_calendar_events_by_customer(customer_id: str) -> dict:
+    """
+    List all calendar events for a customer, sorted by start time.
+
+    Args:
+        customer_id: The customer ID to look up calendar events for
+
+    Returns:
+        Dictionary with list of events: id, customer_id, start_time_iso, end_time_iso, title, description
+    """
+    return send_request("query_calendar_events_by_customer", params={"customer_id": customer_id})
+
+
+@mcp.tool(name="query_sms_by_customer")
+def query_sms_by_customer(customer_id: str) -> dict:
+    """
+    List all SMS records for a customer, sorted by sent time (newest first).
+
+    Args:
+        customer_id: The customer ID to look up SMS records for
+
+    Returns:
+        Dictionary with list of SMS: id, customer_id, body, sent_at_iso
+    """
+    return send_request("query_sms_by_customer", params={"customer_id": customer_id})
+
+
+@mcp.tool(name="query_emails_by_customer")
+def query_emails_by_customer(customer_id: str) -> dict:
+    """
+    List all email records for a customer, sorted by sent time (newest first).
+
+    Args:
+        customer_id: The customer ID to look up email records for
+
+    Returns:
+        Dictionary with list of emails: id, customer_id, subject, body, sent_at_iso
+    """
+    return send_request("query_emails_by_customer", params={"customer_id": customer_id})
+
+
+# ============================================================================
+# UTILITY TOOLS
+# ============================================================================
+
+@mcp.tool(name="reload_all_tables")
+def reload_all_tables() -> dict:
+    """
+    Reload all CSV tables from disk.
+    This refreshes the in-memory data from the CSV files.
+    
+    Returns:
+        Dictionary with success or error message
+    """
+    return send_post_request("reload_all", {})
+
+
+def main():
+    """Main entry point for the MCP server."""
+    print("Starting Telecom MCP server...", file=sys.stderr)
+    print("=" * 60, file=sys.stderr)
+    print("Available Tools:", file=sys.stderr)
+    print("  Customers: query_customer, add_customer, remove_customer, update_customer", file=sys.stderr)
+    print("  Accounts: query_account, add_account, remove_account, update_account", file=sys.stderr)
+    print("  Bills: query_bill, add_bill, remove_bill, update_bill", file=sys.stderr)
+    print("  Calendar Events: query_calendar_event, add_calendar_event, remove_calendar_event, update_calendar_event", file=sys.stderr)
+    print("  Calendar Events (by customer): query_calendar_events_by_customer", file=sys.stderr)
+    print("  Emails: query_email, add_email, remove_email, update_email", file=sys.stderr)
+    print("  Emails (by customer): query_emails_by_customer", file=sys.stderr)
+    print("  Forum: query_forum_thread, query_forum_posts_by_thread, query_forum_post, add_forum_thread, add_forum_post", file=sys.stderr)
+    print("  Orders: query_order, add_order, remove_order, update_order", file=sys.stderr)
+    print("  Outages: query_outage, add_outage, remove_outage, update_outage", file=sys.stderr)
+    print("  SMS: query_sms, add_sms, remove_sms, update_sms", file=sys.stderr)
+    print("  SMS (by customer): query_sms_by_customer", file=sys.stderr)
+    print("  Tickets: query_ticket, add_ticket, remove_ticket, update_ticket", file=sys.stderr)
+    print("  Tickets (by customer): query_tickets_by_customer", file=sys.stderr)
+    print("  Utility: reload_all_tables", file=sys.stderr)
+    print("=" * 60, file=sys.stderr)
+    print(f"Backend Telecom server: http://{TELECOM_HOST}:{TELECOM_PORT}", file=sys.stderr)
+    
+    # Support both stdio and HTTP transport
+    transport = os.getenv("TELECOM_MCP_TRANSPORT", "stdio")
+    TELECOM_MCP_HOST = os.getenv("TELECOM_MCP_HOST", "localhost")
+    TELECOM_MCP_PORT = os.getenv("TELECOM_MCP_PORT", "12345")
+    
+    if transport == "http":
+        print(f"MCP server (HTTP): http://{TELECOM_MCP_HOST}:{TELECOM_MCP_PORT}", file=sys.stderr)
+        print("MCP server is running and accepting HTTP connections", file=sys.stderr)
+    else:
+        print(f"MCP server (stdio): Port {TELECOM_MCP_PORT} configured (not used in stdio mode)", file=sys.stderr)
+        print("MCP server is waiting for MCP client connections via stdio", file=sys.stderr)
+    
+    print("=" * 60, file=sys.stderr)
+    sys.stderr.flush()
+    
+    if transport == "http":
+        mcp.run(transport="http", port=int(TELECOM_MCP_PORT))
+    else:
+        mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()