@g7aro/tanstack-mcp

MCP server that wraps the TanStack CLI to provide programmatic access to TanStack documentation, libraries, add-ons, ecosystem partners, and project scaffolding.

Built as a drop-in replacement after TanStack removed the built-in MCP server from @tanstack/cli.

Tools

| Tool | Description | |---|---| | listTanStackAddOns | List all available TanStack Start add-ons for a given framework | | getAddOnDetails | Get detailed info about a specific add-on (files, deps, options, routes) | | createTanStackApplication | Scaffold a new TanStack Start app with add-ons and options | | tanstack_list_libraries | List all TanStack libraries with descriptions and links | | tanstack_doc | Fetch the full content of a TanStack documentation page | | tanstack_search_docs | Search across TanStack documentation | | tanstack_ecosystem | List TanStack ecosystem partners with optional filters |

Quick Install

Auto-detect installed AI clients and register the MCP server in one command:

npx @g7aro/tanstack-mcp --install

This will detect and configure all supported clients on your machine.

Options

npx @g7aro/tanstack-mcp --install              # Interactive — pick which clients
npx @g7aro/tanstack-mcp --install --all         # Install into all detected clients
npx @g7aro/tanstack-mcp --install cursor codex   # Install into specific clients only
npx @g7aro/tanstack-mcp --uninstall              # Remove from all clients

Supported clients

| Client | Detection | Config method | |---|---|---| | Claude Code | claude CLI | claude mcp add | | Codex (OpenAI) | codex CLI | codex mcp add | | Cursor | ~/.cursor/ dir | ~/.cursor/mcp.json | | Windsurf | ~/.windsurf/ dir | ~/.windsurf/mcp.json | | Trae | ~/.trae/ dir | ~/.trae/mcp.json | | Antigravity | ~/.gemini/antigravity/ dir | mcp_config.json | | OpenCode | ~/.config/opencode/ dir | opencode.json | | Zed | ~/.config/zed/settings.json | settings.json | | VS Code (Copilot) | settings.json / code CLI | settings.json |

Manual Setup

If you prefer to configure manually, add to your client's MCP config:

{
  "mcpServers": {
    "tanstack": {
      "command": "npx",
      "args": ["-y", "@g7aro/tanstack-mcp"]
    }
  }
}

Tools

| Tool | Description | |---|---| | listTanStackAddOns | List all available TanStack Start add-ons for a given framework | | getAddOnDetails | Get detailed info about a specific add-on (files, deps, options, routes) | | createTanStackApplication | Scaffold a new TanStack Start app with add-ons and options | | tanstack_list_libraries | List all TanStack libraries with descriptions and links | | tanstack_doc | Fetch the full content of a TanStack documentation page | | tanstack_search_docs | Search across TanStack documentation | | tanstack_ecosystem | List TanStack ecosystem partners with optional filters |

Prerequisites

• Node.js >= 18
• npx available in PATH (ships with npm)

How it works

Each MCP tool maps to a @tanstack/cli command with --json output:

listTanStackAddOns       -> tanstack create --list-add-ons --framework <f> --json
getAddOnDetails          -> tanstack create --addon-details <id> --framework <f> --json
createTanStackApplication -> tanstack create <name> --framework <f> --add-ons <a,b> ...
tanstack_list_libraries  -> tanstack libraries --json
tanstack_doc             -> tanstack doc <library> <path> --json
tanstack_search_docs     -> tanstack search-docs "<query>" --json
tanstack_ecosystem       -> tanstack ecosystem --json

The server spawns npx @tanstack/cli for each invocation, parses the JSON output, and returns it through the MCP protocol over stdio.

Development

npm install
npm run build   # compile TypeScript -> dist/
npm start       # run the server (stdio)
npm run dev     # watch mode

License

MIT