Add tool-feedback survey page (#943)

Author: EricGustin

app/_components/tool-feedback-survey.tsx

@@ -0,0 +1,52 @@
+"use client";
+
+import posthog, { type Survey } from "posthog-js";
+import { useEffect, useState } from "react";
+import DynamicSurvey from "./dynamic-survey";
+
+const SURVEY_ID = "019db7ed-8745-0000-6627-84950f734a99";
+
+export const ToolFeedbackSurvey = () => {
+  const [surveyData, setSurveyData] = useState<Survey | null>(null);
+  const [completed, setCompleted] = useState(false);
+
+  useEffect(() => {
+    const unsubscribe = posthog.onFeatureFlags(() => {
+      posthog.getSurveys((surveys) => {
+        const survey = surveys.find((s) => s.id === SURVEY_ID);
+        if (survey) {
+          setSurveyData(survey);
+        }
+      }, true);
+    });
+    return unsubscribe;
+  }, []);
+
+  const handleSurveyComplete = () => {
+    setCompleted(true);
+  };
+
+  const handleSurveyBack = () => {
+    /* no-op */
+  };
+
+  return (
+    <>
+      <h2 className="mb-4 font-bold text-2xl" id="tool-feedback-survey-header">
+        Tool feedback survey
+      </h2>
+      {completed && (
+        <p className="mb-4 text-gray-500 text-sm">
+          Thank you! We will review your feedback soon.
+        </p>
+      )}
+      {!completed && (
+        <DynamicSurvey
+          onBack={handleSurveyBack}
+          onComplete={handleSurveyComplete}
+          surveyData={surveyData}
+        />
+      )}
+    </>
+  );
+};

app/en/resources/integrations/_meta.tsx

@@ -42,12 +42,12 @@ const meta: MetaRecord = {
   "customer-support": {
     title: "Customer Support",
   },
-  "-- Submit your Server": {
+  "-- Feedback": {
     type: "separator",
-    title: "Submit your server",
+    title: "Feedback",
   },
-  "contribute-a-server": {
-    title: "Contribute a Server",
+  "tool-feedback": {
+    title: "Tool Feedback",
   },
 };
 

app/en/resources/integrations/contribute-a-server/page.mdx

@@ -0,0 +1,17 @@
+---
+title: "Tool feedback"
+description: "Request missing tools, suggest features for existing tools, or report bugs in Arcade tools"
+---
+
+import { ToolFeedbackSurvey } from "@/app/_components/tool-feedback-survey";
+import { TakeSurvey } from "./take-survey";
+
+# Tool feedback
+
+Tell us what's missing or broken. Whether you need a tool Arcade doesn't yet support, want a new capability added to an existing tool, or have hit a bug, we want to hear about it.
+
+<TakeSurvey />
+
+Your input helps us prioritize what to build and fix next. Submit the form below and the Arcade team will follow up.
+
+<ToolFeedbackSurvey />

app/en/resources/integrations/tool-feedback/page.mdx

@@ -0,0 +1,16 @@
+"use client";
+
+import { Button } from "@arcadeai/design-system";
+
+export const TakeSurvey = () => (
+  <Button
+    className="my-6 inline-flex items-center justify-center rounded-md bg-primary px-4 font-medium text-primary-foreground text-sm hover:bg-primary/90"
+    onClick={() => {
+      document
+        .getElementById("tool-feedback-survey-header")
+        ?.scrollIntoView({ behavior: "smooth" });
+    }}
+  >
+    Take the survey
+  </Button>
+);

app/en/resources/integrations/tool-feedback/take-survey.tsx

@@ -292,6 +292,11 @@ const nextConfig: NextConfig = withLlmsTxt({
           destination: "/:locale/resources/registry-early-access",
           permanent: true,
         },
+        {
+          source: "/:locale/resources/integrations/contribute-a-server",
+          destination: "/:locale/resources/registry-early-access",
+          permanent: true,
+        },
         // Moved MCP Gateway UI guide to guides
         {
           source: "/:locale/guides/create-tools/mcp-gateways",

next.config.ts

@@ -1,4 +1,4 @@
-<!-- git-sha: 092a1d24ef247a2445c0a30324be1aee483db75f generation-date: 2026-04-07T19:44:18.457Z -->
+<!-- git-sha: 027403fb15a72f497ccba09bcf6f03e5766dbf3a generation-date: 2026-04-23T01:29:18.671Z -->
 
 # Arcade
 
@@ -110,7 +110,6 @@ Arcade delivers three core capabilities: Deploy agents even your security team w
 - [Handle Errors](https://docs.arcade.dev/en/guides/create-tools/error-handling): This documentation page teaches users how to implement effective error handling in their tools to enhance user experience and ensure resilience in production environments. It outlines strategies for managing various types of errors and promotes the use of smart retry behaviors. By following these guidelines, developers can
 - [Hosting Options Overview](https://docs.arcade.dev/en/guides/deployment-hosting): This documentation page provides an overview of the various hosting options available for the Arcade platform, including the Arcade Cloud service and on-premise deployments. Users can learn how to quickly set up and manage their Arcade environment, whether they prefer a cloud-based solution with
 - [How Hooks Work](https://docs.arcade.dev/en/guides/contextual-access/how-hooks-work): This documentation page provides a comprehensive overview of how to configure and utilize hook points within the Arcade platform, detailing the execution order, extensions, and handling of failures. Users will learn how to implement access, pre-execution, and post-execution hooks to
-- [How to contribute a MCP Server](https://docs.arcade.dev/en/resources/integrations/contribute-a-server): This documentation page provides a step-by-step guide for developers on how to contribute their MCP Server to the Arcade documentation, enhancing visibility and usability for other users. It outlines prerequisites, submission procedures through a pull request, and the review process to ensure successful integration
 - [In Custom Applications](https://docs.arcade.dev/en/guides/tool-calling/custom-apps): This documentation page provides guidance on integrating Arcade tools into custom applications, focusing on user authentication, authorization status checks, and retrieving tool definitions. It is designed to assist developers in creating their own tool-calling interfaces effectively.
 - [MCP Gateways](https://docs.arcade.dev/en/guides/mcp-gateways): The MCP Gateways documentation provides users with guidance on connecting multiple MCP servers to their agents, applications, or IDEs, enabling the federation of tools for streamlined management and access. It outlines the benefits of using MCP Gateways, including simplified configuration and customizable
 - [Migrate from toolkits to MCP servers](https://docs.arcade.dev/en/guides/create-tools/migrate-toolkits): This documentation page provides a comprehensive guide for users looking to migrate their existing Arcade toolkits to the new MCP Server framework. It outlines necessary changes in terminology, package updates, and detailed steps for updating dependencies, imports, and entrypoint files to ensure a
@@ -145,6 +144,7 @@ Arcade delivers three core capabilities: Deploy agents even your security team w
 - [Setup Arcade with OpenAI Agents SDK](https://docs.arcade.dev/en/get-started/agent-frameworks/openai-agents/setup-python): This documentation page guides users on how to set up and integrate Arcade tools within OpenAI Agents applications using the OpenAI Agents SDK. It covers the necessary prerequisites, provides step-by-step instructions for creating a CLI agent, and explains how to implement tool authorization
 - [The Arcade Registry](https://docs.arcade.dev/en/resources/registry-early-access): The Arcade Registry documentation provides an overview of a platform where developers can share and monetize their tools for agentic applications, similar to HuggingFace or Pypi. It explains how the registry integrates runtime metrics and user feedback to enhance tool development and usage
 - [Tool error handling](https://docs.arcade.dev/en/guides/tool-calling/error-handling): This documentation page provides guidance on effectively handling errors when using tools with Arcade's Tool Development Kit (TDK). It explains the error handling philosophy, outlines best practices, and offers code examples for managing output errors in various programming languages. Users will learn how
+- [Tool feedback](https://docs.arcade.dev/en/resources/integrations/tool-feedback): Documentation page
 - [Tools](https://docs.arcade.dev/en/resources/tools): This documentation page provides an overview of Arcade's ecosystem for AI tools, enabling users to explore a catalog of pre-built integrations, create custom tools, and contribute their own tools to the community. It outlines the benefits of using Arcade tools, such as built
 - [Types of Tools](https://docs.arcade.dev/en/guides/create-tools/improve/types-of-tools): This documentation page explains the two types of tools offered by Arcade: Optimized and Unoptimized tools. It highlights the differences in design and functionality, emphasizing that Optimized tools are tailored for AI-powered chat interfaces to enhance performance and reliability, while Unoptimized
 - [Understanding `Context` and tools](https://docs.arcade.dev/en/guides/create-tools/tool-basics/runtime-data-access): This documentation page explains the purpose and usage of the `Context` class in Arcade's Tool framework, which provides tools with access to runtime capabilities and tool-specific data. Users will learn how to utilize the `Context` object to retrieve OAuth tokens, secrets

public/llms.txt

@@ -483,12 +483,12 @@ const meta: MetaRecord = {
     },
   },
 ${categoryEntries},
-  "-- Submit your Server": {
+  "-- Feedback": {
     type: "separator",
-    title: "Submit your server",
+    title: "Feedback",
   },
-  "contribute-a-server": {
-    title: "Contribute a Server",
+  "tool-feedback": {
+    title: "Tool Feedback",
   },
 };
 
@@ -534,8 +534,7 @@ export function syncToolkitSidebar(options: SyncOptions = {}): SyncResult {
       ? readdirSync(CONFIG.integrationsDir, { withFileTypes: true })
           .filter((d) => d.isDirectory())
           .filter(
-            (d) =>
-              !["components", "contribute-a-server", "_lib"].includes(d.name)
+            (d) => !["components", "tool-feedback", "_lib"].includes(d.name)
           )
           .map((d) => d.name)
       : [];

toolkit-docs-generator/scripts/sync-toolkit-sidebar.ts

@@ -645,7 +645,7 @@ describe("generateMainMeta", () => {
     expect(result).toContain('title: "Productivity & Docs"');
     expect(result).toContain("social: {");
     expect(result).toContain('title: "Social & Communication"');
-    expect(result).toContain('"contribute-a-server"');
+    expect(result).toContain('"tool-feedback"');
     expect(result).not.toContain("preview:");
   });
 
@@ -681,7 +681,7 @@ describe("generateMainMeta", () => {
 
     expect(result).toContain("const meta: MetaRecord = {");
     expect(result).toContain("index:");
-    expect(result).toContain('"contribute-a-server"');
+    expect(result).toContain('"tool-feedback"');
   });
 
   it("does not mutate the input array", () => {
@@ -698,8 +698,8 @@ describe("generateMainMeta", () => {
 
     expect(result).toContain('"*":'); // Theme config
     expect(result).toContain("index:"); // Overview
-    expect(result).toContain('"-- Submit your Server"'); // Separator
-    expect(result).toContain('"contribute-a-server"'); // Contribute page
+    expect(result).toContain('"-- Feedback"'); // Separator
+    expect(result).toContain('"tool-feedback"'); // Feedback page
     expect(result).not.toContain("preview:"); // Preview page removed
   });
 });