@hostinger/mcp 3.31.1 → 3.31.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,21 @@ Generated at release time from the diff between the previous and current
4
4
  build. Tool changes are listed individually; everything else is summarised
5
5
  by area.
6
6
 
7
+ ## v3.31.3 — 2026-11-09
8
+
9
+ ### Also in this release
10
+
11
+ - Documentation: `README.md`
12
+ - Bundled agent skills: `skills/headless/VERSION`
13
+
14
+ ## v3.31.2 — 2026-11-09
15
+
16
+ ### Also in this release
17
+
18
+ - Dependencies: `package-lock.json`
19
+ - Bundled agent skills: `skills/headless/VERSION`
20
+ - Request handling and authentication: `src/core/runtime.js`, `src/core/runtime.ts`
21
+
7
22
  ## v3.31.1 — 2026-11-06
8
23
 
9
24
  ### Also in this release
package/README.md CHANGED
@@ -18,6 +18,15 @@ claude mcp add --transport http hostinger https://mcp.hostinger.com
18
18
 
19
19
  This opens a browser window to authorize via OAuth. Once approved, the operations below are reachable through `execute` in your session.
20
20
 
21
+ ### Codex
22
+
23
+ ```bash
24
+ codex mcp add hostinger --url https://mcp.hostinger.com
25
+ codex mcp login hostinger
26
+ ```
27
+
28
+ `login` opens the same OAuth flow in your browser.
29
+
21
30
  ### Other MCP-compatible clients
22
31
 
23
32
  Add `https://mcp.hostinger.com` as a remote Streamable HTTP MCP server in your client's configuration and complete the OAuth prompt when it appears. Refer to your client's docs for how it exposes "add remote MCP server" / "custom connector" settings.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hostinger-api-mcp",
3
- "version": "3.31.1",
3
+ "version": "3.31.3",
4
4
  "description": "Hostinger API — manage domains, DNS, hosting, VPS, billing and more from Gemini CLI.",
5
5
  "mcpServers": {
6
6
  "hostinger": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hostinger/mcp",
3
- "version": "3.31.1",
3
+ "version": "3.31.3",
4
4
  "mcpName": "io.github.hostinger/hostinger-api-mcp",
5
5
  "description": "MCP server for Hostinger API",
6
6
  "repository": {
package/server.json CHANGED
@@ -17,12 +17,12 @@
17
17
  "url": "https://github.com/hostinger/api-mcp-server",
18
18
  "source": "github"
19
19
  },
20
- "version": "3.31.1",
20
+ "version": "3.31.3",
21
21
  "packages": [
22
22
  {
23
23
  "registryType": "npm",
24
24
  "identifier": "@hostinger/mcp",
25
- "version": "3.31.1",
25
+ "version": "3.31.3",
26
26
  "transport": {
27
27
  "type": "stdio"
28
28
  },
@@ -1,3 +1,3 @@
1
- version=3.31.1
2
- commit=ffdecc6885f3
3
- built=2026-11-06
1
+ version=3.31.3
2
+ commit=fe38647c8150
3
+ built=2026-11-09
@@ -554,6 +554,23 @@ class MCPServer {
554
554
  }
555
555
  }
556
556
 
557
+ // upload-urls fails for a few seconds while the server's file browser starts or is under maintenance, and a retry
558
+ // usually succeeds, so 5xx responses and connection errors are retried; a 4xx and our own timeout are not.
559
+ async retryUploadCredentialsRequest(request) {
560
+ const delays = [1000, 3000];
561
+ for (let attempt = 0; ; attempt++) {
562
+ try {
563
+ return await request();
564
+ } catch (error) {
565
+ if (!axios.isAxiosError(error) || error.code === 'ECONNABORTED' || (error.response && error.response.status < 500) || attempt >= delays.length) {
566
+ throw error;
567
+ }
568
+ this.log('warning', 'Upload credentials request failed, retrying: ' + error.message);
569
+ await new Promise(resolve => setTimeout(resolve, delays[attempt]));
570
+ }
571
+ }
572
+ }
573
+
557
574
  async fetchUploadCredentials(username, domain) {
558
575
  const baseUrl = this.baseUrl.endsWith("/") ? this.baseUrl : `${this.baseUrl}/`;
559
576
  const url = new URL('api/hosting/v1/files/upload-urls', baseUrl).toString();
@@ -579,7 +596,7 @@ class MCPServer {
579
596
  }
580
597
  };
581
598
 
582
- const response = await axios(config);
599
+ const response = await this.retryUploadCredentialsRequest(() => axios(config));
583
600
 
584
601
  if (response.status !== 200) {
585
602
  throw new Error(`API returned status ${response.status}: ${JSON.stringify(response.data)}`);
@@ -598,6 +615,13 @@ class MCPServer {
598
615
  status: responseStatus,
599
616
  data: typeof responseData === 'object' ? JSON.stringify(responseData) : responseData
600
617
  });
618
+ // Only the API's message and correlation_id are passed on: a 5xx body can carry a stack trace or an
619
+ // upstream page (debug mode), which must not reach the user. The correlation_id lets support trace it.
620
+ if (error.response) {
621
+ const message = typeof responseData?.message === 'string' ? responseData.message.slice(0, 200) : 'no message';
622
+ const correlationId = typeof responseData?.correlation_id === 'string' ? ' (correlation_id: ' + responseData.correlation_id.slice(0, 100) + ')' : '';
623
+ throw new Error('API returned status ' + responseStatus + ': ' + message + correlationId);
624
+ }
601
625
  }
602
626
 
603
627
  throw error;
@@ -3425,6 +3449,23 @@ class MCPServer {
3425
3449
  }
3426
3450
  }
