MCP-Typebot

Instructions

Implementation Reference

• src/tools/bots.ts:47-62 (handler)

  The core handler function that executes the listBots tool: authenticates the request, resolves the workspaceId from args or environment, queries the Typebot API for typebots in that workspace, and returns the response data.

  export async function listBots(args: ListBotsArgs = {}) {
    ensureAuth(); 
    const workspaceId =
      args.workspaceId || process.env.TYPEBOT_WORKSPACE_ID;
    if (!workspaceId) {
      throw new Error(
        'listBots: falta workspaceId (ni en args ni en process.env)'
      );
    }
  
    const response = await axios.get(
      'https://app.typebot.io/api/v1/typebots',
      { params: { workspaceId } }
    );
    return response.data;
  }

• src/tools/bots.ts:43-45 (schema)

  TypeScript interface defining the expected input arguments for the listBots handler function.

  export interface ListBotsArgs {
    workspaceId?: string;
  }

• src/index.ts:45-49 (registration)

  Tool registration entry in the toolsMap: associates the name 'listBots' with its handler function, description, and Zod input schema. This map is used in a loop to register each tool with the MCP server via server.registerTool.

  ['listBots', {
    func: listBots,
    description: 'Lista todos los Typebots de un workspace',
    schema: z.object({ workspaceId: z.string().optional() }),
  }],

• src/index.ts:48-48 (schema)

  Zod schema used for input validation of the listBots tool during MCP registration.

  schema: z.object({ workspaceId: z.string().optional() }),