hostinger-api-mcp 0.0.10 → 0.0.12

package/README.md

@@ -73,6 +73,16 @@ The following environment variables can be configured when running the server:
 }
 ```
 
+### Using SSE Transport
+
+To use the MCP server with SSE transport, you must run the server with the `--sse` option. 
+This will enable the server to communicate with clients using Server-Sent Events on localhost port 8100.
+Additionally, you can specify the `--host` and `--port` options to set the host and port for the server to listen on.
+
+```bash
+node server.js --see --host 127.0.0.1 --port 8100
+```
+
 ### Using as an MCP Tool Provider
 
 This server implements the Model Context Protocol (MCP) and can be used with any MCP-compatible consumer, like Claude.js client or other MCP consumers.
@@ -299,6 +309,21 @@ If there is validation error, the response will fail with `422 Validation error`
 - `overwrite`: If `true`, resource records (RRs) matching name and type will be deleted and new RRs will be created, otherwise resource records' ttl's are updated and new records are appended. If no matching RRs are found, they are created. 
 - `zone`: zone property (required)
 
+### domains_checkDomainAvailabilityV1
+
+This endpoint checks the availability of a domain name. Multiple TLDs can be checked at once.
+
+Endpoint has rate limit of 10 requests per minute.
+
+- **Method**: `POST`
+- **Path**: `/api/domains/v1/availability`
+
+**Parameters**:
+
+- `domain`: domain property (required)
+- `tlds`: tlds property (required)
+- `with_alternatives`: with_alternatives property 
+
 ### domains_getDomainListV1
 
 This endpoint retrieves a list of all domains associated with your account.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "MCP server for Hostinger API",
   "repository": {
     "type": "git",
@@ -26,6 +26,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "minimist": "^1.2.8",
+    "express": "^5.1.0",
     "axios": "^1.8.0",
     "dotenv": "^16.0.0"
   },

package/server.js

@@ -2,6 +2,9 @@
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import minimist from 'minimist';
+import express from "express";
 import axios from "axios";
 import { config as dotenvConfig } from "dotenv";
 import {
@@ -387,6 +390,38 @@ const TOOLS = [
       }
     ]
   },
+  {
+    "name": "domains_checkDomainAvailabilityV1",
+    "description": "This endpoint checks the availability of a domain name. Multiple TLDs can be checked at once.\n\nEndpoint has rate limit of 10 requests per minute.",
+    "method": "POST",
+    "path": "/api/domains/v1/availability",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "domain property"
+        },
+        "tlds": {
+          "type": "array",
+          "description": "tlds property"
+        },
+        "with_alternatives": {
+          "type": "boolean",
+          "description": "with_alternatives property"
+        }
+      },
+      "required": [
+        "domain",
+        "tlds"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
   {
     "name": "domains_getDomainListV1",
     "description": "This endpoint retrieves a list of all domains associated with your account.",
@@ -1832,7 +1867,7 @@ const SECURITY_SCHEMES = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 0.0.20
+ * Generated from OpenAPI spec version 0.0.27
  */
 class MCPServer {
   constructor() {
@@ -1850,7 +1885,7 @@ class MCPServer {
     this.server = new Server(
       {
         name: "hostinger-api-mcp",
-        version: "0.0.10",
+        version: "0.0.12",
       },
       {
         capabilities: {
@@ -1875,7 +1910,7 @@ class MCPServer {
       });
     }
     
-    headers['User-Agent'] = 'hostinger-mcp-server/0.0.10';
+    headers['User-Agent'] = 'hostinger-mcp-server/0.0.12';
     
     return headers;
   }
@@ -2126,10 +2161,52 @@ class MCPServer {
     }
   }
 
+  /**
+   * Start the sse server
+   */
+  async startSse(host, port) {
+    try {
+      // Create sse transport
+      const app = express();
+      app.use(express.json());
+
+      let transport = null;
+      const sessions = {};
+
+      app.get('/sse', (req, res) => {
+        transport = new SSEServerTransport('/messages', res);
+        sessions[transport.sessionId] = transport;
+        
+        res.on('close', () => {
+           delete sessions[transport.sessionId];
+        });
+        
+        this.server.connect(transport);
+      });
+
+      app.post('/messages', (req, res) => {
+        const sessionId = req.query.sessionId;
+        const transport = sessions[sessionId];
+        if (transport) {
+          transport.handlePostMessage(req, res);
+        } else {
+          res.status(400).send('No transport found for sessionId');
+        }
+      });
+
+      app.listen(port, host);
+      this.log('info', `MCP Server with SSE transport started successfully with ${this.tools.size} tools`);
+      this.log('info', `Listening on ${host}:${port}`);
+    } catch (error) {
+      console.error("Failed to start MCP server:", error);
+      process.exit(1);
+    }
+  }  
+
   /**
    * Start the server
    */
-  async start() {
+  async startStdio() {
     try {
       // Create stdio transport
       const transport = new StdioServerTransport();
@@ -2140,7 +2217,7 @@ class MCPServer {
 
       // Now we can safely log via MCP
       console.error(`Registered ${this.tools.size} tools`);
-      this.log('info', `MCP Server started successfully with ${this.tools.size} tools`);
+      this.log('info', `MCP Server with stdio transport started successfully with ${this.tools.size} tools`);
     } catch (error) {
       console.error("Failed to start MCP server:", error);
       process.exit(1);
@@ -2151,8 +2228,22 @@ class MCPServer {
 // Start the server
 async function main() {
   try {
+    const argv = minimist(process.argv.slice(2), { 
+        string: ['host'], 
+        int: ['port'], 
+        boolean: ['sse'],
+        default: {
+            host: '127.0.0.1',
+            port: 8100,
+        }
+    });
+    
     const server = new MCPServer();
-    await server.start();
+    if (argv.sse) {
+        await server.startSse(argv.host, argv.port);
+    } else {
+        await server.startStdio();
+    }
   } catch (error) {
     console.error("Failed to start server:", error);
     process.exit(1);

package/server.ts

@@ -2,6 +2,9 @@
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import express from "express";
+import {Request, Response} from "express";
 import axios, { AxiosRequestConfig, AxiosError, AxiosResponse } from "axios";
 import { config as dotenvConfig } from "dotenv";
 import {
@@ -403,6 +406,38 @@ const TOOLS: OpenApiTool[] = [
       }
     ]
   },
+  {
+    "name": "domains_checkDomainAvailabilityV1",
+    "description": "This endpoint checks the availability of a domain name. Multiple TLDs can be checked at once.\n\nEndpoint has rate limit of 10 requests per minute.",
+    "method": "POST",
+    "path": "/api/domains/v1/availability",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "domain property"
+        },
+        "tlds": {
+          "type": "array",
+          "description": "tlds property"
+        },
+        "with_alternatives": {
+          "type": "boolean",
+          "description": "with_alternatives property"
+        }
+      },
+      "required": [
+        "domain",
+        "tlds"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
   {
     "name": "domains_getDomainListV1",
     "description": "This endpoint retrieves a list of all domains associated with your account.",
@@ -1848,7 +1883,7 @@ const SECURITY_SCHEMES: Record<string, SecurityScheme> = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 0.0.20
+ * Generated from OpenAPI spec version 0.0.27
  */
 class MCPServer {
   private server: Server;
@@ -1870,7 +1905,7 @@ class MCPServer {
     this.server = new Server(
       {
         name: "hostinger-api-mcp",
-        version: "0.0.10",
+        version: "0.0.12",
       },
       {
         capabilities: {
@@ -1895,7 +1930,7 @@ class MCPServer {
       });
     }
     
-    headers['User-Agent'] = 'hostinger-mcp-server/0.0.10';
+    headers['User-Agent'] = 'hostinger-mcp-server/0.0.12';
     
     return headers;
   }
@@ -2150,11 +2185,53 @@ class MCPServer {
       }
     }
   }
+  
+  /**
+   * Start the sse server
+   */
+  async startSse(host: string, port: number): Promise<void> {
+    try {
+      // Create sse transport
+      const app = express();
+      app.use(express.json());
+
+      let transport: SSEServerTransport;
+      const sessions = {} as Record<string, SSEServerTransport>;
+
+      app.get('/sse', (req: Request, res: Response) => {
+        transport = new SSEServerTransport('/messages', res);
+        sessions[transport.sessionId] = transport;
+        
+        res.on('close', () => {
+           delete sessions[transport.sessionId];
+        });
+        
+        this.server.connect(transport);
+      });
+
+      app.post('/messages', (req: Request, res: Response) => {
+        const sessionId = req.query.sessionId as string;
+        const transport = sessions[sessionId];
+        if (transport) {
+          transport.handlePostMessage(req, res);
+        } else {
+          res.status(400).send('No transport found for sessionId');
+        }
+      });
+
+      app.listen(port, host);
+      this.log('info', `MCP Server with SSE transport started successfully with ${this.tools.size} tools`);
+      this.log('info', `Listening on ${host}:${port}`);
+    } catch (error) {
+      console.error("Failed to start MCP server:", error);
+      process.exit(1);
+    }
+  }  
 
   /**
-   * Start the server
+   * Start the stdio server
    */
-  async start(): Promise<void> {
+  async startStdio(): Promise<void> {
     try {
       // Create stdio transport
       const transport = new StdioServerTransport();
@@ -2165,7 +2242,7 @@ class MCPServer {
 
       // Now we can safely log via MCP
       console.error(`Registered ${this.tools.size} tools`);
-      this.log('info', `MCP Server started successfully with ${this.tools.size} tools`);
+      this.log('info', `MCP Server with stdio transport started successfully with ${this.tools.size} tools`);
     } catch (error) {
       console.error("Failed to start MCP server:", error);
       process.exit(1);
@@ -2176,8 +2253,23 @@ class MCPServer {
 // Start the server
 async function main(): Promise<void> {
   try {
+    const argv = minimist(process.argv.slice(2), { 
+        string: ['host'], 
+        int: ['port'], 
+        boolean: ['sse'],
+        default: {
+            host: '127.0.0.1',
+            port: 8100,
+        }
+    });
+    
     const server = new MCPServer();
-    await server.start();
+    
+    if (argv.sse) {
+        await server.startSse(argv.host, argv.port);
+    } else {
+        await server.startStdio();
+    }
   } catch (error) {
     console.error("Failed to start server:", error);
     process.exit(1);

package/types.d.ts

@@ -257,6 +257,29 @@ If there is validation error, the response will fail with `422 Validation error`
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * This endpoint checks the availability of a domain name. Multiple TLDs can be checked at once.
+
+Endpoint has rate limit of 10 requests per minute.
+   */
+  "undefined": {
+    params: {
+      /**
+       * domain property
+       */
+      domain: string;
+      /**
+       * tlds property
+       */
+      tlds: array;
+      /**
+       * with_alternatives property
+       */
+      with_alternatives?: boolean;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * This endpoint retrieves a list of all domains associated with your account.
    */