feat(cli): replace MCP server with CLI introspection

Author: tannerlinsley

.agents/index.md

@@ -55,7 +55,10 @@ node ../cli/packages/cli/dist/index.js create my-app
 | `tanstack add [add-ons]`        | Add to existing project   |
 | `tanstack add-on init/compile`  | Create custom add-on      |
 | `tanstack template init/compile` | Create custom template    |
-| `tanstack mcp [--sse]`          | Start MCP server          |
+| `tanstack libraries`            | List TanStack libraries   |
+| `tanstack doc`                  | Fetch a docs page         |
+| `tanstack search-docs`          | Search TanStack docs      |
+| `tanstack ecosystem`            | List ecosystem partners   |
 | `tanstack pin-versions`         | Pin TanStack packages     |
 
 ## Create Options
@@ -96,17 +99,14 @@ npx serve .add-on -l 9080
 node packages/cli/dist/index.js create test --add-ons http://localhost:9080/info.json
 ```
 
-## MCP Server Config
-
-```json
-{
-  "mcpServers": {
-    "tanstack": {
-      "command": "npx",
-      "args": ["@tanstack/cli", "mcp"]
-    }
-  }
-}
+## Agent Introspection Commands
+
+```bash
+npx @tanstack/cli create --list-add-ons --json
+npx @tanstack/cli create --addon-details drizzle --json
+npx @tanstack/cli libraries --json
+npx @tanstack/cli search-docs "server functions" --library start --json
+npx @tanstack/cli ecosystem --category database --json
 ```
 
 ## Key Files

.changeset/giant-ants-fold.md

@@ -0,0 +1,7 @@
+---
+'@tanstack/cli': minor
+---
+
+Remove the built-in MCP server from the CLI by dropping `tanstack mcp` and all MCP transport/tooling code.
+
+Add CLI-native agent introspection commands (`libraries`, `doc`, `search-docs`, `ecosystem`) and JSON output for `create --list-add-ons` / `create --addon-details` so AI agents can rely on CLI commands directly.

.github/workflows/release.yml

@@ -10,10 +10,13 @@ concurrency:
 
 env:
   NX_CLOUD_ACCESS_TOKEN: ${{ secrets.NX_CLOUD_ACCESS_TOKEN }}
+  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
 permissions:
   contents: write
   id-token: write
+  pull-requests: read
+  statuses: read
 
 jobs:
   release:

ARCHITECTURE.md

@@ -13,7 +13,7 @@
 
 | Package | Purpose |
 |---------|---------|
-| `@tanstack/cli` | Main CLI with commands: `create`, `add`, `add-on`, `starter`, `mcp` |
+| `@tanstack/cli` | Main CLI with commands: `create`, `add`, `add-on`, `starter`, `libraries`, `doc`, `search-docs`, `ecosystem` |
 | `@tanstack/create` | Core engine, frameworks, and add-ons |
 
 ## Framework Structure

README.md

@@ -31,7 +31,7 @@ npx @tanstack/cli create my-app
 - **TanStack Start** - Full-stack SSR framework (default)
 - **TanStack Router** - Type-safe routing (`--router-only` for SPA)
 - **Add-ons** - Auth, database, deployment, monitoring, and more
-- **MCP Server** - AI-assisted development
+- **CLI Introspection** - Agent-friendly discovery via JSON CLI output
 
 ## Quick Start
 
@@ -50,6 +50,11 @@ npx @tanstack/cli add clerk drizzle
 
 # List available add-ons
 npx @tanstack/cli create --list-add-ons
+
+# Agent-friendly introspection
+npx @tanstack/cli create --addon-details tanstack-query --json
+npx @tanstack/cli libraries --json
+npx @tanstack/cli search-docs "loaders" --library router --framework react --json
 ```
 
 ## Documentation

cli-aliases/create-start-app/README.md

@@ -94,25 +94,13 @@ This will get you a list of all available add-ons for Solid.
 pnpm dlx create-start-app@latest --list-add-ons --framework solid
 ```
 
-## MCP (Model Context Protocol) Support (experimental)
+## Agent Usage
 
-You can launch the `create-start-app` CLI with the `--mcp` flag to enable MCP support. Use this in your MCP enabled IDE to allow the Agent model to generate TanStack Start applications.
+The CLI no longer includes an MCP server. Use direct CLI introspection commands instead:
 
 ```bash
-pnpm dlx create-start-app@latest --mcp
-```
-
-Here is the JSON configuration for MCP support in many MCP clients.
-
-```json
-{
-  "mcpServers": {
-    "create-start-app": {
-      "command": "pnpm dlx",
-      "args": ["create-start-app@latest", "--mcp"]
-    }
-  }
-}
+pnpm dlx create-start-app@latest --list-add-ons
+pnpm dlx create-start-app@latest --addon-details tanstack-query
 ```
 
 # Contributing

