@taghost/mcp 0.0.0-stage → 1.0.1
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/LICENSE +13 -0
- package/README.md +202 -2
- package/bin/taghost-mcp.js +8 -0
- package/dist/chunk-4FYLZWKE.js +2557 -0
- package/dist/chunk-C6FKJRVE.js +3366 -0
- package/dist/chunk-JBAFKRD6.js +3055 -0
- package/dist/chunk-JKPKXGK7.js +3384 -0
- package/dist/chunk-MLB5IOSJ.js +3369 -0
- package/dist/chunk-MNN4GVXS.js +3299 -0
- package/dist/chunk-NP37ZIKB.js +3469 -0
- package/dist/chunk-OXMBSGNP.js +3372 -0
- package/dist/chunk-Q3OLOBV3.js +2557 -0
- package/dist/chunk-TTGSOFO6.js +2557 -0
- package/dist/chunk-ZM4TEOAC.js +3446 -0
- package/dist/chunk-ZSIUY6WV.js +3607 -0
- package/dist/index.cjs +3856 -0
- package/dist/index.d.cts +344 -0
- package/dist/index.d.ts +344 -0
- package/dist/index.js +230 -0
- package/dist/server-BAkdXx6J.d.cts +208 -0
- package/dist/server-BAkdXx6J.d.ts +208 -0
- package/dist/server-BzjamriK.d.cts +215 -0
- package/dist/server-BzjamriK.d.ts +215 -0
- package/dist/server-CtoaFyBz.d.cts +206 -0
- package/dist/server-CtoaFyBz.d.ts +206 -0
- package/dist/server-Cw4f_xvI.d.cts +158 -0
- package/dist/server-Cw4f_xvI.d.ts +158 -0
- package/dist/server-VIC-6nA0.d.cts +207 -0
- package/dist/server-VIC-6nA0.d.ts +207 -0
- package/dist/server-XvrYGhnU.d.cts +209 -0
- package/dist/server-XvrYGhnU.d.ts +209 -0
- package/dist/server.cjs +3596 -0
- package/dist/server.d.cts +2 -0
- package/dist/server.d.ts +2 -0
- package/dist/server.js +8 -0
- package/openapi.json +276 -0
- package/package.json +74 -3
- package/smithery.yaml +21 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
Copyright (c) 2026 TagHost. All rights reserved.
|
|
2
|
+
|
|
3
|
+
This software is proprietary and confidential. No part of it may be used,
|
|
4
|
+
copied, modified, merged, published, distributed, sublicensed, sold, or
|
|
5
|
+
otherwise exploited without the prior written permission of TagHost.
|
|
6
|
+
|
|
7
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
8
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
9
|
+
FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
10
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
|
|
11
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
12
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
13
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,203 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @taghost/mcp
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> First-party Model Context Protocol (MCP) Server for TagHost: Enable autonomous AI agents (Claude Desktop, Cursor, Codex, OpenCode, Antigravity) to build, manage, deploy, and scale web applications, e-commerce storefronts, business email, and cloud infrastructure on TagHost without touching a browser.
|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## Capabilities
|
|
8
|
+
|
|
9
|
+
The TagHost MCP Server covers the entire TagHost developer platform across 10 core capability areas:
|
|
10
|
+
|
|
11
|
+
| Domain | Key Tools | Description |
|
|
12
|
+
| :--- | :--- | :--- |
|
|
13
|
+
| **Projects** | `taghost_project_create`, `taghost_project_list`, `taghost_project_get`, `taghost_env_manage` | Provision projects, inspect active deployment status, and manage scoped environment variables. |
|
|
14
|
+
| **Deployments** | `taghost_deploy_bundle`, `taghost_publish_files`, `taghost_deployment_status`, `taghost_deployment_rollback`, `taghost_deployment_set_expiry` | Full static ZIP bundle edge deploys, atomic rollbacks, and non-destructive partial file updates. |
|
|
15
|
+
| **TagMail** | `taghost_mail_threads_list`, `taghost_mail_thread_get`, `taghost_mail_send`, `taghost_mail_create_mailbox`, `taghost_mail_domain_verify` | Check inbox threads, read customer emails, send transactional or direct messages, create corporate mailboxes, and verify MX/SPF/DKIM/DMARC. |
|
|
16
|
+
| **Domains & DNS** | `taghost_domain_check`, `taghost_domain_search`, `taghost_domain_checkout`, `taghost_domain_attach`, `taghost_domain_verify`, `taghost_dns_manage` | Real-time domain search, wholesale domain purchase & registration, Bring-Your-Own-Domain mapping, and edge DNS management. |
|
|
17
|
+
| **Edge Commerce** | `taghost_commerce_config`, `taghost_commerce_orders_list`, `taghost_commerce_order_fulfill`, `taghost_coupon_manage` | Configure store mode (companion vs standalone), payment gateways (Paystack/Stripe), track and fulfill orders, manage discount promo codes. |
|
|
18
|
+
| **CMS Collections** | `taghost_collection_create`, `taghost_collection_item_upsert`, `taghost_collection_item_publish` | Manage structured catalogs, seed product inventory, and publish directly to the live edge CDN (`/_tag/collections/...`). |
|
|
19
|
+
| **Live Edge Content** | `taghost_content_list`, `taghost_content_patch`, `taghost_canvas_patch_html` | Sub-millisecond (`<1ms`) live KV content patches on `data-tag` attributes, and surgical DOM modifications without redeploying. |
|
|
20
|
+
| **Forms & CRM** | `taghost_forms_get_submissions`, `taghost_crm_sequence_create`, `taghost_crm_enroll_lead`, `taghost_webhook_configure` | Inspect native HTML form submissions/leads, build automated email nurture sequences, enroll leads, and configure HMAC-signed webhooks. |
|
|
21
|
+
| **Serverless D1 SQL** | `taghost_sql_introspect_schema`, `taghost_sql_query` | Introspect SQLite/D1 schemas and run client-side verified read-only SQL queries (`SELECT`, `PRAGMA`, `EXPLAIN`). |
|
|
22
|
+
| **Tasks & TagWork** | `taghost_task_create`, `taghost_task_list`, `taghost_task_update`, `taghost_task_delete` | Create and schedule tasks, set priorities (`urgent`/`high`/`medium`/`low`), assign team members, and link tasks to email threads. |
|
|
23
|
+
| **Calendar & Scheduling** | `taghost_calendar_schedule_event`, `taghost_calendar_list_events`, `taghost_calendar_delete_event` | Schedule meetings, set calendar events, invite attendee emails, and manage appointment recurrence. |
|
|
24
|
+
| **TagMeet Rooms** | `taghost_meet_create_room` | Generate instant or scheduled virtual conference video rooms (`https://meet.taghost.io/room/...`) with recording & guest access. |
|
|
25
|
+
| **Shared Notes** | `taghost_note_create`, `taghost_note_list` | Create and inspect shared meeting agendas, project memos, and team notes. |
|
|
26
|
+
| **Observability & Eject** | `taghost_quota_check`, `taghost_ast_eject_preview` | Monitor plan quotas and storage, plus zero-lock-in AST dry-run previews with all platform attributes stripped. |
|
|
27
|
+
|
|
28
|
+
---
|
|
29
|
+
|
|
30
|
+
## Quickstart
|
|
31
|
+
|
|
32
|
+
### Option A: 1-Click Automated Setup (Recommended)
|
|
33
|
+
If you have `@taghost/cli` installed (`npm i -g @taghost/cli` or in your repo):
|
|
34
|
+
```bash
|
|
35
|
+
# Auto-configures .cursor/mcp.json and .cursor/rules/taghost.mdc in your project
|
|
36
|
+
tag mcp setup cursor
|
|
37
|
+
|
|
38
|
+
# Auto-injects into Claude Desktop config
|
|
39
|
+
tag mcp setup claude
|
|
40
|
+
|
|
41
|
+
# Auto-configures Google Antigravity (.antigravity/mcp.json & ~/.gemini/config/mcp_config.json)
|
|
42
|
+
tag mcp setup antigravity
|
|
43
|
+
|
|
44
|
+
# Auto-injects into Windsurf (~/.codeium/windsurf/mcp_config.json & .windsurfrules)
|
|
45
|
+
tag mcp setup windsurf
|
|
46
|
+
|
|
47
|
+
# Auto-injects into Zed Editor (~/.config/zed/settings.json under context_servers)
|
|
48
|
+
tag mcp setup zed
|
|
49
|
+
|
|
50
|
+
# Auto-configures VS Code native workspace MCP (.vscode/mcp.json)
|
|
51
|
+
tag mcp setup vscode
|
|
52
|
+
|
|
53
|
+
# Auto-injects into VS Code / Cline / Roo settings
|
|
54
|
+
tag mcp setup cline
|
|
55
|
+
|
|
56
|
+
# Auto-configures all detected agents and IDEs simultaneously
|
|
57
|
+
tag mcp setup all
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Option B: Google Antigravity First-Party Plugin
|
|
61
|
+
TagHost ships a full agent plugin bundle (manifest, skills, rules, and MCP configuration):
|
|
62
|
+
- **Workspace-level**: Automatically active when opening any repository containing `.agents/plugins/taghost`.
|
|
63
|
+
- **Global-level**: Automatically installed to `~/.gemini/config/plugins/taghost` via `tag mcp setup antigravity`.
|
|
64
|
+
- **Skills**: Features the `taghost-edge-cloud` skill for deploying, managing headless CMS, querying D1, and configuring edge commerce.
|
|
65
|
+
|
|
66
|
+
### Option C: VS Code, Cursor & Windsurf Extension
|
|
67
|
+
Install the official **TagHost Extension**:
|
|
68
|
+
1. Download `taghost-*.vsix` from the latest GitHub Release or search for `TagHost` in the Extensions view.
|
|
69
|
+
2. In VS Code / Cursor / Windsurf: `Cmd+Shift+P` → `Extensions: Install from VSIX...` → select `taghost-*.vsix`.
|
|
70
|
+
3. Click the TagHost icon in the Activity Bar to connect your account and deploy directly.
|
|
71
|
+
|
|
72
|
+
### Option D: Smithery.ai Registry
|
|
73
|
+
Install into Claude Desktop or Cursor in 1 click via [Smithery](https://smithery.ai):
|
|
74
|
+
```bash
|
|
75
|
+
npx -y @smithery/cli install @taghost/mcp --client claude
|
|
76
|
+
npx -y @smithery/cli install @taghost/mcp --client cursor
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
### Option E: Manual IDE Configuration
|
|
80
|
+
|
|
81
|
+
#### 1. Claude Desktop Setup
|
|
82
|
+
Add this block to your Claude Desktop config file:
|
|
83
|
+
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
84
|
+
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
|
|
85
|
+
|
|
86
|
+
```json
|
|
87
|
+
{
|
|
88
|
+
"mcpServers": {
|
|
89
|
+
"taghost": {
|
|
90
|
+
"command": "npx",
|
|
91
|
+
"args": ["-y", "@taghost/mcp"],
|
|
92
|
+
"env": {
|
|
93
|
+
"TAGHOST_API_TOKEN": "th_sec_your_token_here",
|
|
94
|
+
"TAGHOST_API_URL": "https://api.taghost.io"
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
#### 2. Cursor Setup
|
|
102
|
+
1. Open **Cursor Settings** (`Cmd + ,` or `Ctrl + ,`).
|
|
103
|
+
2. Navigate to **Features** → **MCP**.
|
|
104
|
+
3. Click **Add new MCP server**.
|
|
105
|
+
4. Set Name: `TagHost`
|
|
106
|
+
5. Type: `command`
|
|
107
|
+
6. Command: `tag mcp` (or `npx -y @taghost/mcp`)
|
|
108
|
+
|
|
109
|
+
#### 3. Google Antigravity Setup
|
|
110
|
+
Add to your project `.antigravity/mcp.json` or global `~/.gemini/config/mcp_config.json`:
|
|
111
|
+
```json
|
|
112
|
+
{
|
|
113
|
+
"mcpServers": {
|
|
114
|
+
"taghost": {
|
|
115
|
+
"command": "tag",
|
|
116
|
+
"args": ["mcp"],
|
|
117
|
+
"env": {
|
|
118
|
+
"TAGHOST_API_TOKEN": "th_sec_your_token_here",
|
|
119
|
+
"TAGHOST_API_URL": "https://api.taghost.io"
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
#### 4. Windsurf Setup
|
|
127
|
+
Add to `~/.codeium/windsurf/mcp_config.json`:
|
|
128
|
+
```json
|
|
129
|
+
{
|
|
130
|
+
"mcpServers": {
|
|
131
|
+
"taghost": {
|
|
132
|
+
"command": "tag",
|
|
133
|
+
"args": ["mcp"],
|
|
134
|
+
"env": {
|
|
135
|
+
"TAGHOST_API_TOKEN": "th_sec_your_token_here",
|
|
136
|
+
"TAGHOST_API_URL": "https://api.taghost.io"
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
#### 5. Zed Editor Setup
|
|
144
|
+
Add under `context_servers` in `~/.config/zed/settings.json` (or `%APPDATA%\Zed\settings.json`):
|
|
145
|
+
```json
|
|
146
|
+
{
|
|
147
|
+
"context_servers": {
|
|
148
|
+
"taghost": {
|
|
149
|
+
"command": {
|
|
150
|
+
"path": "tag",
|
|
151
|
+
"args": ["mcp"],
|
|
152
|
+
"env": {
|
|
153
|
+
"TAGHOST_API_TOKEN": "th_sec_your_token_here",
|
|
154
|
+
"TAGHOST_API_URL": "https://api.taghost.io"
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
#### 6. VS Code Native Setup
|
|
163
|
+
Add to `.vscode/mcp.json` in your workspace root:
|
|
164
|
+
```json
|
|
165
|
+
{
|
|
166
|
+
"servers": {
|
|
167
|
+
"taghost": {
|
|
168
|
+
"command": "tag",
|
|
169
|
+
"args": ["mcp"],
|
|
170
|
+
"env": {
|
|
171
|
+
"TAGHOST_API_TOKEN": "th_sec_your_token_here",
|
|
172
|
+
"TAGHOST_API_URL": "https://api.taghost.io"
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
}
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
#### 7. ChatGPT & OpenAI Codex (Custom GPT Actions)
|
|
180
|
+
Connect cloud agents directly without local terminal execution:
|
|
181
|
+
1. In the ChatGPT GPT Builder, go to **Configure** → **Actions** → **Import from URL**.
|
|
182
|
+
2. Enter: `https://api.taghost.io/openapi.json`
|
|
183
|
+
3. Under **Authentication**, select **API Key** (Auth Type: **Bearer**) and paste your `TAGHOST_API_TOKEN`.
|
|
184
|
+
4. Your Custom GPT now has access to TagHost's edge hosting, collections, and serverless D1 tools!
|
|
185
|
+
|
|
186
|
+
---
|
|
187
|
+
|
|
188
|
+
## Authentication
|
|
189
|
+
|
|
190
|
+
The MCP server checks for credentials in the following order:
|
|
191
|
+
1. `TAGHOST_API_TOKEN` environment variable
|
|
192
|
+
2. `TAGHOST_TOKEN` environment variable
|
|
193
|
+
3. Local CLI session in `~/.taghost/credentials.json` (created automatically via `tag login`)
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
197
|
+
## Non-Destructive Storefront Publishing
|
|
198
|
+
|
|
199
|
+
When an AI agent is requested to build an e-commerce storefront for an existing customer website, it uses `taghost_publish_files` with `storeMode: 'companion'`:
|
|
200
|
+
- Preserves the existing `index.html` and assets.
|
|
201
|
+
- Generates `/store.html` and `/products.html`.
|
|
202
|
+
- Injects a navigation link into the header.
|
|
203
|
+
- Carries forward all other deployed files without any risk of clobbering customer sites.
|