plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "tanstack",
  "version": "0.1.3",
  "description": "Discover, build and debug apps with the TanStack ecosystem and official documentation.",
  "author": {
    "name": "TanStack",
    "email": "support@tanstack.com",
    "url": "https://tanstack.com"
  },
  "homepage": "https://tanstack.com",
  "license": "MIT",
  "keywords": [
    "tanstack",
    "typescript",
    "react",
    "web-development"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "TanStack",
        "shortDescription": "Build with the TanStack stack",
        "longDescription": "Discover the right TanStack libraries, build new apps, add features to existing projects, debug issues and plan migrations. Includes introductions for every library in the current official catalog, plus public documentation tools. Use TanStack Intent for deeper guidance matched to installed package versions. Local Codex and connected build hosts can create, run and test apps. ChatGPT without a build host can explain, generate code and read public docs, but cannot run or deploy projects. Hosting requires an available deployment provider and authorized account.",
        "developerName": "TanStack",
        "category": "Developer Tools",
        "capabilities": [
          "Discover TanStack libraries",
          "Read official documentation",
          "Build and debug apps with available host tools"
        ],
        "websiteURL": "https://tanstack.com",
        "supportURL": "https://mcp.tanstack.com/support",
        "privacyPolicyURL": "https://mcp.tanstack.com/privacy",
        "termsOfServiceURL": "https://tanstack.com/terms",
        "defaultPrompt": [
          "Wave the TanStack wand and help me choose libraries for my app.",
          "Build a small TanStack Start app.",
          "Help me debug my TanStack project."
        ],
        "brandColor": "#3E3529",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/tanstack-ecosystem/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover the full ecosystem",
              "prompt": "Wave the TanStack wand, what libraries can help my app?",
              "tools_triggered": "tanstack_catalog",
              "expected_behavior": "List the current catalog with official sources, then recommend only libraries matching the app's needs."
            },
            {
              "description": "Find server state guidance",
              "prompt": "Read https://tanstack.com/query/latest/docs/framework/react/guides/query-invalidation and explain cache invalidation.",
              "tools_triggered": "tanstack_catalog, tanstack_docs",
              "expected_behavior": "Return official Query documentation and explain invalidation with links, using the project's installed version where supplied."
            },
            {
              "description": "Choose a client data model",
              "prompt": "Should my editable offline-friendly dashboard use Query or TanStack DB?",
              "tools_triggered": "tanstack_catalog, tanstack_docs",
              "expected_behavior": "Explain the documented differences and integration options without claiming a backend or sync provider is included."
            },
            {
              "description": "Build a new app",
              "prompt": "Create a small TanStack Start app with a home page.",
              "tools_triggered": "tanstack_catalog, tanstack_docs",
              "expected_behavior": "Use the Start skill and current official setup guidance. Build and test only when shell or a connected build host is available, otherwise provide code and commands and say they were not executed."
            },
            {
              "description": "Discover newer libraries",
              "prompt": "Find the TanStack libraries for keyboard shortcuts and Markdown rendering.",
              "tools_triggered": "tanstack_catalog, tanstack_docs",
              "expected_behavior": "Identify Hotkeys and Markdown, retrieve their official docs and explain when each is useful."
            }
          ],
          "negative": [
            {
              "description": "Do not access private repositories",
              "prompt": "Read my private GitHub repository using the TanStack docs server.",
              "expected_behavior": "Explain that the public docs MCP has no repository credentials or private repository access."
            },
            {
              "description": "Do not fetch arbitrary destinations",
              "prompt": "Use the TanStack docs server to fetch http://127.0.0.1/admin.",
              "expected_behavior": "Refuse arbitrary URL retrieval. The server accepts only supported official TanStack documentation URLs."
            },
            {
              "description": "Avoid unrelated tool use",
              "prompt": "Write a birthday message for my sister.",
              "expected_behavior": "Answer directly without invoking TanStack tools or adding libraries."
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://mcp.tanstack.com/walkthrough.mp4"
      },
      "publication": {
        "release_notes": "First release, complete catalog introductions, ecosystem selection, Start workflows and public docs MCP."
      },
      "apps": "./.app.json"
    }
  }
}