hostinger-api-mcp 0.2.1 → 0.2.2

package/.env.example

@@ -4,7 +4,7 @@ TRANSPORT=stdio # Fixed to stdio
 # Debug
 DEBUG=false
 
-# OAuth Configuration (used when API_TOKEN is not set — stdio mode only)
+# OAuth Configuration (used when HOSTINGER_API_TOKEN is not set — stdio mode only)
 # Uncomment to override the default OAuth issuer:
 # OAUTH_ISSUER=https://auth.hostinger.com
 

package/README.md

@@ -63,8 +63,9 @@ Pick the binary that matches your agent's scope. `hostinger-api-mcp` remains the
 
 The following environment variables can be configured when running the server:
 - `DEBUG`: Enable debug logging (true/false) (default: false)
-- `API_TOKEN`: Your API token, which will be sent in the `Authorization` header. When set, OAuth is bypassed entirely.
-- `OAUTH_ISSUER`: OAuth server base URL (default: `https://auth.hostinger.com`). Only used when `API_TOKEN` is not set.
+- `HOSTINGER_API_TOKEN`: Your API token, which will be sent in the `Authorization` header. When set, OAuth is bypassed entirely.
+- `API_TOKEN`: Deprecated alias for `HOSTINGER_API_TOKEN`. Will be removed in a future version — prefer `HOSTINGER_API_TOKEN`.
+- `OAUTH_ISSUER`: OAuth server base URL (default: `https://auth.hostinger.com`). Only used when `HOSTINGER_API_TOKEN` is not set.
 
 ## Authentication
 
@@ -72,11 +73,11 @@ The server supports two authentication methods:
 
 ### API Token (recommended for CI/scripts)
 
-Set `API_TOKEN` in the environment or `.env` file. When present it always takes precedence — no OAuth code runs.
+Set `HOSTINGER_API_TOKEN` in the environment or `.env` file. When present it always takes precedence — no OAuth code runs.
 
 ### OAuth 2.0 with PKCE (interactive sign-in)
 
-When `API_TOKEN` is not set and the server runs in stdio mode, OAuth 2.0 with PKCE is used automatically on the first authenticated tool call:
+When `HOSTINGER_API_TOKEN` is not set and the server runs in stdio mode, OAuth 2.0 with PKCE is used automatically on the first authenticated tool call:
 
 1. A dynamic OAuth client is registered with the issuer (RFC 7591) — once per machine.
 2. A browser window opens to the authorization page.
@@ -99,7 +100,7 @@ hostinger-api-mcp --login
 hostinger-api-mcp --logout
 ```
 
-**HTTP transport note:** OAuth sign-in is not supported in `--http` mode. Set `API_TOKEN` before using `--http`.
+**HTTP transport note:** OAuth sign-in is not supported in `--http` mode. Set `HOSTINGER_API_TOKEN` before using `--http`.
 
 ## Usage
 
@@ -112,7 +113,7 @@ hostinger-api-mcp --logout
             "command": "hostinger-api-mcp",
             "env": {
                 "DEBUG": "false",
-                "API_TOKEN": "YOUR API TOKEN"
+                "HOSTINGER_API_TOKEN": "YOUR API TOKEN"
             }
         }
     }
@@ -143,7 +144,7 @@ hostinger-api-mcp --http --host 0.0.0.0 --port 8150
 
 ```
 Options:
-  --http           Use HTTP streaming transport (requires API_TOKEN env var)
+  --http           Use HTTP streaming transport (requires HOSTINGER_API_TOKEN env var)
   --stdio          Use Server-Sent Events transport (default)
   --host {host}    Hostname or IP address to listen on (default: 127.0.0.1)
   --port {port}    Port to bind to (default: 8100)
