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",