@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 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
- # Temporary Holding Version
1
+ # @taghost/mcp
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
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.
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env node
2
+
3
+ import { startServer } from '../dist/server.js';
4
+
5
+ startServer().catch((err) => {
6
+ console.error('Fatal error starting TagHost MCP Server:', err);
7
+ process.exit(1);
8
+ });