3427
3451
 
3452
+ // upload-urls fails for a few seconds while the server's file browser starts or is under maintenance, and a retry
3453
+ // usually succeeds, so 5xx responses and connection errors are retried; a 4xx and our own timeout are not.
3454
+ async agencyHosting_retryUploadCredentialsRequest(request) {
3455
+ const delays = [1000, 3000];
3456
+ for (let attempt = 0; ; attempt++) {
3457
+ try {
3458
+ return await request();
3459
+ } catch (error) {
3460
+ if (!axios.isAxiosError(error) || error.code === 'ECONNABORTED' || (error.response && error.response.status < 500) || attempt >= delays.length) {
3461
+ throw error;
3462
+ }
3463
+ this.log('warning', 'Upload credentials request failed, retrying: ' + error.message);
3464
+ await new Promise(resolve => setTimeout(resolve, delays[attempt]));
3465
+ }
3466
+ }
3467
+ }
3468
+
3428
3469
  async agencyHosting_fetchUploadCredentials(websiteUid) {
3429
3470
  const baseUrl = this.baseUrl.endsWith("/") ? this.baseUrl : `${this.baseUrl}/`;
3430
3471
  const url = new URL(`api/agency-hosting/v1/websites/${websiteUid}/files/upload-urls`, baseUrl).toString();
@@ -3446,7 +3487,7 @@ class MCPServer {
3446
3487
  }
3447
3488
  };
3448
3489
 
3449
- const response = await axios(config);
3490
+ const response = await this.agencyHosting_retryUploadCredentialsRequest(() => axios(config));
3450
3491
 
3451
3492
  if (response.status !== 200) {
3452
3493
  throw new Error(`API returned status ${response.status}: ${JSON.stringify(response.data)}`);
@@ -3465,6 +3506,13 @@ class MCPServer {
3465
3506
  status: responseStatus,
3466
3507
  data: typeof responseData === 'object' ? JSON.stringify(responseData) : responseData
3467
3508
  });
3509
+ // Only the API's message and correlation_id are passed on: a 5xx body can carry a stack trace or an
3510
+ // upstream page (debug mode), which must not reach the user. The correlation_id lets support trace it.
3511
+ if (error.response) {
3512
+ const message = typeof responseData?.message === 'string' ? responseData.message.slice(0, 200) : 'no message';
3513
+ const correlationId = typeof responseData?.correlation_id === 'string' ? ' (correlation_id: ' + responseData.correlation_id.slice(0, 100) + ')' : '';
3514
+ throw new Error('API returned status ' + responseStatus + ': ' + message + correlationId);
3515
+ }
3468
3516
  }
3469
3517
 
3470
3518
  throw error;
@@ -586,6 +586,23 @@ class MCPServer {
586
586
  }
587
587
  }
588
588
 
589
+ // upload-urls fails for a few seconds while the server's file browser starts or is under maintenance, and a retry
590
+ // usually succeeds, so 5xx responses and connection errors are retried; a 4xx and our own timeout are not.
591
+ private async retryUploadCredentialsRequest<T>(request: () => Promise<T>): Promise<T> {
592
+ const delays = [1000, 3000];
593
+ for (let attempt = 0; ; attempt++) {
594
+ try {
595
+ return await request();
596
+ } catch (error) {
597
+ if (!axios.isAxiosError(error) || error.code === 'ECONNABORTED' || (error.response && error.response.status < 500) || attempt >= delays.length) {
598
+ throw error;
599
+ }
600
+ this.log('warning', 'Upload credentials request failed, retrying: ' + error.message);
601
+ await new Promise(resolve => setTimeout(resolve, delays[attempt]));
602
+ }
603
+ }
604
+ }
605
+
589
606
  private async fetchUploadCredentials(username: string, domain: string): Promise<{ uploadUrl: string; authRestToken: string; authToken: string }> {
590
607
  const baseUrl = this.baseUrl.endsWith("/") ? this.baseUrl : `${this.baseUrl}/`;
591
608
  const url = new URL('api/hosting/v1/files/upload-urls', baseUrl).toString();
@@ -611,7 +628,7 @@ class MCPServer {
611
628
  }
612
629
  };
