@ratio-mcp-qa/docs-server 1.0.1

package/dist/schemas/schemas/orders.json

@@ -0,0 +1,167 @@
+{
+  "resource": "orders",
+  "base_url": "https://qa-os-ecosystem.dev.gokwik.io",
+  "auth": {
+    "type": "bearer",
+    "header": "Authorization",
+    "format": "Bearer <access_token>"
+  },
+  "endpoints": [
+    {
+      "method": "GET",
+      "path": "/api/v1/orders",
+      "controller_order": 1,
+      "handler_name": "getOrders",
+      "required_scope": "read_orders",
+      "summary": "List orders with pagination and filtering",
+      "description": "Retrieve a paginated list of orders from the merchant's store. Supports filtering by status, financial status, fulfillment status, and search.",
+      "query_params": [
+        { "name": "limit", "type": "number", "required": false, "default": 50, "description": "Number of orders per page (max 100)" },
+        { "name": "page", "type": "number", "required": false, "default": 1, "description": "Page number for pagination" },
+        { "name": "status", "type": "string", "required": false, "enum": ["any", "open", "cancelled", "archived"], "description": "Filter by order status" },
+        { "name": "financial_status", "type": "string", "required": false, "enum": ["pending", "authorized", "partially_paid", "paid", "partially_refunded", "refunded", "voided"], "description": "Filter by payment/financial status" },
+        { "name": "fulfillment_status", "type": "string", "required": false, "enum": ["unfulfilled", "fulfilled", "partial", "partially_fulfilled", "restocked", "pending", "refunded", "returned"], "description": "Filter by fulfillment/shipping status" },
+        { "name": "sort_field", "type": "string", "required": false, "enum": ["created_at", "updated_at", "processed_at", "order_number", "total_price", "items", "financial_status", "fulfillment_status"], "description": "Field to sort by" },
+        { "name": "sort_direction", "type": "string", "required": false, "enum": ["asc", "desc"], "description": "Sort direction" },
+        { "name": "search", "type": "string", "required": false, "description": "Search by order number, email, or phone" }
+      ],
+      "request_body": null,
+      "response_schema": "OrderListResponse"
+    },
+    {
+      "method": "GET",
+      "path": "/api/v1/orders/:id",
+      "controller_order": 2,
+      "handler_name": "getOrderById",
+      "required_scope": "read_orders",
+      "summary": "Get a single order by ID",
+      "description": "Retrieve the full details of a single order including line items, customer info, addresses, and payment status.",
+      "path_params": [
+        { "name": "id", "type": "string", "required": true, "description": "The order ID" }
+      ],
+      "request_body": null,
+      "response_schema": "Order"
+    },
+    {
+      "method": "POST",
+      "path": "/api/v1/orders",
+      "controller_order": 3,
+      "handler_name": "createOrder",
+      "required_scope": "order-create",
+      "summary": "Create a new order",
+      "description": "Create an order in the merchant's store.",
+      "request_body": {
+        "content_type": "application/json",
+        "fields": [
+          { "name": "payment_gateway_names", "type": "string[]", "required": true, "description": "Payment gateways used" },
+          { "name": "financial_status", "type": "string", "required": true, "enum": ["pending", "authorized", "partially_paid", "paid", "partially_refunded", "refunded", "voided"], "description": "Payment status" },
+          { "name": "currency", "type": "string", "required": true, "description": "Currency code (e.g. INR)" },
+          { "name": "test", "type": "boolean", "required": true, "description": "Whether this is a test order" },
+          { "name": "note", "type": "string", "required": false, "description": "Internal note for the order" },
+          { "name": "tags", "type": "string", "required": false, "description": "Comma-separated tags" },
+          { "name": "email", "type": "string", "required": false, "description": "Customer email" },
+          { "name": "phone", "type": "string", "required": false, "description": "Customer phone" },
+          { "name": "customer", "type": "object", "required": true, "description": "Customer details (id, email, first_name, last_name, state, phone, currency)" },
+          { "name": "line_items", "type": "array", "required": true, "description": "Array of line items (variant_id, product_id, title, quantity, sku, price, taxable, requires_shipping, image)" },
+          { "name": "billing_address", "type": "object", "required": true, "description": "Billing address (address1, city, country, first_name, last_name, phone, province, zip)" },
+          { "name": "shipping_address", "type": "object", "required": true, "description": "Shipping address (same structure as billing_address)" }
+        ]
+      },
+      "response_schema": "Order"
+    },
+    {
+      "method": "PATCH",
+      "path": "/api/v1/orders/:id",
+      "controller_order": 4,
+      "handler_name": "updateOrder",
+      "required_scope": "order-create",
+      "summary": "Update an existing order",
+      "description": "Update order fields. Only provided fields are modified.",
+      "path_params": [
+        { "name": "id", "type": "string", "required": true, "description": "The order ID to update" }
+      ],
+      "request_body": {
+        "content_type": "application/json",
+        "fields": [
+          { "name": "email", "type": "string", "required": false, "description": "Updated customer email" },
+          { "name": "phone", "type": "string", "required": false, "description": "Updated customer phone" },
+          { "name": "note", "type": "string", "required": false, "description": "Updated order note" },
+          { "name": "tags", "type": "string", "required": false, "description": "Updated tags (comma-separated)" },
+          { "name": "status", "type": "string", "required": false, "enum": ["open", "closed", "cancelled"], "description": "Order status" },
+          { "name": "financial_status", "type": "string", "required": false, "enum": ["pending", "authorized", "partially_paid", "paid", "partially_refunded", "refunded", "voided"] },
+          { "name": "fulfillment_status", "type": "string", "required": false, "enum": ["fulfilled", "partial", "partially_fulfilled", "unfulfilled", "restocked", "pending", "refunded", "returned"] },
+          { "name": "shipping_address", "type": "object", "required": false, "description": "Updated shipping address" },
+          { "name": "line_items", "type": "array", "required": false, "description": "Updated line items" }
+        ]
+      },
+      "response_schema": "Order"
+    },
+    {
+      "method": "PATCH",
+      "path": "/api/v1/orders/:id/cancel",
+      "controller_order": 5,
+      "handler_name": "cancelOrder",
+      "required_scope": "order-create",
+      "summary": "Cancel an existing order",
+      "description": "Cancel an existing order with optional reason and restock settings.",
+      "path_params": [
+        { "name": "id", "type": "string", "required": true, "description": "The order ID to cancel" }
+      ],
+      "request_body": {
+        "content_type": "application/json",
+        "fields": [
+          { "name": "cancel_reason", "type": "string", "required": false, "description": "Reason for cancellation" },
+          { "name": "staff_note", "type": "string", "required": false, "description": "Internal note about the cancellation" },
+          { "name": "restock_inventory", "type": "boolean", "required": false, "description": "Whether to restock inventory" },
+          { "name": "send_notification", "type": "boolean", "required": false, "description": "Whether to send notification to customer" }
+        ]
+      },
+      "response_schema": "Order"
+    },
+    {
+      "method": "PATCH",
+      "path": "/api/v1/orders/:id/external-id",
+      "controller_order": 6,
+      "handler_name": "updateOrderExternalId",
+      "required_scope": "order-create",
+      "summary": "Update external ID for an order",
+      "description": "Updates the external_order_id field for a single order. Useful for syncing with external systems.",
+      "path_params": [
+        { "name": "id", "type": "string", "required": true, "description": "The order ID" }
+      ],
+      "request_body": {
+        "content_type": "application/json",
+        "fields": [
+          { "name": "external_id", "type": "string", "required": true, "description": "External reference ID from your system" }
+        ]
+      },
+      "response_schema": "Order"
+    }
+  ],
+  "schemas": {
+    "Order": {
+      "id": "string — unique order identifier",
+      "order_number": "number — sequential order number",
+      "email": "string | null — customer email",
+      "phone": "string | null — customer phone",
+      "financial_status": "'pending' | 'authorized' | 'partially_paid' | 'paid' | 'partially_refunded' | 'refunded' | 'voided'",
+      "fulfillment_status": "'unfulfilled' | 'partial' | 'fulfilled' | 'partially_fulfilled' | 'restocked' | 'pending' | 'refunded' | 'returned'",
+      "status": "'open' | 'closed' | 'cancelled' | 'archived'",
+      "currency": "string — currency code (e.g. 'INR')",
+      "total_price": "number — final total price",
+      "subtotal_price": "number — subtotal before tax and discounts",
+      "total_tax": "number — total tax amount",
+      "total_discounts": "number — total discount amount",
+      "line_items": "LineItem[] — items in the order",
+      "customer": "Customer object",
+      "shipping_address": "Address | null",
+      "billing_address": "Address | null",
+      "note": "string | null — internal note",
+      "tags": "string — comma-separated tags",
+      "created_at": "string — ISO 8601 timestamp",
+      "updated_at": "string — ISO 8601 timestamp",
+      "cancelled_at": "string | null — ISO 8601 timestamp if cancelled"
+    }
+  },
+  "statuses": ["pending", "confirmed", "processing", "shipped", "delivered", "cancelled", "refunded"]
+}

