updates to README.md and connx_server.py including tests.

Author: deec

README.md

@@ -219,6 +219,21 @@ Below are examples of how MCP-compatible clients (such as Claude Desktop or othe
       5.	“Show me details for customer Z3375.”
       6.	“Do we have any customers missing phone numbers?”
       7.    "What products are most frequently ordered by customers?"
+        
+### What MCP tools are available?
+
+CONNX Database Server Tools:
+
+query_connx - Query data from CONNX-connected databases using SQL (SELECT-only queries)
+update_connx - Perform update operations (requires CONNX_ALLOW_WRITES=true)
+count_customers - Get total number of customers
+customers_by_state - Get customer distribution by state
+customer_cities - Get customer cities information
+customers_missing_phone - Find customers without phone numbers
+get_customer - Retrieve a specific customer by ID
+find_customers - Search for customers by state and optional city
+describe_entities - Describe known business entities and their data sources
+count_entities - Count rows for business entities (customers, clients, etc.)
 ---
 
 ## Testing 

connx_server.py

@@ -33,20 +33,23 @@
 
 ENTITY_ALIASES = {
     "customers": {
-        "aliases": [
-            "customer",
-            "customers",
-            "client",
-            "clients",
-            "accounts",
-            "buyers",
-            "companies"
-        ],
+        "aliases": ["customer", "customers", "client", "clients", "accounts", "buyers", "companies"],
         "table": "daea_Mainframe_VSAM.dbo.CUSTOMERS_VSAM",
         "description": "VSAM-backed customer master file accessed via CONNX"
+    },
+    "orders": {
+        "aliases": ["order", "orders", "purchases", "transactions", "sales"],
+        "table": "daea_Mainframe_VSAM.dbo.ORDERS_VSAM",
+        "description": "Customer order transactions stored in VSAM"
+    },
+    "products": {
+        "aliases": ["product", "products", "items", "inventory", "goods"],
+        "table": "daea_Mainframe_VSAM.dbo.PRODUCTS_VSAM",
+        "description": "Product master file stored in VSAM"
     }
 }
 
+
 def resolve_entity(name: str) -> Optional[str]:
     """
     Resolve a natural-language entity name to a canonical table.
@@ -493,39 +496,35 @@ async def get_semantic_entities() -> Dict[str, Any]:
         "entities": [
             {
                 "entity": "customers",
-                "aliases": [
-                    "customer", "customers", "client", "clients",
-                    "accounts", "buyers", "companies"
-                ],
+                "aliases": ["customer", "customers", "client", "clients", "accounts", "buyers", "companies"],
                 "table": "daea_Mainframe_VSAM.dbo.CUSTOMERS_VSAM",
                 "primary_key": "CUSTOMERID",
-                "description": "Customer master records stored in a VSAM file"
+                "description": "Customer master records stored in a VSAM file",
             },
             {
                 "entity": "orders",
-                "aliases": [
-                    "order", "orders", "purchases", "transactions", "sales"
-                ],
+                "aliases": ["order", "orders", "purchases", "transactions", "sales"],
                 "table": "daea_Mainframe_VSAM.dbo.ORDERS_VSAM",
                 "primary_key": "ORDERID",
                 "foreign_keys": {
                     "CUSTOMERID": "customers.CUSTOMERID",
-                    "PRODUCTID": "products.PRODUCTID"
+                    "PRODUCTID": "products.PRODUCTID",
+                },
+                "relationships": {
+                    "customers": "orders.CUSTOMERID -> customers.CUSTOMERID",
+                    "products": "orders.PRODUCTID -> products.PRODUCTID",
                 },
-                "description": "Customer order transactions stored in VSAM"
+                "description": "Customer order transactions stored in VSAM",
             },
             {
                 "entity": "products",
-                "aliases": [
-                    "product", "products", "items", "inventory", "goods"
-                ],
+                "aliases": ["product", "products", "items", "inventory", "goods"],
                 "table": "daea_Mainframe_VSAM.dbo.PRODUCTS_VSAM",
                 "primary_key": "PRODUCTID",
-                "description": "Product master file stored in VSAM"
-            }
+                "description": "Product master file stored in VSAM",
+            },
         ]
     }
-
 # Main Entry Point
 if __name__ == "__main__": # pragma: no cover
     # FastMCP.run() manages its own event loop via anyio.run()