613
630
 
614
- const response = await axios(config);
631
+ const response = await this.retryUploadCredentialsRequest(() => axios(config));
615
632
 
616
633
  if (response.status !== 200) {
617
634
  throw new Error(`API returned status ${response.status}: ${JSON.stringify(response.data)}`);
@@ -630,6 +647,13 @@ class MCPServer {
630
647
  status: responseStatus,
631
648
  data: typeof responseData === 'object' ? JSON.stringify(responseData) : responseData
632
649
  });
650
+ // Only the API's message and correlation_id are passed on: a 5xx body can carry a stack trace or an
651
+ // upstream page (debug mode), which must not reach the user. The correlation_id lets support trace it.
652
+ if (error.response) {
653
+ const message = typeof responseData?.message === 'string' ? responseData.message.slice(0, 200) : 'no message';
654
+ const correlationId = typeof responseData?.correlation_id === 'string' ? ' (correlation_id: ' + responseData.correlation_id.slice(0, 100) + ')' : '';
655
+ throw new Error('API returned status ' + responseStatus + ': ' + message + correlationId);
656
+ }
633
657
  }
634
658
 
635
659
  throw error;
@@ -3463,6 +3487,23 @@ class MCPServer {
3463
3487
  }
3464
3488
  }
3465
3489
 
3490
+ // upload-urls fails for a few seconds while the server's file browser starts or is under maintenance, and a retry
3491
+ // usually succeeds, so 5xx responses and connection errors are retried; a 4xx and our own timeout are not.
3492
+ private async agencyHosting_retryUploadCredentialsRequest<T>(request: () => Promise<T>): Promise<T> {
3493
+ const delays = [1000, 3000];
3494
+ for (let attempt = 0; ; attempt++) {
3495
+ try {
3496
+ return await request();
3497
+ } catch (error) {
3498
+ if (!axios.isAxiosError(error) || error.code === 'ECONNABORTED' || (error.response && error.response.status < 500) || attempt >= delays.length) {
3499
+ throw error;
3500
+ }
3501
+ this.log('warning', 'Upload credentials request failed, retrying: ' + error.message);
3502
+ await new Promise(resolve => setTimeout(resolve, delays[attempt]));
3503
+ }
3504
+ }
3505
+ }
3506
+
3466
3507
  private async agencyHosting_fetchUploadCredentials(
3467
3508
  websiteUid: string
3468
3509
  ): Promise<{ url: string; auth_key: string; rest_auth_key: string }> {
@@ -3486,7 +3527,7 @@ class MCPServer {
3486
3527
  }
3487
3528
  };
3488
3529
 
3489
- const response = await axios(config);
3530
+ const response = await this.agencyHosting_retryUploadCredentialsRequest(() => axios(config));
3490
3531
 
3491
3532
  if (response.status !== 200) {
3492
3533
  throw new Error(`API returned status ${response.status}: ${JSON.stringify(response.data)}`);
@@ -3505,6 +3546,13 @@ class MCPServer {
3505
3546
  status: responseStatus,
3506
3547
  data: typeof responseData === 'object' ? JSON.stringify(responseData) : responseData
3507
3548
  });
3549
+ // Only the API's message and correlation_id are passed on: a 5xx body can carry a stack trace or an
3550
+ // upstream page (debug mode), which must not reach the user. The correlation_id lets support trace it.
3551
+ if (error.response) {
3552
+ const message = typeof responseData?.message === 'string' ? responseData.message.slice(0, 200) : 'no message';
3553
+ const correlationId = typeof responseData?.correlation_id === 'string' ? ' (correlation_id: ' + responseData.correlation_id.slice(0, 100) + ')' : '';
3554
+ throw new Error('API returned status ' + responseStatus + ': ' + message + correlationId);
3555
+ }
3508
3556
  }
3509
3557
 
3510
3558
  throw error;
@@ -4,4 +4,4 @@ import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/agency-hosting.js';
5
5
  import instructions from '../core/instructions.agency-hosting.js';
6
6
 
