@taghost/mcp 0.0.0-stage → 1.0.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/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,109 @@
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-injects into VS Code / Cline / Roo settings
42
+ tag mcp setup cline
43
+
44
+ # Auto-configures all detected agents
45
+ tag mcp setup all
46
+ ```
47
+
48
+ ### Option B: Smithery.ai Registry
49
+ Install into Claude Desktop or Cursor in 1 click via [Smithery](https://smithery.ai):
50
+ ```bash
51
+ npx -y @smithery/cli install @taghost/mcp --client claude
52
+ npx -y @smithery/cli install @taghost/mcp --client cursor
53
+ ```
54
+
55
+ ### Option C: Manual IDE Configuration
56
+
57
+ #### 1. Claude Desktop Setup
58
+ Add this block to your Claude Desktop config file:
59
+ - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
60
+ - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
61
+
62
+ ```json
63
+ {
64
+ "mcpServers": {
65
+ "taghost": {
66
+ "command": "npx",
67
+ "args": ["-y", "@taghost/mcp"],
68
+ "env": {
69
+ "TAGHOST_API_TOKEN": "th_sec_your_token_here",
70
+ "TAGHOST_API_URL": "https://api.taghost.io"
71
+ }
72
+ }
73
+ }
74
+ }
75
+ ```
76
+
77
+ #### 2. Cursor Setup
78
+ 1. Open **Cursor Settings** (`Cmd + ,` or `Ctrl + ,`).
79
+ 2. Navigate to **Features** → **MCP**.
80
+ 3. Click **Add new MCP server**.
81
+ 4. Set Name: `TagHost`
82
+ 5. Type: `command`
83
+ 6. Command: `tag mcp` (or `npx -y @taghost/mcp`)
84
+
85
+ #### 3. ChatGPT & OpenAI Codex (Custom GPT Actions)
86
+ Connect cloud agents directly without local terminal execution:
87
+ 1. In the ChatGPT GPT Builder, go to **Configure** → **Actions** → **Import from URL**.
88
+ 2. Enter: `https://api.taghost.io/openapi.json`
89
+ 3. Under **Authentication**, select **API Key** (Auth Type: **Bearer**) and paste your `TAGHOST_API_TOKEN`.
90
+ 4. Your Custom GPT now has access to TagHost's edge hosting, collections, and serverless D1 tools!
91
+
92
+ ---
93
+
94
+ ## Authentication
95
+
96
+ The MCP server checks for credentials in the following order:
97
+ 1. `TAGHOST_API_TOKEN` environment variable
98
+ 2. `TAGHOST_TOKEN` environment variable
99
+ 3. Local CLI session in `~/.taghost/credentials.json` (created automatically via `tag login`)
100
+
101
+ ---
102
+
103
+ ## Non-Destructive Storefront Publishing
104
+
105
+ 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'`:
106
+ - Preserves the existing `index.html` and assets.
107
+ - Generates `/store.html` and `/products.html`.
108
+ - Injects a navigation link into the header.
109
+ - 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
+ });