package/dist/schemas/schemas/products.json

@@ -0,0 +1,167 @@
+{
+  "resource": "products",
+  "base_url": "https://qa-os-ecosystem.dev.gokwik.io",
+  "auth": {
+    "type": "bearer",
+    "header": "Authorization",
+    "format": "Bearer <access_token>"
+  },
+  "endpoints": [
+    {
+      "method": "GET",
+      "path": "/api/v1/v1/products",
+      "controller_order": 1,
+      "handler_name": "getProducts",
+      "required_scope": "read_products",
+      "summary": "List products with pagination and filtering",
+      "description": "Retrieve a paginated list of products. Supports filtering by status, vendor, tags, category, collection, and search.",
+      "query_params": [
+        { "name": "limit", "type": "number", "required": false, "default": 10, "description": "Number of products per page" },
+        { "name": "page", "type": "number", "required": false, "default": 1, "description": "Page number for pagination" },
+        { "name": "offset", "type": "number", "required": false, "default": 0, "description": "Offset for pagination" },
+        { "name": "all", "type": "boolean", "required": false, "description": "Return all products (ignore pagination)" },
+        { "name": "search", "type": "string", "required": false, "description": "Search products by title" },
+        { "name": "status", "type": "string", "required": false, "enum": ["draft", "active", "archived"], "description": "Filter by product status" },
+        { "name": "vendor", "type": "string", "required": false, "description": "Filter by vendor/brand name" },
+        { "name": "categoryId", "type": "string", "required": false, "description": "Filter by category ID" },
+        { "name": "collectionId", "type": "string", "required": false, "description": "Filter by collection ID" },
+        { "name": "tagId", "type": "string", "required": false, "description": "Filter by tag ID" },
+        { "name": "tags", "type": "string", "required": false, "description": "Filter by tags" },
+        { "name": "published", "type": "boolean", "required": false, "description": "Filter by published status" },
+        { "name": "show_variants", "type": "boolean", "required": false, "default": false, "description": "Include variant details in response" }
+      ],
+      "request_body": null,
+      "response_schema": "ProductListResponse"
+    },
+    {
+      "method": "GET",
+      "path": "/api/v1/v1/products/:id",
+      "controller_order": 2,
+      "handler_name": "getProductById",
+      "required_scope": "read_products",
+      "summary": "Get a single product by ID",
+      "description": "Retrieve the full details of a single product.",
+      "path_params": [
+        { "name": "id", "type": "string", "required": true, "description": "The product ID" }
+      ],
+      "query_params": [
+        { "name": "show_variants", "type": "boolean", "required": false, "description": "Include variant details in response" }
+      ],
+      "request_body": null,
+      "response_schema": "Product"
+    },
+    {
+      "method": "POST",
+      "path": "/api/v1/v1/products",
+      "controller_order": 3,
+      "handler_name": "createProduct",
+      "required_scope": "write_products",
+      "summary": "Create a product",
+      "description": "Create a product in the merchant's store. The body must be wrapped in a { product: { ... } } object.",
+      "request_body": {
+        "content_type": "application/json",
+        "note": "The request body MUST be wrapped: { \"product\": { ... } }",
+        "fields": [
+          { "name": "title", "type": "string", "required": true, "description": "Product title" },
+          { "name": "body_html", "type": "string", "required": false, "description": "HTML description" },
+          { "name": "handle", "type": "string", "required": false, "description": "URL-friendly slug" },
+          { "name": "product_type", "type": "string", "required": false, "description": "Product type/category" },
+          { "name": "vendor", "type": "string", "required": false, "description": "Manufacturer/brand" },
+          { "name": "status", "type": "string", "required": false, "enum": ["draft", "active", "archived"], "description": "Product status" },
+          { "name": "tags", "type": "string", "required": false, "description": "Comma-separated tags" },
+          { "name": "price", "type": "number", "required": false, "description": "Price in paise (integer)" },
+          { "name": "compare_at_price", "type": "number", "required": false, "description": "Compare-at price in paise" },
+          { "name": "sku", "type": "string", "required": false, "description": "Stock keeping unit" },
+          { "name": "barcode", "type": "string", "required": false, "description": "Barcode" },
+          { "name": "weight", "type": "number", "required": false, "description": "Weight value" },
+          { "name": "weight_unit", "type": "string", "required": false, "description": "Weight unit (kg, g, lb, oz)" },
+          { "name": "charge_tax", "type": "boolean", "required": false, "description": "Charge tax on this product" },
+          { "name": "track_inventory", "type": "boolean", "required": false, "description": "Track inventory" },
+          { "name": "is_physical_product", "type": "boolean", "required": false, "description": "Is physical product" },
+          { "name": "seo_title", "type": "string", "required": false, "description": "SEO title" },
+          { "name": "seo_description", "type": "string", "required": false, "description": "SEO description" },
+          { "name": "categoryId", "type": "string", "required": false, "description": "Category ID" },
+          { "name": "collectionIds", "type": "string[]", "required": false, "description": "Collection IDs" },
+          { "name": "tagIds", "type": "string[]", "required": false, "description": "Tag IDs" },
+          { "name": "metadata", "type": "object", "required": false, "description": "Additional metadata" }
+        ]
+      },
+      "response_schema": "Product"
+    },
+    {
+      "method": "PUT",
+      "path": "/api/v1/v1/products/:id",
+      "controller_order": 4,
+      "handler_name": "updateProduct",
+      "required_scope": "write_products",
+      "summary": "Update a product",
+      "description": "Update product fields. Only provided fields are modified.",
+      "path_params": [
+        { "name": "id", "type": "string", "required": true, "description": "The product ID to update" }
+      ],
+      "request_body": {
+        "content_type": "application/json",
+        "fields": [
+          { "name": "title", "type": "string", "required": false },
+          { "name": "body_html", "type": "string", "required": false },
+          { "name": "handle", "type": "string", "required": false },
+          { "name": "product_type", "type": "string", "required": false },
+          { "name": "vendor", "type": "string", "required": false },
+          { "name": "status", "type": "string", "required": false, "enum": ["draft", "active", "archived"] },
+          { "name": "tags", "type": "string", "required": false },
+          { "name": "price", "type": "number", "required": false },
+          { "name": "compare_at_price", "type": "number", "required": false },
+          { "name": "sku", "type": "string", "required": false },
+          { "name": "barcode", "type": "string", "required": false },
+          { "name": "weight", "type": "number", "required": false },
+          { "name": "weight_unit", "type": "string", "required": false },
+          { "name": "seo_title", "type": "string", "required": false },
+          { "name": "seo_description", "type": "string", "required": false },
+          { "name": "categoryId", "type": "string", "required": false },
+          { "name": "collectionIds", "type": "string[]", "required": false },
+          { "name": "tagIds", "type": "string[]", "required": false },
+          { "name": "metadata", "type": "object", "required": false }
+        ]
+      },
+      "response_schema": "Product"
+    },
+    {
+      "method": "DELETE",
+      "path": "/api/v1/v1/products/:id",
+      "controller_order": 5,
+      "handler_name": "deleteProduct",
+      "required_scope": "write_products",
+      "summary": "Delete a product",
+      "description": "Permanently delete a product from the merchant's store.",
+      "path_params": [
+        { "name": "id", "type": "string", "required": true, "description": "The product ID to delete" }
+      ],
+      "request_body": null,
+      "response_schema": null
+    }
+  ],
+  "schemas": {
+    "Product": {
+      "id": "string — unique product identifier (UUID)",
+      "title": "string — product title",
+      "body_html": "string | null — HTML description",
+      "handle": "string — URL-friendly slug",
+      "product_type": "string | null — product type/category",
+      "vendor": "string | null — vendor/brand name",
+      "status": "'draft' | 'active' | 'archived'",
+      "tags": "string — comma-separated tags",
+      "price": "number — price in paise",
+      "compare_at_price": "number | null — compare-at price in paise",
+      "sku": "string | null — stock keeping unit",
+      "barcode": "string | null — barcode",
+      "weight": "number | null — weight value",
+      "weight_unit": "string | null — weight unit",
+      "published_at": "string | null — ISO 8601 timestamp",
+      "created_at": "string — ISO 8601 timestamp",
+      "updated_at": "string — ISO 8601 timestamp",
+      "variants": "Variant[] — product variants (when show_variants=true)",
+      "images": "Image[] — product images"
+    }
+  },
+  "statuses": ["draft", "active", "archived"]
+}

