MCP Badge

@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