@hostinger/mcp 3.37.0 → 3.38.0
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 +38 -0
- package/README.md +8 -1
- package/gemini-extension.json +1 -1
- package/package.json +1 -1
- package/server.json +2 -2
- package/skills/deploy-to-hosting/SKILL.md +1 -1
- package/skills/headless/VERSION +3 -3
- package/src/core/catalog.js +9 -1
- package/src/core/catalog.ts +11 -2
- package/src/core/instructions.agency-hosting.js +1 -1
- package/src/core/instructions.agency-hosting.ts +1 -1
- package/src/core/instructions.js +1 -1
- package/src/core/instructions.ts +1 -1
- package/src/core/runtime.js +3 -1484
- package/src/core/runtime.ts +5 -1484
- package/src/core/skills.js +3 -3
- package/src/core/skills.ts +3 -3
- package/src/core/tools/agency-hosting.ts +2 -0
- package/src/core/tools/agent-readiness.ts +2 -0
- package/src/core/tools/all.js +75 -333
- package/src/core/tools/all.ts +77 -333
- package/src/core/tools/billing.ts +2 -0
- package/src/core/tools/dns.ts +2 -0
- package/src/core/tools/domains.js +3 -3
- package/src/core/tools/domains.ts +5 -3
- package/src/core/tools/ecommerce.ts +2 -0
- package/src/core/tools/gpu.ts +2 -0
- package/src/core/tools/horizons.ts +2 -0
- package/src/core/tools/hosting.js +63 -327
- package/src/core/tools/hosting.ts +65 -327
- package/src/core/tools/mail.ts +2 -0
- package/src/core/tools/reach.ts +2 -0
- package/src/core/tools/vps.ts +2 -0
- package/src/core/tools/wordpress.ts +2 -0
- package/src/servers/agency-hosting.js +1 -1
- package/src/servers/agency-hosting.ts +1 -1
- package/src/servers/agent-readiness.js +1 -1
- package/src/servers/agent-readiness.ts +1 -1
- package/src/servers/all.js +1 -1
- package/src/servers/all.ts +1 -1
- package/src/servers/billing.js +1 -1
- package/src/servers/billing.ts +1 -1
- package/src/servers/dns.js +1 -1
- package/src/servers/dns.ts +1 -1
- package/src/servers/domains.js +1 -1
- package/src/servers/domains.ts +1 -1
- package/src/servers/ecommerce.js +1 -1
- package/src/servers/ecommerce.ts +1 -1
- package/src/servers/gpu.js +1 -1
- package/src/servers/gpu.ts +1 -1
- package/src/servers/horizons.js +1 -1
- package/src/servers/horizons.ts +1 -1
- package/src/servers/hosting.js +1 -1
- package/src/servers/hosting.ts +1 -1
- package/src/servers/mail.js +1 -1
- package/src/servers/mail.ts +1 -1
- package/src/servers/reach.js +1 -1
- package/src/servers/reach.ts +1 -1
- package/src/servers/vps.js +1 -1
- package/src/servers/vps.ts +1 -1
- package/src/servers/wordpress.js +1 -1
- package/src/servers/wordpress.ts +1 -1
- package/types.d.ts +9 -157
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,44 @@ 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.38.0 — 2026-11-11
|
|
8
|
+
|
|
9
|
+
### Operations
|
|
10
|
+
|
|
11
|
+
- Removed `hosting_import-wordpress-website`
|
|
12
|
+
- Removed `hosting_deploy-wordpress-plugin`
|
|
13
|
+
- Removed `hosting_deploy-wordpress-theme`
|
|
14
|
+
- Removed `hosting_deploy-js-application`
|
|
15
|
+
- Removed `hosting_deploy-static-website`
|
|
16
|
+
- Removed `hosting_list-js-deployments`
|
|
17
|
+
- Removed `hosting_show-js-deployment-logs`
|
|
18
|
+
- `execute` no longer runs 2 operations that `hosting_cache_clear` replaced: `hosting_cache_clear-website`, `hosting_cdn_purge-cache`
|
|
19
|
+
- `execute` no longer runs 3 operations that `hosting_websites_get-settings` replaced: `hosting_cache_status`, `hosting_cdn_status`, `hosting_ssl_status`
|
|
20
|
+
- `execute` no longer runs 5 operations that `hosting_websites_update-settings` replaced: `hosting_cache_toggle-cacheless`, `hosting_cache_toggle-website`, `hosting_cdn_disable`, `hosting_cdn_enable`, `hosting_ssl_toggle-https-redirect`
|
|
21
|
+
- `execute` no longer runs 6 operations that `hosting_get-deployment` replaced: `hosting_git_auto-deployment-settings`, `hosting_nodejs_list-builds`, `hosting_nodejs_build-settings`, `hosting_nodejs_analyse-failed-build`, `hosting_nodejs_build`, `hosting_nodejs_build-logs`
|
|
22
|
+
- `execute` no longer runs 8 operations that `hosting_deploy` replaced: `hosting_nodejs_start-build`, `hosting_nodejs_update-build-settings`, `hosting_nodejs_build-settings-from-archive`, `hosting_nodejs_build-settings-from-repository`, `hosting_websites_deploy-static-site-archive`, `wordpress_installations_import-website`, `wordpress_plugins_deploy`, `wordpress_themes_deploy`
|
|
23
|
+
|
|
24
|
+
### Also in this release
|
|
25
|
+
|
|
26
|
+
- Documentation: `README.md`
|
|
27
|
+
- Bundled agent skills: `skills/deploy-to-hosting/SKILL.md`, `skills/headless/VERSION`
|
|
28
|
+
- Request handling and authentication: 4 files
|
|
29
|
+
- Server instructions: 4 files
|
|
30
|
+
- Other files: `src/core/skills.js`, `src/core/skills.ts`
|
|
31
|
+
- Build and packaging: `types.d.ts`
|
|
32
|
+
|
|
33
|
+
## v3.37.1 — 2026-11-10
|
|
34
|
+
|
|
35
|
+
### Operations
|
|
36
|
+
|
|
37
|
+
- Changed the description and input schema of `domains_whois_create`
|
|
38
|
+
|
|
39
|
+
### Also in this release
|
|
40
|
+
|
|
41
|
+
- Documentation: `README.md`
|
|
42
|
+
- Request handling and authentication: `src/core/runtime.js`, `src/core/runtime.ts`
|
|
43
|
+
- Build and packaging: `types.d.ts`
|
|
44
|
+
|
|
7
45
|
## v3.37.0 — 2026-11-10
|
|
8
46
|
|
|
9
47
|
### Operations
|
package/README.md
CHANGED
|
@@ -244,7 +244,7 @@ Every server exposes three tools:
|
|
|
244
244
|
|
|
245
245
|
The operations `search` offers, by binary:
|
|
246
246
|
|
|
247
|
-
Operations that newer tools replace are hidden from `search`, and not documented, in every binary that also offers the replacing tool.
|
|
247
|
+
Operations that newer tools replace are hidden from `search`, and not documented, in every binary that also offers the replacing tool. Some keep working through `execute` until they are removed. Others only run inside the tool that replaced them: `execute` refuses them and names that tool.
|
|
248
248
|
|
|
249
249
|
### `hostinger-agency-hosting-mcp`
|
|
250
250
|
|
|
@@ -1555,6 +1555,13 @@ Create WHOIS contact profile.
|
|
|
1555
1555
|
|
|
1556
1556
|
Use this endpoint to add new contact information for domain registration.
|
|
1557
1557
|
|
|
1558
|
+
The keys required in `whois_details` and `tld_details` depend on the TLD, country and entity type, and can be
|
|
1559
|
+
country-specific: for Lithuania, for example, `state_lt` and `zip_lt` are required instead of `state` and
|
|
1560
|
+
`zip`. A 422 response lists every required key that is missing or has an invalid value under
|
|
1561
|
+
`errors.whois_details`, and under `errors.tld_details` when `tld_details` is sent. Each error states the
|
|
1562
|
+
key's constraint and, where the key takes a fixed set of values, the allowed values, so all of them can be
|
|
1563
|
+
corrected in one retry.
|
|
1564
|
+
|
|
1558
1565
|
- **Method**: `POST`
|
|
1559
1566
|
- **Path**: `/api/domains/v1/whois`
|
|
1560
1567
|
|
package/gemini-extension.json
CHANGED
package/package.json
CHANGED
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.
|
|
20
|
+
"version": "3.38.0",
|
|
21
21
|
"packages": [
|
|
22
22
|
{
|
|
23
23
|
"registryType": "npm",
|
|
24
24
|
"identifier": "@hostinger/mcp",
|
|
25
|
-
"version": "3.
|
|
25
|
+
"version": "3.38.0",
|
|
26
26
|
"transport": {
|
|
27
27
|
"type": "stdio"
|
|
28
28
|
},
|
|
@@ -112,7 +112,7 @@ Agency Plan sites have no Git operations; deploy archives.
|
|
|
112
112
|
|
|
113
113
|
1. `hosting_nodejs_list-environment-variables` for the current keys. Values come back as `********`; never send those back.
|
|
114
114
|
2. Build the full set: every current key plus the new ones, with real values from the project's `.env` or the user. When the real value of an existing key is unknown, ask — do not drop it.
|
|
115
|
-
3. Send it once; the app restarts. Values baked in at build time (Next.js `NEXT_PUBLIC_*`, Vite `VITE_*`) need a new `hosting_nodejs_start-build
|
|
115
|
+
3. Send it once; the app restarts. Values baked in at build time (Next.js `NEXT_PUBLIC_*`, Vite `VITE_*`) need a new build: deploy again with `hosting_deploy`; for local files uploaded to the hosted server, run `hosting_nodejs_start-build` again as in step 2.
|
|
116
116
|
|
|
117
117
|
Keys use uppercase letters, digits and underscores. Never commit `.env` files or repeat secret values back to the user.
|
|
118
118
|
|
package/skills/headless/VERSION
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
version=3.
|
|
2
|
-
commit=
|
|
3
|
-
built=2026-11-
|
|
1
|
+
version=3.38.0
|
|
2
|
+
commit=219b2963ff62
|
|
3
|
+
built=2026-11-11
|
package/src/core/catalog.js
CHANGED
|
@@ -3,7 +3,9 @@
|
|
|
3
3
|
// runtime supplies the catalog and the function that performs a call.
|
|
4
4
|
// Keep in sync with catalog.ts and with api-remote-mcp's PHP implementation.
|
|
5
5
|
// Both servers honour `hidden`: search skips the entry, execute and multi-execute still run
|
|
6
|
-
// it.
|
|
6
|
+
// it. They also honour `internal` (always hidden too): execute and multi-execute refuse the entry,
|
|
7
|
+
// naming its `replacedBy`, while the tool that replaced it still calls it. Each server has its own
|
|
8
|
+
// lists (generators.mcp.hiddenFile and generators.remote-mcp.hiddenFile).
|
|
7
9
|
|
|
8
10
|
export const DEFAULT_SEARCH_LIMIT = 5;
|
|
9
11
|
export const MAX_SEARCH_LIMIT = 20;
|
|
@@ -130,6 +132,12 @@ export function findOperation(operations, name, params) {
|
|
|
130
132
|
if (typeof name !== 'string' || !operations.has(name)) {
|
|
131
133
|
throw new ToolInputError(`Unknown operation "${name}". Use search to find operations.`);
|
|
132
134
|
}
|
|
135
|
+
const replaced = operations.get(name);
|
|
136
|
+
if (replaced.internal === true) {
|
|
137
|
+
throw new ToolInputError(replaced.replacedBy
|
|
138
|
+
? `Operation ${name} was replaced by ${replaced.replacedBy} and can no longer be run directly. Use ${replaced.replacedBy} instead.`
|
|
139
|
+
: `Operation ${name} can no longer be run directly. Use search to find its replacement.`);
|
|
140
|
+
}
|
|
133
141
|
if (params === null || typeof params !== 'object' || Array.isArray(params)) {
|
|
134
142
|
throw new ToolInputError('params must be an object');
|
|
135
143
|
}
|
package/src/core/catalog.ts
CHANGED
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
// Typed mirror of catalog.js. Keep both files, and api-remote-mcp's PHP
|
|
2
2
|
// implementation, behaviourally identical. Both servers honour `hidden`: search skips the
|
|
3
|
-
// entry, execute and multi-execute still run it.
|
|
4
|
-
//
|
|
3
|
+
// entry, execute and multi-execute still run it. They also honour `internal` (always hidden
|
|
4
|
+
// too): execute and multi-execute refuse the entry, naming its `replacedBy`, while the tool that
|
|
5
|
+
// replaced it still calls it. Each server has its own lists (the files generators.mcp.hiddenFile
|
|
6
|
+
// and generators.remote-mcp.hiddenFile point to).
|
|
5
7
|
|
|
6
8
|
export const DEFAULT_SEARCH_LIMIT = 5;
|
|
7
9
|
export const MAX_SEARCH_LIMIT = 20;
|
|
@@ -15,6 +17,8 @@ export interface CatalogOperation {
|
|
|
15
17
|
description?: string;
|
|
16
18
|
group?: string;
|
|
17
19
|
hidden?: boolean;
|
|
20
|
+
internal?: boolean;
|
|
21
|
+
replacedBy?: string;
|
|
18
22
|
annotations?: { readOnlyHint?: boolean; destructiveHint?: boolean; [key: string]: unknown };
|
|
19
23
|
inputSchema: { type: 'object'; properties?: Record<string, unknown>; required?: string[]; [key: string]: unknown };
|
|
20
24
|
}
|
|
@@ -151,6 +155,11 @@ export function findOperation<T extends CatalogOperation>(operations: Map<string
|
|
|
151
155
|
if (!op) {
|
|
152
156
|
throw new ToolInputError(`Unknown operation "${String(name)}". Use search to find operations.`);
|
|
153
157
|
}
|
|
158
|
+
if (op.internal === true) {
|
|
159
|
+
throw new ToolInputError(op.replacedBy
|
|
160
|
+
? `Operation ${op.name} was replaced by ${op.replacedBy} and can no longer be run directly. Use ${op.replacedBy} instead.`
|
|
161
|
+
: `Operation ${op.name} can no longer be run directly. Use search to find its replacement.`);
|
|
162
|
+
}
|
|
154
163
|
if (params === null || typeof params !== 'object' || Array.isArray(params)) {
|
|
155
164
|
throw new ToolInputError('params must be an object');
|
|
156
165
|
}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
// Auto-generated server instructions
|
|
2
|
-
export default "Hostinger API notes for agents. Find operations with search; the inputSchema it returns is authoritative for request shapes. Run one with execute, or chain several with multi-execute.\n\nDatabases (web hosting, hosting_* operations)\n- MySQL runs on the same server as the website. From the deployed app connect to host 127.0.0.1, port 3306. PHP may also use localhost (Unix socket). Node.js should use 127.0.0.1: localhost can resolve to IPv6 (::1) and not every database user has that grant.\n- The `host` from hosting_databases_list (srvNNNN.hstgr.io) is only for connections from outside Hostinger, after hosting_databases_create-remote-connection. Never use it from the app.\n- Agency Plan (agency-hosting_* operations) database users are created for localhost; the PHP app connects there.\n\nAsynchronous operations\n- A success response often means \"queued\", not \"done\". Poll the matching read operation with backoff (seconds, then minutes). Never re-send the write.\n- hosting_websites_create -> poll hosting_websites_list-setups with the domain until status is completed (a few minutes); file, deploy and database calls return 404/409 before that.\n- A Node.js deploy or
|
|
2
|
+
export default "Hostinger API notes for agents. Find operations with search; the inputSchema it returns is authoritative for request shapes. Run one with execute, or chain several with multi-execute.\n\nDatabases (web hosting, hosting_* operations)\n- MySQL runs on the same server as the website. From the deployed app connect to host 127.0.0.1, port 3306. PHP may also use localhost (Unix socket). Node.js should use 127.0.0.1: localhost can resolve to IPv6 (::1) and not every database user has that grant.\n- The `host` from hosting_databases_list (srvNNNN.hstgr.io) is only for connections from outside Hostinger, after hosting_databases_create-remote-connection. Never use it from the app.\n- Agency Plan (agency-hosting_* operations) database users are created for localhost; the PHP app connects there.\n\nAsynchronous operations\n- A success response often means \"queued\", not \"done\". Poll the matching read operation with backoff (seconds, then minutes). Never re-send the write.\n- hosting_websites_create -> poll hosting_websites_list-setups with the domain until status is completed (a few minutes); file, deploy and database calls return 404/409 before that.\n- A Node.js deploy or build -> poll hosting_get-deployment with the domain until the build state is completed or failed; a failed build comes back with its logs and failure analysis.\n- wordpress_installations_install and WordPress plugin/theme/core jobs -> poll wordpress_installations_list.\n- agency-hosting_website-setups_create -> poll agency-hosting_website-setups_status with setup_uuid; other Agency Plan jobs -> agency-hosting_websites_list-processes.\n- Website deletion, database repair and domain contact changes finish in the background.\n\nCredentials\n- Never write database passwords or API tokens into source code, client-side JavaScript or committed .env files.\n- Node.js apps read them from environment variables: set the full set with hosting_nodejs_replace-environment-variables (full replace; values are masked on read). Build-time variables (Next.js) need a new build afterwards.\n- PHP apps read them from a config file on the server, outside the repository.\n- Generate strong passwords and do not echo them back once stored.\n\nDeploying from a shell\n- The Hostinger CLI deploys a website in one command and links the directory: `hostinger up <dir> --domain <domain> --format json` (`--yes` replaces content, `--create` makes a site, `--dry-run` shows the plan). It never prompts without a terminal.\n\nProduct updates\n- For what is new at Hostinger (release notes, recent changes, new features), call changelog_list-entries, filtered by `product` and `since`. For what is coming (the roadmap), call it with `status: upcoming`. It needs no API token.\n\nFor end-to-end site builds install the headless skill: npx skills add hostinger/api-mcp-server";
|
|
@@ -1,3 +1,3 @@
|
|
|
1
1
|
// Auto-generated server instructions
|
|
2
|
-
const instructions: string = "Hostinger API notes for agents. Find operations with search; the inputSchema it returns is authoritative for request shapes. Run one with execute, or chain several with multi-execute.\n\nDatabases (web hosting, hosting_* operations)\n- MySQL runs on the same server as the website. From the deployed app connect to host 127.0.0.1, port 3306. PHP may also use localhost (Unix socket). Node.js should use 127.0.0.1: localhost can resolve to IPv6 (::1) and not every database user has that grant.\n- The `host` from hosting_databases_list (srvNNNN.hstgr.io) is only for connections from outside Hostinger, after hosting_databases_create-remote-connection. Never use it from the app.\n- Agency Plan (agency-hosting_* operations) database users are created for localhost; the PHP app connects there.\n\nAsynchronous operations\n- A success response often means \"queued\", not \"done\". Poll the matching read operation with backoff (seconds, then minutes). Never re-send the write.\n- hosting_websites_create -> poll hosting_websites_list-setups with the domain until status is completed (a few minutes); file, deploy and database calls return 404/409 before that.\n- A Node.js deploy or
|
|
2
|
+
const instructions: string = "Hostinger API notes for agents. Find operations with search; the inputSchema it returns is authoritative for request shapes. Run one with execute, or chain several with multi-execute.\n\nDatabases (web hosting, hosting_* operations)\n- MySQL runs on the same server as the website. From the deployed app connect to host 127.0.0.1, port 3306. PHP may also use localhost (Unix socket). Node.js should use 127.0.0.1: localhost can resolve to IPv6 (::1) and not every database user has that grant.\n- The `host` from hosting_databases_list (srvNNNN.hstgr.io) is only for connections from outside Hostinger, after hosting_databases_create-remote-connection. Never use it from the app.\n- Agency Plan (agency-hosting_* operations) database users are created for localhost; the PHP app connects there.\n\nAsynchronous operations\n- A success response often means \"queued\", not \"done\". Poll the matching read operation with backoff (seconds, then minutes). Never re-send the write.\n- hosting_websites_create -> poll hosting_websites_list-setups with the domain until status is completed (a few minutes); file, deploy and database calls return 404/409 before that.\n- A Node.js deploy or build -> poll hosting_get-deployment with the domain until the build state is completed or failed; a failed build comes back with its logs and failure analysis.\n- wordpress_installations_install and WordPress plugin/theme/core jobs -> poll wordpress_installations_list.\n- agency-hosting_website-setups_create -> poll agency-hosting_website-setups_status with setup_uuid; other Agency Plan jobs -> agency-hosting_websites_list-processes.\n- Website deletion, database repair and domain contact changes finish in the background.\n\nCredentials\n- Never write database passwords or API tokens into source code, client-side JavaScript or committed .env files.\n- Node.js apps read them from environment variables: set the full set with hosting_nodejs_replace-environment-variables (full replace; values are masked on read). Build-time variables (Next.js) need a new build afterwards.\n- PHP apps read them from a config file on the server, outside the repository.\n- Generate strong passwords and do not echo them back once stored.\n\nDeploying from a shell\n- The Hostinger CLI deploys a website in one command and links the directory: `hostinger up <dir> --domain <domain> --format json` (`--yes` replaces content, `--create` makes a site, `--dry-run` shows the plan). It never prompts without a terminal.\n\nProduct updates\n- For what is new at Hostinger (release notes, recent changes, new features), call changelog_list-entries, filtered by `product` and `since`. For what is coming (the roadmap), call it with `status: upcoming`. It needs no API token.\n\nFor end-to-end site builds install the headless skill: npx skills add hostinger/api-mcp-server";
|
|
3
3
|
export default instructions;
|
package/src/core/instructions.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
// Auto-generated server instructions
|
|
2
|
-
export default "Hostinger API notes for agents. Find operations with search; the inputSchema it returns is authoritative for request shapes. Run one with execute, or chain several with multi-execute.\n\nDatabases (web hosting, hosting_* operations)\n- MySQL runs on the same server as the website. From the deployed app connect to host 127.0.0.1, port 3306. PHP may also use localhost (Unix socket). Node.js should use 127.0.0.1: localhost can resolve to IPv6 (::1) and not every database user has that grant.\n- The `host` from hosting_databases_list (srvNNNN.hstgr.io) is only for connections from outside Hostinger, after hosting_databases_create-remote-connection. Never use it from the app.\n- Agency Plan (agency-hosting_* operations) database users are created for localhost; the PHP app connects there.\n\nAsynchronous operations\n- A success response often means \"queued\", not \"done\". Poll the matching read operation with backoff (seconds, then minutes). Never re-send the write.\n- hosting_websites_create -> poll hosting_websites_list-setups with the domain until status is completed (a few minutes); file, deploy and database calls return 404/409 before that.\n- A Node.js deploy or
|
|
2
|
+
export default "Hostinger API notes for agents. Find operations with search; the inputSchema it returns is authoritative for request shapes. Run one with execute, or chain several with multi-execute.\n\nDatabases (web hosting, hosting_* operations)\n- MySQL runs on the same server as the website. From the deployed app connect to host 127.0.0.1, port 3306. PHP may also use localhost (Unix socket). Node.js should use 127.0.0.1: localhost can resolve to IPv6 (::1) and not every database user has that grant.\n- The `host` from hosting_databases_list (srvNNNN.hstgr.io) is only for connections from outside Hostinger, after hosting_databases_create-remote-connection. Never use it from the app.\n- Agency Plan (agency-hosting_* operations) database users are created for localhost; the PHP app connects there.\n\nAsynchronous operations\n- A success response often means \"queued\", not \"done\". Poll the matching read operation with backoff (seconds, then minutes). Never re-send the write.\n- hosting_websites_create -> poll hosting_websites_list-setups with the domain until status is completed (a few minutes); file, deploy and database calls return 404/409 before that.\n- A Node.js deploy or build -> poll hosting_get-deployment with the domain until the build state is completed or failed; a failed build comes back with its logs and failure analysis.\n- wordpress_installations_install and WordPress plugin/theme/core jobs -> poll wordpress_installations_list.\n- agency-hosting_website-setups_create -> poll agency-hosting_website-setups_status with setup_uuid; other Agency Plan jobs -> agency-hosting_websites_list-processes.\n- Website deletion, database repair and domain contact changes finish in the background.\n\nCredentials\n- Never write database passwords or API tokens into source code, client-side JavaScript or committed .env files.\n- Node.js apps read them from environment variables: set the full set with hosting_nodejs_replace-environment-variables (full replace; values are masked on read). Build-time variables (Next.js) need a new build afterwards.\n- PHP apps read them from a config file on the server, outside the repository.\n- Generate strong passwords and do not echo them back once stored.\n\nDeploying from a shell\n- The Hostinger CLI deploys a website in one command and links the directory: `hostinger up <dir> --domain <domain> --format json` (`--yes` replaces content, `--create` makes a site, `--dry-run` shows the plan). It never prompts without a terminal.\n\nDeploying a website (this server only)\n- hosting_deploy replaces the upload, archive-deploy, build, WordPress import/plugin/theme and Git operations named above. Give it a local directory (it detects static/PHP, Node.js, a WordPress site, plugin or theme and packs it itself), a local archive with `type`, or `git: { repository, branch }`. Do not run those operations by hand.\n- A Node.js deploy returns a buildUuid at once and builds on the server. Poll hosting_get-deployment with the domain, pausing longer each time, until the build state is completed or failed. A failed build comes back with its logs and analysis: fix the cause and deploy again. It replaces the build, log and settings operations.\n- Static, PHP, plugin and theme deploys are complete when hosting_deploy returns. A WordPress site import only starts: its files are extracted and the site is ready a few minutes later.\n- Every deploy overwrites the site's contents: confirm the domain with the user before the first deploy to a site that already has content.\n\nProduct updates\n- For what is new at Hostinger (release notes, recent changes, new features), call changelog_list-entries, filtered by `product` and `since`. For what is coming (the roadmap), call it with `status: upcoming`. It needs no API token.\n\nFor end-to-end site builds install the headless skill: npx skills add hostinger/api-mcp-server";
|
package/src/core/instructions.ts
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
1
|
// Auto-generated server instructions
|
|
2
|
-
const instructions: string = "Hostinger API notes for agents. Find operations with search; the inputSchema it returns is authoritative for request shapes. Run one with execute, or chain several with multi-execute.\n\nDatabases (web hosting, hosting_* operations)\n- MySQL runs on the same server as the website. From the deployed app connect to host 127.0.0.1, port 3306. PHP may also use localhost (Unix socket). Node.js should use 127.0.0.1: localhost can resolve to IPv6 (::1) and not every database user has that grant.\n- The `host` from hosting_databases_list (srvNNNN.hstgr.io) is only for connections from outside Hostinger, after hosting_databases_create-remote-connection. Never use it from the app.\n- Agency Plan (agency-hosting_* operations) database users are created for localhost; the PHP app connects there.\n\nAsynchronous operations\n- A success response often means \"queued\", not \"done\". Poll the matching read operation with backoff (seconds, then minutes). Never re-send the write.\n- hosting_websites_create -> poll hosting_websites_list-setups with the domain until status is completed (a few minutes); file, deploy and database calls return 404/409 before that.\n- A Node.js deploy or
|
|
2
|
+
const instructions: string = "Hostinger API notes for agents. Find operations with search; the inputSchema it returns is authoritative for request shapes. Run one with execute, or chain several with multi-execute.\n\nDatabases (web hosting, hosting_* operations)\n- MySQL runs on the same server as the website. From the deployed app connect to host 127.0.0.1, port 3306. PHP may also use localhost (Unix socket). Node.js should use 127.0.0.1: localhost can resolve to IPv6 (::1) and not every database user has that grant.\n- The `host` from hosting_databases_list (srvNNNN.hstgr.io) is only for connections from outside Hostinger, after hosting_databases_create-remote-connection. Never use it from the app.\n- Agency Plan (agency-hosting_* operations) database users are created for localhost; the PHP app connects there.\n\nAsynchronous operations\n- A success response often means \"queued\", not \"done\". Poll the matching read operation with backoff (seconds, then minutes). Never re-send the write.\n- hosting_websites_create -> poll hosting_websites_list-setups with the domain until status is completed (a few minutes); file, deploy and database calls return 404/409 before that.\n- A Node.js deploy or build -> poll hosting_get-deployment with the domain until the build state is completed or failed; a failed build comes back with its logs and failure analysis.\n- wordpress_installations_install and WordPress plugin/theme/core jobs -> poll wordpress_installations_list.\n- agency-hosting_website-setups_create -> poll agency-hosting_website-setups_status with setup_uuid; other Agency Plan jobs -> agency-hosting_websites_list-processes.\n- Website deletion, database repair and domain contact changes finish in the background.\n\nCredentials\n- Never write database passwords or API tokens into source code, client-side JavaScript or committed .env files.\n- Node.js apps read them from environment variables: set the full set with hosting_nodejs_replace-environment-variables (full replace; values are masked on read). Build-time variables (Next.js) need a new build afterwards.\n- PHP apps read them from a config file on the server, outside the repository.\n- Generate strong passwords and do not echo them back once stored.\n\nDeploying from a shell\n- The Hostinger CLI deploys a website in one command and links the directory: `hostinger up <dir> --domain <domain> --format json` (`--yes` replaces content, `--create` makes a site, `--dry-run` shows the plan). It never prompts without a terminal.\n\nDeploying a website (this server only)\n- hosting_deploy replaces the upload, archive-deploy, build, WordPress import/plugin/theme and Git operations named above. Give it a local directory (it detects static/PHP, Node.js, a WordPress site, plugin or theme and packs it itself), a local archive with `type`, or `git: { repository, branch }`. Do not run those operations by hand.\n- A Node.js deploy returns a buildUuid at once and builds on the server. Poll hosting_get-deployment with the domain, pausing longer each time, until the build state is completed or failed. A failed build comes back with its logs and analysis: fix the cause and deploy again. It replaces the build, log and settings operations.\n- Static, PHP, plugin and theme deploys are complete when hosting_deploy returns. A WordPress site import only starts: its files are extracted and the site is ready a few minutes later.\n- Every deploy overwrites the site's contents: confirm the domain with the user before the first deploy to a site that already has content.\n\nProduct updates\n- For what is new at Hostinger (release notes, recent changes, new features), call changelog_list-entries, filtered by `product` and `since`. For what is coming (the roadmap), call it with `status: upcoming`. It needs no API token.\n\nFor end-to-end site builds install the headless skill: npx skills add hostinger/api-mcp-server";
|
|
3
3
|
export default instructions;
|