@hostinger/mcp 1.52.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.
Files changed (75) hide show
  1. package/.env.example +14 -0
  2. package/.github/ISSUE_TEMPLATE/bug_report.md +36 -0
  3. package/.github/workflows/build-release.yaml +163 -0
  4. package/CODEOWNERS +1 -0
  5. package/Dockerfile +15 -0
  6. package/LICENSE +21 -0
  7. package/README.md +4343 -0
  8. package/build.js +60 -0
  9. package/gemini-extension.json +25 -0
  10. package/glama.json +7 -0
  11. package/package.json +59 -0
  12. package/server.json +29 -0
  13. package/skills/headless/SKILL.md +55 -0
  14. package/skills/headless/entry/bootstrap.mjs +109 -0
  15. package/skills/headless/entry/skill.md +79 -0
  16. package/skills/headless/references/DEPLOYMENT.md +34 -0
  17. package/skills/headless/references/SETUP.md +34 -0
  18. package/skills/headless/references/STORE.md +52 -0
  19. package/skills/headless/references/WORDPRESS.md +51 -0
  20. package/src/core/oauth-error.html +90 -0
  21. package/src/core/oauth-success.html +77 -0
  22. package/src/core/oauth.js +406 -0
  23. package/src/core/oauth.ts +374 -0
  24. package/src/core/runtime.js +2673 -0
  25. package/src/core/runtime.ts +2724 -0
  26. package/src/core/tools/agency-hosting.js +1535 -0
  27. package/src/core/tools/agency-hosting.ts +1550 -0
  28. package/src/core/tools/all.js +15361 -0
  29. package/src/core/tools/all.ts +15376 -0
  30. package/src/core/tools/billing.js +310 -0
  31. package/src/core/tools/billing.ts +325 -0
  32. package/src/core/tools/dns.js +393 -0
  33. package/src/core/tools/dns.ts +408 -0
  34. package/src/core/tools/domains.js +1435 -0
  35. package/src/core/tools/domains.ts +1450 -0
  36. package/src/core/tools/ecommerce.js +1426 -0
  37. package/src/core/tools/ecommerce.ts +1441 -0
  38. package/src/core/tools/horizons.js +84 -0
  39. package/src/core/tools/horizons.ts +99 -0
  40. package/src/core/tools/hosting.js +2479 -0
  41. package/src/core/tools/hosting.ts +2494 -0
  42. package/src/core/tools/mail.js +1641 -0
  43. package/src/core/tools/mail.ts +1656 -0
  44. package/src/core/tools/reach.js +2270 -0
  45. package/src/core/tools/reach.ts +2285 -0
  46. package/src/core/tools/vps.js +2248 -0
  47. package/src/core/tools/vps.ts +2263 -0
  48. package/src/core/tools/wordpress.js +1570 -0
  49. package/src/core/tools/wordpress.ts +1585 -0
  50. package/src/servers/agency-hosting.js +6 -0
  51. package/src/servers/agency-hosting.ts +6 -0
  52. package/src/servers/all.js +6 -0
  53. package/src/servers/all.ts +6 -0
  54. package/src/servers/billing.js +6 -0
  55. package/src/servers/billing.ts +6 -0
  56. package/src/servers/dns.js +6 -0
  57. package/src/servers/dns.ts +6 -0
  58. package/src/servers/domains.js +6 -0
  59. package/src/servers/domains.ts +6 -0
  60. package/src/servers/ecommerce.js +6 -0
  61. package/src/servers/ecommerce.ts +6 -0
  62. package/src/servers/horizons.js +6 -0
  63. package/src/servers/horizons.ts +6 -0
  64. package/src/servers/hosting.js +6 -0
  65. package/src/servers/hosting.ts +6 -0
  66. package/src/servers/mail.js +6 -0
  67. package/src/servers/mail.ts +6 -0
  68. package/src/servers/reach.js +6 -0
  69. package/src/servers/reach.ts +6 -0
  70. package/src/servers/vps.js +6 -0
  71. package/src/servers/vps.ts +6 -0
  72. package/src/servers/wordpress.js +6 -0
  73. package/src/servers/wordpress.ts +6 -0
  74. package/tsconfig.json +15 -0
  75. package/types.d.ts +8836 -0