package/dist/schemas/schemas/scopes.json

@@ -0,0 +1,52 @@
+{
+  "version": 1,
+  "resources": {
+    "orders": {
+      "display_name": "Orders",
+      "description": "Access and manage merchant orders",
+      "scopes": {
+        "read_orders": {
+          "label": "Read Orders",
+          "description": "View orders and order details",
+          "access": "read-only",
+          "endpoints": ["GET /api/v1/orders", "GET /api/v1/orders/:id"]
+        },
+        "order-create": {
+          "label": "Order Create/Update",
+          "description": "Create, update, and cancel orders",
+          "access": "read-write",
+          "inherits": "read_orders",
+          "endpoints": [
+            "POST /api/v1/orders",
+            "PATCH /api/v1/orders/:id",
+            "PATCH /api/v1/orders/:id/cancel",
+            "PATCH /api/v1/orders/:id/external-id"
+          ]
+        }
+      }
+    },
+    "products": {
+      "display_name": "Products",
+      "description": "Access and manage merchant products",
+      "scopes": {
+        "read_products": {
+          "label": "Read Products",
+          "description": "View products and product details",
+          "access": "read-only",
+          "endpoints": ["GET /api/v1/v1/products", "GET /api/v1/v1/products/:id"]
+        },
+        "write_products": {
+          "label": "Write Products",
+          "description": "Create, update, and delete products",
+          "access": "read-write",
+          "inherits": "read_products",
+          "endpoints": [
+            "POST /api/v1/v1/products",
+            "PUT /api/v1/v1/products/:id",
+            "DELETE /api/v1/v1/products/:id"
+          ]
+        }
+      }
+    }
+  }
+}

