feat(server): space bundle export/import — Genesis .tsk app kits (66 → 68)

.changeset/spec-refresh-bundle-tools.md

@@ -0,0 +1,5 @@
+---
+'@taskade/mcp-server': minor
+---
+
+Refresh the vendored v1 OpenAPI spec (14 months stale) and enable Genesis space-bundle tools: `bundleExport` (export a space as a SpaceBundleData v1 JSON bundle — agents, automations, projects, templates, apps) and `bundleImport` (install a bundle into a workspace) — 66 → 68 tools. The refreshed spec also updates several existing tool schemas from a year of API evolution (richer Date descriptions, new agent persona enums, nullable agent fields, pagination-cursor tweaks). Twelve malformed root-relative `$ref`s in the upstream-generated YAML were patched to absolute pointers so the spec dereferences cleanly. The raw ZIP/`.tsk` and media binary endpoints (`bundleExportZip`, `bundleImportZip`, `mediaUpload`, `mediaDownload`, `mediaDownloadAll`) are not enabled — they exchange raw binary payloads and need a handwritten wrapper.

README.md

@@ -13,7 +13,7 @@
 [![Add to Cursor](https://img.shields.io/badge/Add_to-Cursor-0098FF?style=flat-square)](cursor://anysphere.cursor-deeplink/mcp/install?name=taskade&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0YXNrYWRlL21jcC1zZXJ2ZXIiXSwiZW52Ijp7IlRBU0tBREVfQVBJX0tFWSI6InlvdXItYXBpLWtleS1oZXJlIn19)
 [![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-007ACC?style=flat-square&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22taskade%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40taskade%2Fmcp-server%22%5D%2C%22env%22%3A%7B%22TASKADE_API_KEY%22%3A%22%24%7Binput%3Ataskade_api_key%7D%22%7D%7D)
 
-**66 tools** for workspaces, projects, tasks, AI agents, agent chat, webhooks, knowledge bases, templates, media, and sharing — all from your AI client.
+**68 tools** for workspaces, projects, tasks, AI agents, agent chat, webhooks, knowledge bases, templates, media, space bundles, and sharing — all from your AI client.
 
 </div>
 
@@ -26,7 +26,7 @@
 
 - [Demo](#demo)
 - [Quick Start](#quick-start)
-- [Tools (66)](#tools-66)
+- [Tools (68)](#tools-68)
 - [Why Taskade MCP?](#why-taskade-mcp)
 - [Agent Recipes](#agent-recipes)
 - [Use Cases](#use-cases)
@@ -169,7 +169,7 @@ The server starts at `http://localhost:3000` (configure with `PORT` env var). Co
 
 ---
 
-## Tools (66)
+## Tools (68)
 
 ### Workspaces
 
@@ -259,6 +259,17 @@ Create, manage, and publish autonomous AI agents with custom knowledge and tools
 | `mediaGet` | Get media details |
 | `mediaDelete` | Delete a media file |
 
+### Space Bundles
+
+Export and import whole spaces as portable JSON bundles (SpaceBundleData v1 — the "Workspace DNA" format behind Genesis `.tsk` app kits). A bundle carries a space's agents, automations, projects, templates, and apps; media files are excluded from the JSON format.
+
+| Tool | Description |
+|------|-------------|
+| `bundleExport` | Export a space (subspace / app) as a JSON bundle — agents, automations, projects, templates, apps |
+| `bundleImport` | Import a JSON bundle into a workspace — validated against SpaceBundleData v1, all items installed into the target workspace |
+
+> **Note:** imports are subject to your plan's server-side limits — an over-quota import fails with a `4XX` error. The raw ZIP/`.tsk` and media file endpoints (`bundleExportZip`, `bundleImportZip`, `mediaUpload`, `mediaDownload`, `mediaDownloadAll`) exchange binary payloads and are not exposed as tools yet.
+
 ### Personal
 
 | Tool | Description |
@@ -299,7 +310,7 @@ Taskade MCP gives your AI assistant **access to your workspace** — projects, t
                          ↓
   ┌──────────────────────────────────┐
   │     Taskade MCP Server           │
-  │     (66 tools, 8 categories)     │
+  │     (68 tools, 9 categories)     │
   └──────────────────────────────────┘
        ↓              ↓            ↓
   folderCreateAgent  agentKnowledge  agentPublicAccess
@@ -326,7 +337,7 @@ Taskade MCP gives your AI assistant **access to your workspace** — projects, t
 
 ### Why Taskade MCP Over Other MCP Servers?
 
-Taskade is the only MCP server that includes **AI agent management** (create, train, deploy agents), **knowledge base training** (attach docs, projects, media), and **OpenAPI codegen** (generate MCP tools from any API spec). 66 tools across 8 categories.
+Taskade is the only MCP server that includes **AI agent management** (create, train, deploy agents), **knowledge base training** (attach docs, projects, media), and **OpenAPI codegen** (generate MCP tools from any API spec). 68 tools across 9 categories.
 
 ---
 

packages/server/README.md

@@ -1,6 +1,6 @@
 # Taskade MCP Server — Workspace MCP (`@taskade/mcp-server`)
 
-The **Workspace MCP** server connects any MCP-compatible AI client (Claude, Cursor, Claude Code, …) to your Taskade workspace, exposing **62 tools** to read and write your projects, tasks, agents, and custom fields.
+The **Workspace MCP** server connects any MCP-compatible AI client (Claude, Cursor, Claude Code, …) to your Taskade workspace, exposing tools to read and write your projects, tasks, agents, custom fields, and space bundles.
 
 > 📖 **Full documentation lives in the canonical sources — this package README is intentionally a stub to avoid drift.**
 

packages/server/server.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.taskade/mcp-server",
-  "description": "Connect Taskade to any AI assistant — 66 tools: projects, tasks, agents, agent chat, webhooks.",
+  "description": "Connect Taskade to any AI assistant — 68 tools: projects, tasks, agents, agent chat, webhooks.",
   "repository": {
     "url": "https://github.com/taskade/mcp.git",
     "source": "github"

packages/server/src/constants.ts

@@ -67,6 +67,10 @@ export const ENABLED_TASKADE_ACTIONS = [
   'mediaGet',
   'mediaDelete',
 
+  // Bundles
+  'bundleExport',
+  'bundleImport',
+
   // Me
   'meProjectsGet',
 ];
@@ -141,6 +145,10 @@ export const HUMANIZED_TASKADE_ACTIONS = {
   mediaGet: 'Get Media Details',
   mediaDelete: 'Delete Media',
 
+  // Bundles
+  bundleExport: 'Export Space Bundle',
+  bundleImport: 'Import Space Bundle',
+
   // Me
   meProjectsGet: 'Get My Projects',
 };