@@ -166,7 +167,7 @@ import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/
 const transport = new StreamableHTTPClientTransport({
   url: "http://localhost:8100/",
   headers: {
-    "Authorization": `Bearer ${process.env.API_TOKEN}`
+    "Authorization": `Bearer ${process.env.HOSTINGER_API_TOKEN}`
   }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "MCP server for Hostinger API",
   "repository": {
     "type": "git",

package/src/core/oauth.js

@@ -41,6 +41,20 @@ export class OAuthRefreshError extends Error {
   }
 }
 
+/**
+ * Resolve the bearer token from the environment. HOSTINGER_API_TOKEN is the
+ * preferred name; API_TOKEN and APITOKEN are kept as backwards-compatible
+ * aliases (API_TOKEN is deprecated and will be removed in a future version).
+ * Empty values fall through, matching the previous `||` behavior.
+ */
+export function getEnvToken() {
+  return (
+    process.env["HOSTINGER_API_TOKEN"] ||
+    process.env["API_TOKEN"] ||
+    process.env["APITOKEN"]
+  );
+}
+
 export class OAuthProvider {
   constructor(issuerBaseUrl) {
     this.issuer = (
@@ -52,7 +66,7 @@ export class OAuthProvider {
   }
 
   async getAccessToken() {
-    const envToken = process.env["API_TOKEN"] || process.env["APITOKEN"];
+    const envToken = getEnvToken();
     if (envToken) {
       return envToken;
     }

package/src/core/oauth.ts

@@ -56,6 +56,18 @@ export class OAuthRefreshError extends Error {
   }
 }
 
+/**
+ * Resolve the bearer token from the environment. HOSTINGER_API_TOKEN is the
+ * preferred name; API_TOKEN and APITOKEN are kept as backwards-compatible
+ * aliases (API_TOKEN is deprecated and will be removed in a future version).
+ * Empty values fall through, matching the previous `||` behavior.
+ */
+export function getEnvToken(): string | undefined {
+  return process.env['HOSTINGER_API_TOKEN']
+    || process.env['API_TOKEN']
+    || process.env['APITOKEN'];
+}
+
 export class OAuthProvider {
   private readonly issuer: string;
   private _loginInProgress: Promise<string> | null = null;
@@ -65,7 +77,7 @@ export class OAuthProvider {
   }
 
   async getAccessToken(): Promise<string> {
-    const envToken = process.env['API_TOKEN'] || process.env['APITOKEN'];
+    const envToken = getEnvToken();
     if (envToken) {
       return envToken;
     }

package/src/core/runtime.js

@@ -11,7 +11,7 @@ import {
   ListToolsRequestSchema,
   CallToolRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
-import { OAuthProvider } from "./oauth.js";
+import { OAuthProvider, getEnvToken } from "./oauth.js";
 import * as tus from "tus-js-client";
 import fs from "fs";
 import path from "path";
@@ -29,7 +29,7 @@ const SECURITY_SCHEMES = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 0.11.7
+ * Generated from OpenAPI spec version 0.12.0
  */
 class MCPServer {
   constructor({ name, version, tools }) {
@@ -86,8 +86,8 @@ class MCPServer {
   }
 
   /**
-   * Resolve a bearer token. API_TOKEN env var takes precedence; otherwise the
-   * OAuth provider handles login/refresh transparently.
+   * Resolve a bearer token. HOSTINGER_API_TOKEN / API_TOKEN env vars take
+   * precedence; otherwise the OAuth provider handles login/refresh transparently.
    */
   async getAuthToken() {
     return await this.oauth.getAccessToken();
@@ -1893,7 +1893,7 @@ class MCPServer {
         }
       };
     
-      const envToken = process.env['API_TOKEN'] || process.env['APITOKEN'];
+      const envToken = getEnvToken();
       let bearerToken = await this.getAuthToken();
       config.headers['Authorization'] = `Bearer ${bearerToken}`;
 
@@ -2075,17 +2075,18 @@ export async function startServer({ name, version, tools }) {
       ${name}
       Usage: ${name} [options]
       Options:
-        --http           Use HTTP streaming transport (requires API_TOKEN env var)
-        --stdio          Use standard input/output transport (default)
-        --host <host>    Host to bind to (default: 127.0.0.1)
-        --port <port>    Port to bind to (default: 8100)
-        --login          Run OAuth sign-in flow and exit
-        --logout         Revoke stored OAuth credentials and exit
-        --help           Show this help message
+        --http               Use HTTP streaming transport (requires HOSTINGER_API_TOKEN env var)
+        --stdio              Use standard input/output transport (default)
+        --host <host>        Host to bind to (default: 127.0.0.1)
+        --port <port>        Port to bind to (default: 8100)
+        --login              Run OAuth sign-in flow and exit
+        --logout             Revoke stored OAuth credentials and exit
+        --help               Show this help message
       Environment Variables:
-        API_TOKEN        Hostinger API token (overrides OAuth when set)
-        OAUTH_ISSUER     OAuth server base URL (default: https://auth.hostinger.com)
-        DEBUG            Enable debug logging (true/false)
+        HOSTINGER_API_TOKEN  Hostinger API token (overrides OAuth when set)
+        API_TOKEN            Deprecated alias for HOSTINGER_API_TOKEN (will be removed in a future version)
+        OAUTH_ISSUER         OAuth server base URL (default: https://auth.hostinger.com)
+        DEBUG                Enable debug logging (true/false)
     `);
     process.exit(0);
   }
@@ -2106,9 +2107,9 @@ export async function startServer({ name, version, tools }) {
   }
 
   if (argv.http) {
-    const envToken = process.env['API_TOKEN'] || process.env['APITOKEN'];
+    const envToken = getEnvToken();
     if (!envToken) {
-      console.error('[Error] HTTP transport requires the API_TOKEN environment variable. OAuth sign-in is only supported in stdio mode.');
+      console.error('[Error] HTTP transport requires the HOSTINGER_API_TOKEN environment variable. OAuth sign-in is only supported in stdio mode.');
       process.exit(1);
     }
   }

package/src/core/runtime.ts

@@ -12,7 +12,7 @@ import {
   CallToolRequestSchema,
   Tool,
 } from "@modelcontextprotocol/sdk/types.js";
-import { OAuthProvider } from "./oauth.js";
+import { OAuthProvider, getEnvToken } from "./oauth.js";
 import axios,{ AxiosRequestConfig, AxiosError, AxiosResponse } from "axios";
 import * as tus from "tus-js-client";
 import fs from "fs";
@@ -47,7 +47,7 @@ const SECURITY_SCHEMES: Record<string, SecurityScheme> = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 0.11.7
+ * Generated from OpenAPI spec version 0.12.0
  */
 class MCPServer {
   private readonly name: string;
@@ -112,8 +112,8 @@ class MCPServer {
   }
 
   /**
-   * Resolve a bearer token. API_TOKEN env var takes precedence; otherwise the
-   * OAuth provider handles login/refresh transparently.
+   * Resolve a bearer token. HOSTINGER_API_TOKEN / API_TOKEN env vars take
+   * precedence; otherwise the OAuth provider handles login/refresh transparently.
    */
   private async getAuthToken(): Promise<string> {
     return await this.oauth.getAccessToken();
@@ -1924,7 +1924,7 @@ class MCPServer {
         }
       };
      
-      const envToken = process.env['API_TOKEN'] || process.env['APITOKEN'];
+      const envToken = getEnvToken();
       let bearerToken = await this.getAuthToken();
       if (config.headers) {
         config.headers['Authorization'] = `Bearer ${bearerToken}`;
@@ -2112,17 +2112,18 @@ export async function startServer({ name, version, tools }: { name: string; vers
       ${name}
       Usage: ${name} [options]
       Options:
-        --http           Use HTTP streaming transport (requires API_TOKEN env var)
-        --stdio          Use standard input/output transport (default)
-        --host <host>    Host to bind to (default: 127.0.0.1)
-        --port <port>    Port to bind to (default: 8100)
-        --login          Run OAuth sign-in flow and exit
-        --logout         Revoke stored OAuth credentials and exit
-        --help           Show this help message
+        --http               Use HTTP streaming transport (requires HOSTINGER_API_TOKEN env var)
+        --stdio              Use standard input/output transport (default)
+        --host <host>        Host to bind to (default: 127.0.0.1)
+        --port <port>        Port to bind to (default: 8100)
+        --login              Run OAuth sign-in flow and exit
+        --logout             Revoke stored OAuth credentials and exit
+        --help               Show this help message
       Environment Variables:
-        API_TOKEN        Hostinger API token (overrides OAuth when set)
-        OAUTH_ISSUER     OAuth server base URL (default: https://auth.hostinger.com)
-        DEBUG            Enable debug logging (true/false)
+        HOSTINGER_API_TOKEN  Hostinger API token (overrides OAuth when set)
+        API_TOKEN            Deprecated alias for HOSTINGER_API_TOKEN (will be removed in a future version)
+        OAUTH_ISSUER         OAuth server base URL (default: https://auth.hostinger.com)
+        DEBUG                Enable debug logging (true/false)
     `);
     process.exit(0);
   }
@@ -2143,9 +2144,9 @@ export async function startServer({ name, version, tools }: { name: string; vers
   }
 
   if (argv.http) {
-    const envToken = process.env['API_TOKEN'] || process.env['APITOKEN'];
+    const envToken = getEnvToken();
     if (!envToken) {
-      console.error('[Error] HTTP transport requires the API_TOKEN environment variable. OAuth sign-in is only supported in stdio mode.');
+      console.error('[Error] HTTP transport requires the HOSTINGER_API_TOKEN environment variable. OAuth sign-in is only supported in stdio mode.');
       process.exit(1);
     }
   }

package/src/core/tools/all.js

@@ -1570,6 +1570,10 @@ export default [
           "type": "string",
           "description": "surname parameter"
         },
+        "phone": {
+          "type": "string",
+          "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+        },
         "note": {
           "type": "string",
           "description": "note parameter"
@@ -1787,6 +1791,10 @@ export default [
           "type": "string",
           "description": "surname parameter"
         },
+        "phone": {
+          "type": "string",
+          "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+        },
         "note": {
           "type": "string",
           "description": "note parameter"

package/src/core/tools/all.ts

@@ -1580,6 +1580,10 @@ const tools: OpenApiTool[] = [
           "type": "string",
           "description": "surname parameter"
         },
+        "phone": {
+          "type": "string",
+          "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+        },
         "note": {
           "type": "string",
           "description": "note parameter"
@@ -1797,6 +1801,10 @@ const tools: OpenApiTool[] = [
           "type": "string",
           "description": "surname parameter"
         },
+        "phone": {
+          "type": "string",
+          "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+        },
         "note": {
           "type": "string",
           "description": "note parameter"

package/src/core/tools/reach.js

@@ -95,6 +95,10 @@ export default [
           "type": "string",
           "description": "surname parameter"
         },
+        "phone": {
+          "type": "string",
+          "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+        },
         "note": {
           "type": "string",
           "description": "note parameter"
@@ -312,6 +316,10 @@ export default [
           "type": "string",
           "description": "surname parameter"
         },
+        "phone": {
+          "type": "string",
+          "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+        },
         "note": {
           "type": "string",
           "description": "note parameter"

package/src/core/tools/reach.ts

@@ -105,6 +105,10 @@ const tools: OpenApiTool[] = [
           "type": "string",
           "description": "surname parameter"
         },
+        "phone": {
+          "type": "string",
+          "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+        },
         "note": {
           "type": "string",
           "description": "note parameter"
@@ -322,6 +326,10 @@ const tools: OpenApiTool[] = [
           "type": "string",
           "description": "surname parameter"
         },
+        "phone": {
+          "type": "string",
+          "description": "Phone number in E.164 format (leading \"+\" then 7-15 digits)"
+        },
         "note": {
           "type": "string",
           "description": "note parameter"

package/src/servers/all.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/all.js';
 
-startServer({ name: 'hostinger-api-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-api-mcp', version: '0.2.2', tools });

package/src/servers/all.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/all.js';
 
-startServer({ name: 'hostinger-api-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-api-mcp', version: '0.2.2', tools });

package/src/servers/billing.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/billing.js';
 
-startServer({ name: 'hostinger-billing-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-billing-mcp', version: '0.2.2', tools });

package/src/servers/billing.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/billing.js';
 
-startServer({ name: 'hostinger-billing-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-billing-mcp', version: '0.2.2', tools });

package/src/servers/dns.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/dns.js';
 
-startServer({ name: 'hostinger-dns-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-dns-mcp', version: '0.2.2', tools });

package/src/servers/dns.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/dns.js';
 
-startServer({ name: 'hostinger-dns-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-dns-mcp', version: '0.2.2', tools });

package/src/servers/domains.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/domains.js';
 
-startServer({ name: 'hostinger-domains-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-domains-mcp', version: '0.2.2', tools });

package/src/servers/domains.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/domains.js';
 
-startServer({ name: 'hostinger-domains-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-domains-mcp', version: '0.2.2', tools });

package/src/servers/hosting.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/hosting.js';
 
-startServer({ name: 'hostinger-hosting-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-hosting-mcp', version: '0.2.2', tools });

package/src/servers/hosting.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/hosting.js';
 
-startServer({ name: 'hostinger-hosting-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-hosting-mcp', version: '0.2.2', tools });

package/src/servers/reach.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/reach.js';
 
-startServer({ name: 'hostinger-reach-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-reach-mcp', version: '0.2.2', tools });

package/src/servers/reach.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/reach.js';
 
-startServer({ name: 'hostinger-reach-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-reach-mcp', version: '0.2.2', tools });

package/src/servers/vps.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/vps.js';
 
-startServer({ name: 'hostinger-vps-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-vps-mcp', version: '0.2.2', tools });

package/src/servers/vps.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/vps.js';
 
-startServer({ name: 'hostinger-vps-mcp', version: '0.2.1', tools });
+startServer({ name: 'hostinger-vps-mcp', version: '0.2.2', tools });

package/types.d.ts

@@ -1019,6 +1019,10 @@ the contact will be created with a pending status and a confirmation email will
        * surname parameter
        */
       surname?: string;
+      /**
+       * Phone number in E.164 format (leading "+" then 7-15 digits)
+       */
+      phone?: string;
       /**
        * note parameter
        */
@@ -1129,6 +1133,10 @@ and a confirmation email will be sent.
        * surname parameter
        */
       surname?: string;
+      /**
+       * Phone number in E.164 format (leading "+" then 7-15 digits)
+       */
+      phone?: string;
       /**
        * note parameter
        */