package/dist/schemas/schemas/webhooks.json

@@ -0,0 +1,69 @@
+{
+  "version": 1,
+  "verification": {
+    "method": "HMAC-SHA256",
+    "header": "X-Ratio-Hmac-SHA256",
+    "description": "Verify webhook authenticity by computing HMAC-SHA256 of the raw request body using your app's client_secret as the key."
+  },
+  "retry_policy": {
+    "max_retries": 3,
+    "retry_intervals": ["5s", "30s", "5m"],
+    "failure_action": "Webhook is disabled after all retries fail"
+  },
+  "events": [
+    {
+      "topic": "orders/create",
+      "description": "Fired when a new order is created",
+      "resource": "orders",
+      "required_scope": "read_orders"
+    },
+    {
+      "topic": "orders/updated",
+      "description": "Fired when an order is updated",
+      "resource": "orders",
+      "required_scope": "read_orders"
+    },
+    {
+      "topic": "orders/cancelled",
+      "description": "Fired when an order is cancelled",
+      "resource": "orders",
+      "required_scope": "read_orders"
+    },
+    {
+      "topic": "orders/fulfilled",
+      "description": "Fired when an order is fulfilled",
+      "resource": "orders",
+      "required_scope": "read_orders"
+    },
+    {
+      "topic": "orders/paid",
+      "description": "Fired when an order is paid",
+      "resource": "orders",
+      "required_scope": "read_orders"
+    },
+    {
+      "topic": "products/create",
+      "description": "Fired when a new product is created",
+      "resource": "products",
+      "required_scope": "read_products"
+    },
+    {
+      "topic": "products/update",
+      "description": "Fired when a product is updated",
+      "resource": "products",
+      "required_scope": "read_products"
+    },
+    {
+      "topic": "products/delete",
+      "description": "Fired when a product is deleted",
+      "resource": "products",
+      "required_scope": "read_products"
+    },
+    {
+      "topic": "app/uninstalled",
+      "description": "Fired when the app is uninstalled by a merchant",
+      "resource": "app",
+      "required_scope": null
+    }
+  ]
+}