package/.env.example ADDED
@@ -0,0 +1,14 @@
1
+ # API Configuration
2
+ TRANSPORT=stdio # Fixed to stdio
3
+
4
+ # Debug
5
+ DEBUG=false
6
+
7
+ # OAuth Configuration (used when HOSTINGER_API_TOKEN is not set — stdio mode only)
8
+ # Uncomment to override the default OAuth issuer:
9
+ # OAUTH_ISSUER=https://auth.hostinger.com
10
+
11
+ # --- Authorization Configuration ---
12
+ # Example for HTTP Bearer Token "apiToken"
13
+ APITOKEN=YOUR_TOKEN_VALUE
14
+
@@ -0,0 +1,36 @@
1
+ ---
2
+ name: Bug Report
3
+ about: Create a report to help us improve
4
+ title: '[BUG] '
5
+ labels: 'bug'
6
+ assignees: ''
7
+
8
+ ---
9
+
10
+ ## Bug Description
11
+ <!-- Provide a clear and concise description of what the bug is -->
12
+
13
+ ## Steps to Reproduce
14
+ <!-- List the steps to reproduce the behavior -->
15
+ 1. Go to '...'
16
+ 2. Click on '...'
17
+ 3. Scroll down to '...'
18
+ 4. See error
19
+
20
+ ## Expected Behavior
21
+ <!-- Describe what you expected to happen -->
22
+
23
+ ## Actual Behavior
24
+ <!-- Describe what actually happened -->
25
+
26
+ ## Screenshots
27
+ <!-- If applicable, add screenshots to help explain your problem -->
28
+
29
+ ## Error Messages / Stack Trace
30
+ <!-- If applicable, paste any error messages or stack traces here -->
31
+ ```
32
+ [Paste error message or stack trace here]
33
+ ```
34
+
35
+ ## Additional Context
36
+ <!-- Add any other context about the problem here -->
@@ -0,0 +1,163 @@
1
+ name: build-release
2
+
3
+ on:
4
+ workflow_dispatch:
5
+ push:
6
+ branches:
7
+ - main
8
+
9
+ jobs:
10
+ release:
11
+ runs-on: ubuntu-latest
12
+ permissions:
13
+ id-token: write
14
+ contents: write
15
+ outputs:
16
+ new_version: ${{ steps.version.outputs.version }}
17
+ released: ${{ steps.version.outputs.released }}
18
+ steps:
19
+ - name: Repo checkout
20
+ uses: actions/checkout@v4
21
+ with:
22
+ fetch-depth: 0
23
+
24
+ - name: Resolve version from package.json
25
+ id: version
26
+ run: |
27
+ VERSION=$(jq -r .version package.json)
28
+ echo "version=$VERSION" >> "$GITHUB_OUTPUT"
29
+ if git rev-parse "v$VERSION" >/dev/null 2>&1; then
30
+ echo "released=false" >> "$GITHUB_OUTPUT"
31
+ echo "Tag v$VERSION already exists — skipping release."
32
+ else
33
+ echo "released=true" >> "$GITHUB_OUTPUT"
34
+ fi
35
+
36
+ - name: Create release
37
+ if: steps.version.outputs.released == 'true'
38
+ uses: ncipollo/release-action@v1
39
+ with:
40
+ tag: v${{ steps.version.outputs.version }}
41
+ generateReleaseNotes: true
42
+
43
+ publish-npmjs:
44
+ runs-on: ubuntu-latest
45
+ needs: [release]
46
+ if: needs.release.outputs.released == 'true'
47
+ permissions:
48
+ contents: read
49
+ id-token: write
50
+ steps:
51
+ - uses: actions/checkout@v4
52
+
53
+ - uses: actions/setup-node@v4
54
+ with:
55
+ node-version: '24.x'
56
+ registry-url: 'https://registry.npmjs.org'
57
+
58
+ - name: Update NPM
59
+ run: npm install -g npm@latest
60
+
61
+ - name: Install dependencies
62
+ run: npm install
63
+
64
+ - name: Publish package
65
+ run: npm publish --provenance --access public
66
+
67
+ # The package was published unscoped before moving to @hostinger. Republish
68
+ # each release under the old name so existing installs keep updating.
69
+ # Both names point their npm trusted publisher at this workflow file, which
70
+ # is what the config keys on — the job/step it runs in is not part of it.
71
+ # The name below is substituted by the generator, and is left empty for an
72
+ # API that never had an unscoped package.
73
+ - name: Publish legacy unscoped alias
74
+ run: |
75
+ LEGACY='hostinger-api-mcp'
76
+ if [ -z "$LEGACY" ]; then
77
+ echo "No legacy npm name configured — nothing to alias."
78
+ exit 0
79
+ fi
80
+ jq --arg n "$LEGACY" '.name = $n' package.json > pkg.tmp && mv pkg.tmp package.json
81
+ npm publish --provenance --access public
82
+
83
+ release-github:
84
+ runs-on: ubuntu-latest
85
+ needs: [release]
86
+ if: needs.release.outputs.released == 'true'
87
+ permissions:
88
+ contents: read
89
+ id-token: write
90
+ packages: write
91
+ steps:
92
+ - uses: actions/checkout@v4
93
+
94
+ - uses: actions/setup-node@v4
95
+ with:
96
+ node-version: '24.x'
97
+ registry-url: 'https://npm.pkg.github.com'
98
+ scope: '@hostinger'
99
+
100
+ - name: Install dependencies
101
+ run: npm install
102
+
103
+ - name: Publish package
104
+ run: |
105
+ sed -i 's+"name": ".*+"name": "@${{ github.repository }}",+gI' ./package.json
106
+ npm publish --provenance --access public
107
+ env:
108
+ NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
109
+
110
+ publish-mcp:
111
+ runs-on: ubuntu-latest
112
+ needs: [ release, publish-npmjs ]
113
+ if: needs.release.outputs.released == 'true'
114
+ permissions:
115
+ id-token: write
116
+ contents: read
117
+ steps:
118
+ - name: Checkout repo
119
+ uses: actions/checkout@v4
120
+
121
+ - name: Setup Node.js
122
+ uses: actions/setup-node@v4
123
+ with:
124
+ node-version: '24.x'
125
+
126
+ - name: Install MCP Publisher
127
+ run: |
128
+ curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
129
+ chmod +x ./mcp-publisher
130
+
131
+ - name: Login to MCP Registry using GitHub OIDC
132
+ run: ./mcp-publisher login github-oidc
133
+
134
+ - name: Publish to MCP Registry
135
+ run: ./mcp-publisher publish
136
+
137
+ notify-failure:
138
+ needs: [release, publish-npmjs, release-github, publish-mcp]
139
+ if: failure()
140
+ runs-on: ubuntu-latest
141
+ steps:
142
+ - name: Notify Slack on release failure
143
+ uses: slackapi/slack-github-action@v4.0.0
144
+ with:
145
+ errors: true
146
+ webhook: ${{ secrets.PLATFORM_INCIDENT_SLACK_CHANNEL_WEBHOOK }}
147
+ webhook-type: incoming-webhook
148
+ payload: |
149
+ text: ":rotating_light: Release failed in ${{ github.repository }}"
150
+ blocks:
151
+ - type: section
152
+ text:
153
+ type: mrkdwn
154
+ text: |
155
+ :rotating_light: *Release failed:* `${{ github.repository }}`
156
+ *Commit:* <${{ github.server_url }}/${{ github.repository }}/commit/${{ github.sha }}|${{ github.sha }}>
157
+ - type: actions
158
+ elements:
159
+ - type: button
160
+ text:
161
+ type: plain_text
162
+ text: "View failed run"
163
+ url: "${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"
package/CODEOWNERS ADDED
@@ -0,0 +1 @@
1
+ * @hostinger/platform-team
package/Dockerfile ADDED
@@ -0,0 +1,15 @@
1
+ FROM node:24.4.1-alpine
2
+
3
+ WORKDIR /app
4
+
5
+ COPY package.json package-lock.json* ./
6
+
7
+ RUN npm ci --only=production
8
+
9
+ COPY . .
10
+
11
+ ENV NODE_ENV=production
12
+
13
+ RUN chmod +x server.js
14
+
15
+ CMD ["node", "server.js"]
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) Hostinger
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.