SODAX Builders MCP

Instructions

Implementation Reference

• src/tools/gitbookProxy.ts:211-245 (handler)

  Complete implementation of docs_list_tools handler - fetches GitBook tools and formats them with full parameter details

  server.tool(
    "docs_list_tools",
    "List all SDK documentation tools with parameters. Essential for discovering what's available.",
    {},
    DOCS_READ_ONLY,
    async () => {
      const tools = await fetchGitBookTools();
      if (tools.length === 0) {
        return {
          content: [{
            type: "text",
            text: `⚠️ No SDK documentation tools available.\n\n**Troubleshooting:**\n1. Run \`docs_refresh\` to reconnect\n2. Check \`docs_health\` for status\n3. The GitBook MCP at docs.sodax.com may be temporarily down\n\n**Alternative:** SODAX API tools (sodax_*) work independently.`
          }]
        };
      }
      
      const toolList = tools.map(t => {
        const params = t.inputSchema.properties 
          ? Object.entries(t.inputSchema.properties).map(([k, v]) => {
              const prop = v as { type?: string; description?: string };
              const required = t.inputSchema.required?.includes(k) ? " (required)" : "";
              return `  - \`${k}\`: ${prop.type || "any"}${required}${prop.description ? ` — ${prop.description}` : ""}`;
            }).join("\n")
          : "  (no parameters)";
        return `### \`docs_${t.name}\`\n${t.description}\n\n**Parameters:**\n${params}`;
      }).join("\n\n---\n\n");
      
      return {
        content: [{
          type: "text",
          text: `# SDK Documentation Tools\n\n${tools.length} tools from docs.sodax.com:\n\n---\n\n${toolList}`
        }]
      };
    }
  );

• src/tools/gitbookProxy.ts:214-214 (schema)

  Input schema for docs_list_tools - empty object indicates no parameters required

  {},

• src/tools/gitbookProxy.ts:211-245 (registration)

  Registration of docs_list_tools tool via server.tool() with name, description, schema, and handler

  server.tool(
    "docs_list_tools",
    "List all SDK documentation tools with parameters. Essential for discovering what's available.",
    {},
    DOCS_READ_ONLY,
    async () => {
      const tools = await fetchGitBookTools();
      if (tools.length === 0) {
        return {
          content: [{
            type: "text",
            text: `⚠️ No SDK documentation tools available.\n\n**Troubleshooting:**\n1. Run \`docs_refresh\` to reconnect\n2. Check \`docs_health\` for status\n3. The GitBook MCP at docs.sodax.com may be temporarily down\n\n**Alternative:** SODAX API tools (sodax_*) work independently.`
          }]
        };
      }
      
      const toolList = tools.map(t => {
        const params = t.inputSchema.properties 
          ? Object.entries(t.inputSchema.properties).map(([k, v]) => {
              const prop = v as { type?: string; description?: string };
              const required = t.inputSchema.required?.includes(k) ? " (required)" : "";
              return `  - \`${k}\`: ${prop.type || "any"}${required}${prop.description ? ` — ${prop.description}` : ""}`;
            }).join("\n")
          : "  (no parameters)";
        return `### \`docs_${t.name}\`\n${t.description}\n\n**Parameters:**\n${params}`;
      }).join("\n\n---\n\n");
      
      return {
        content: [{
          type: "text",
          text: `# SDK Documentation Tools\n\n${tools.length} tools from docs.sodax.com:\n\n---\n\n${toolList}`
        }]
      };
    }
  );

• src/tools/gitbookProxy.ts:251-259 (helper)

  Helper function that returns list of available GitBook tool names including docs_list_tools

  export async function getGitBookToolNames(): Promise<string[]> {
    try {
      const tools = await fetchGitBookTools();
      const proxyTools = tools.map(t => `docs_${t.name}`);
      return [...proxyTools, "docs_health", "docs_refresh", "docs_list_tools"];
    } catch {
      return ["docs_health", "docs_refresh", "docs_list_tools"];
    }
  }

• src/services/analytics.ts:43-43 (helper)

  Analytics mapping for docs_list_tools to the 'sdk-docs' tracking group

  docs_list_tools: "sdk-docs",