package/dist/schemas/scopes.json

@@ -0,0 +1,52 @@
+{
+  "version": 1,
+  "resources": {
+    "orders": {
+      "display_name": "Orders",
+      "description": "Access and manage merchant orders",
+      "scopes": {
+        "read_orders": {
+          "label": "Read Orders",
+          "description": "View orders and order details",
+          "access": "read-only",
+          "endpoints": ["GET /api/v1/orders", "GET /api/v1/orders/:id"]
+        },
+        "order-create": {
+          "label": "Order Create/Update",
+          "description": "Create, update, and cancel orders",
+          "access": "read-write",
+          "inherits": "read_orders",
+          "endpoints": [
+            "POST /api/v1/orders",
+            "PATCH /api/v1/orders/:id",
+            "PATCH /api/v1/orders/:id/cancel",
+            "PATCH /api/v1/orders/:id/external-id"
+          ]
+        }
+      }
+    },
+    "products": {
+      "display_name": "Products",
+      "description": "Access and manage merchant products",
+      "scopes": {
+        "read_products": {
+          "label": "Read Products",
+          "description": "View products and product details",
+          "access": "read-only",
+          "endpoints": ["GET /api/v1/v1/products", "GET /api/v1/v1/products/:id"]
+        },
+        "write_products": {
+          "label": "Write Products",
+          "description": "Create, update, and delete products",
+          "access": "read-write",
+          "inherits": "read_products",
+          "endpoints": [
+            "POST /api/v1/v1/products",
+            "PUT /api/v1/v1/products/:id",
+            "DELETE /api/v1/v1/products/:id"
+          ]
+        }
+      }
+    }
+  }
+}