cli-aliases/create-tanstack-app/README.md

@@ -134,25 +134,13 @@ pnpm dlx create-tanstack-app@latest --list-add-ons --framework solid --template
 
 Will get you a list of all available add-ons for Solid that are compatible with the File Router.
 
-## MCP (Model Context Protocol) Support (experimental)
+## Agent Usage
 
-You can launch the `create-tanstack-app` CLI with the `--mcp` flag to enable MCP support. Use this in your MCP enabled IDE to allow the Agent model to generate TanStack Router applications.
+The CLI no longer includes an MCP server. Use direct CLI introspection commands instead:
 
 ```bash
-pnpm dlx create-tanstack-app@latest --mcp
-```
-
-Here is the JSON configuration for MCP support in many MCP clients.
-
-```json
-{
-  "mcpServers": {
-    "create-tanstack-app": {
-      "command": "pnpm dlx",
-      "args": ["create-tanstack-app@latest", "--mcp"]
-    }
-  }
-}
+pnpm dlx create-tanstack-app@latest --list-add-ons
+pnpm dlx create-tanstack-app@latest --addon-details tanstack-query
 ```
 
 # Contributing

cli-aliases/create-tanstack/README.md

@@ -134,25 +134,13 @@ pnpm dlx create-tanstack@latest --list-add-ons --framework solid --template file
 
 Will get you a list of all available add-ons for Solid that are compatible with the File Router.
 
-## MCP (Model Context Protocol) Support (experimental)
+## Agent Usage
 
-You can launch the `create-tanstack` CLI with the `--mcp` flag to enable MCP support. Use this in your MCP enabled IDE to allow the Agent model to generate TanStack Router applications.
+The CLI no longer includes an MCP server. Use direct CLI introspection commands instead:
 
 ```bash
-pnpm dlx create-tanstack@latest --mcp
-```
-
-Here is the JSON configuration for MCP support in many MCP clients.
-
-```json
-{
-  "mcpServers": {
-    "create-tanstack": {
-      "command": "pnpm dlx",
-      "args": ["create-tanstack@latest", "--mcp"]
-    }
-  }
-}
+pnpm dlx create-tanstack@latest --list-add-ons
+pnpm dlx create-tanstack@latest --addon-details tanstack-query
 ```
 
 # Contributing

cli-aliases/create-tsrouter-app/README.md

@@ -134,25 +134,13 @@ pnpm dlx create-tsrouter-app@latest --list-add-ons --framework solid --template
 
 Will get you a list of all available add-ons for Solid that are compatible with the File Router.
 
-## MCP (Model Context Protocol) Support (experimental)
+## Agent Usage
 
-You can launch the `create-tsrouter-app` CLI with the `--mcp` flag to enable MCP support. Use this in your MCP enabled IDE to allow the Agent model to generate TanStack Router applications.
+The CLI no longer includes an MCP server. Use direct CLI introspection commands instead:
 
 ```bash
-pnpm dlx create-tsrouter-app@latest --mcp
-```
-
-Here is the JSON configuration for MCP support in many MCP clients.
-
-```json
-{
-  "mcpServers": {
-    "create-tsrouter-app": {
-      "command": "pnpm dlx",
-      "args": ["create-tsrouter-app@latest", "--mcp"]
-    }
-  }
-}
+pnpm dlx create-tsrouter-app@latest --list-add-ons
+pnpm dlx create-tsrouter-app@latest --addon-details tanstack-query
 ```
 
 # Contributing

cli-aliases/ts-create-start/README.md

@@ -94,25 +94,13 @@ This will get you a list of all available add-ons for Solid.
 pnpm create @tanstack/start@latest --list-add-ons --framework solid
 ```
 
-## MCP (Model Context Protocol) Support (experimental)
+## Agent Usage
 
-You can launch the `create-start-app` CLI with the `--mcp` flag to enable MCP support. Use this in your MCP enabled IDE to allow the Agent model to generate TanStack Start applications.
+The CLI no longer includes an MCP server. Use direct CLI introspection commands instead:
 
 ```bash
-pnpm create @tanstack/start@latest --mcp
-```
-
-Here is the JSON configuration for MCP support in many MCP clients.
-
-```json
-{
-  "mcpServers": {
-    "create-start-app": {
-      "command": "pnpm dlx",
-      "args": ["create-start-app@latest", "--mcp"]
-    }
-  }
-}
+pnpm create @tanstack/start@latest --list-add-ons
+pnpm create @tanstack/start@latest --addon-details tanstack-query
 ```
 
 # Contributing