7
- startServer({ name: 'hostinger-agency-hosting-mcp', version: '3.31.1', tools, instructions });
7
+ startServer({ name: 'hostinger-agency-hosting-mcp', version: '3.31.3', tools, instructions });
@@ -4,4 +4,4 @@ import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/agency-hosting.js';
5
5
  import instructions from '../core/instructions.agency-hosting.js';
6
6
 
7
- startServer({ name: 'hostinger-agency-hosting-mcp', version: '3.31.1', tools, instructions });
7
+ startServer({ name: 'hostinger-agency-hosting-mcp', version: '3.31.3', tools, instructions });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/agent-readiness.js';
5
5
 
6
- startServer({ name: 'hostinger-agent-readiness-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-agent-readiness-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/agent-readiness.js';
5
5
 
6
- startServer({ name: 'hostinger-agent-readiness-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-agent-readiness-mcp', version: '3.31.3', tools });
@@ -5,4 +5,4 @@ import tools from '../core/tools/all.js';
5
5
  import instructions from '../core/instructions.js';
6
6
  import skills from '../core/skills.js';
7
7
 
8
- startServer({ name: 'hostinger-api-mcp', version: '3.31.1', tools, instructions, skills });
8
+ startServer({ name: 'hostinger-api-mcp', version: '3.31.3', tools, instructions, skills });
@@ -5,4 +5,4 @@ import tools from '../core/tools/all.js';
5
5
  import instructions from '../core/instructions.js';
6
6
  import skills from '../core/skills.js';
7
7
 
8
- startServer({ name: 'hostinger-api-mcp', version: '3.31.1', tools, instructions, skills });
8
+ startServer({ name: 'hostinger-api-mcp', version: '3.31.3', tools, instructions, skills });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/billing.js';
5
5
 
6
- startServer({ name: 'hostinger-billing-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-billing-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/billing.js';
5
5
 
6
- startServer({ name: 'hostinger-billing-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-billing-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/dns.js';
5
5
 
6
- startServer({ name: 'hostinger-dns-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-dns-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/dns.js';
5
5
 
6
- startServer({ name: 'hostinger-dns-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-dns-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/domains.js';
5
5
 
6
- startServer({ name: 'hostinger-domains-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-domains-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/domains.js';
5
5
 
6
- startServer({ name: 'hostinger-domains-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-domains-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/ecommerce.js';
5
5
 
6
- startServer({ name: 'hostinger-ecommerce-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-ecommerce-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/ecommerce.js';
5
5
 
6
- startServer({ name: 'hostinger-ecommerce-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-ecommerce-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/gpu.js';
5
5
 
6
- startServer({ name: 'hostinger-gpu-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-gpu-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/gpu.js';
5
5
 
6
- startServer({ name: 'hostinger-gpu-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-gpu-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/horizons.js';
5
5
 
6
- startServer({ name: 'hostinger-horizons-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-horizons-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/horizons.js';
5
5
 
6
- startServer({ name: 'hostinger-horizons-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-horizons-mcp', version: '3.31.3', tools });
@@ -4,4 +4,4 @@ import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/hosting.js';
5
5
  import instructions from '../core/instructions.js';
6
6
 
7
- startServer({ name: 'hostinger-hosting-mcp', version: '3.31.1', tools, instructions });
7
+ startServer({ name: 'hostinger-hosting-mcp', version: '3.31.3', tools, instructions });
@@ -4,4 +4,4 @@ import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/hosting.js';
5
5
  import instructions from '../core/instructions.js';
6
6
 
7
- startServer({ name: 'hostinger-hosting-mcp', version: '3.31.1', tools, instructions });
7
+ startServer({ name: 'hostinger-hosting-mcp', version: '3.31.3', tools, instructions });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/mail.js';
5
5
 
6
- startServer({ name: 'hostinger-mail-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-mail-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/mail.js';
5
5
 
6
- startServer({ name: 'hostinger-mail-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-mail-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/reach.js';
5
5
 
6
- startServer({ name: 'hostinger-reach-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-reach-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/reach.js';
5
5
 
6
- startServer({ name: 'hostinger-reach-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-reach-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/vps.js';
5
5
 
6
- startServer({ name: 'hostinger-vps-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-vps-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/vps.js';
5
5
 
6
- startServer({ name: 'hostinger-vps-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-vps-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/wordpress.js';
5
5
 
6
- startServer({ name: 'hostinger-wordpress-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-wordpress-mcp', version: '3.31.3', tools });
@@ -3,4 +3,4 @@
3
3
  import { startServer } from '../core/runtime.js';
4
4
  import tools from '../core/tools/wordpress.js';
5
5
 
6
- startServer({ name: 'hostinger-wordpress-mcp', version: '3.31.1', tools });
6
+ startServer({ name: 'hostinger-wordpress-mcp', version: '3.31.3', tools });