package/dist/schemas/webhooks.json

@@ -0,0 +1,69 @@
+{
+  "version": 1,
+  "verification": {
+    "method": "HMAC-SHA256",
+    "header": "X-Ratio-Hmac-SHA256",
+    "description": "Verify webhook authenticity by computing HMAC-SHA256 of the raw request body using your app's client_secret as the key."
+  },
+  "retry_policy": {
+    "max_retries": 3,
+    "retry_intervals": ["5s", "30s", "5m"],
+    "failure_action": "Webhook is disabled after all retries fail"
+  },
+  "events": [
+    {
+      "topic": "orders/create",
+      "description": "Fired when a new order is created",
+      "resource": "orders",
+      "required_scope": "read_orders"
+    },
+    {
+      "topic": "orders/updated",
+      "description": "Fired when an order is updated",
+      "resource": "orders",
+      "required_scope": "read_orders"
+    },
+    {
+      "topic": "orders/cancelled",
+      "description": "Fired when an order is cancelled",
+      "resource": "orders",
+      "required_scope": "read_orders"
+    },
+    {
+      "topic": "orders/fulfilled",
+      "description": "Fired when an order is fulfilled",
+      "resource": "orders",
+      "required_scope": "read_orders"
+    },
+    {
+      "topic": "orders/paid",
+      "description": "Fired when an order is paid",
+      "resource": "orders",
+      "required_scope": "read_orders"
+    },
+    {
+      "topic": "products/create",
+      "description": "Fired when a new product is created",
+      "resource": "products",
+      "required_scope": "read_products"
+    },
+    {
+      "topic": "products/update",
+      "description": "Fired when a product is updated",
+      "resource": "products",
+      "required_scope": "read_products"
+    },
+    {
+      "topic": "products/delete",
+      "description": "Fired when a product is deleted",
+      "resource": "products",
+      "required_scope": "read_products"
+    },
+    {
+      "topic": "app/uninstalled",
+      "description": "Fired when the app is uninstalled by a merchant",
+      "resource": "app",
+      "required_scope": null
+    }
+  ]
+}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Create and configure the Ratio Docs MCP Server
+ */
+export declare function createDocsServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,CAuD5C"}

package/dist/server.js

@@ -0,0 +1,53 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { DOCS_SERVER_NAME, DOCS_SERVER_VERSION } from '@ratio-mcp-qa/shared';
+import { docsTools } from './tools/index.js';
+import { logger } from './utils/logger.js';
+/**
+ * Create and configure the Ratio Docs MCP Server
+ */
+export function createDocsServer() {
+    const server = new McpServer({
+        name: DOCS_SERVER_NAME,
+        version: DOCS_SERVER_VERSION,
+    });
+    // Register all tools
+    for (const tool of docsTools) {
+        // Pass Zod shape directly — MCP SDK handles Zod-to-JSON conversion internally
+        const shape = tool.inputSchema.shape;
+        server.tool(tool.name, tool.description, shape, async (args) => {
+            logger.toolCall(tool.name, args);
+            const startTime = Date.now();
+            try {
+                const result = tool.handler(args);
+                const duration = Date.now() - startTime;
+                logger.toolResult(tool.name, duration, result);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const duration = Date.now() - startTime;
+                logger.toolError(tool.name, duration, error);
+                const message = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ error: true, message }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        logger.debug(`Registered tool: ${tool.name}`);
+    }
+    logger.info(`${DOCS_SERVER_NAME} initialized with ${docsTools.length} tools`);
+    return server;
+}
+//# sourceMappingURL=server.js.map