GoLogin MCP

Instructions

Implementation Reference

• src/index.ts:47-71 (registration)

  Dynamic registration of the tool 'delete_share_folder__id_' (generated from OpenAPI DELETE /share/folder/{id} path) in the ListTools handler, including name generation and schema.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => {
    const tools: Tool[] = [];
    if (this.apiSpec && this.apiSpec.paths) {
      for (const [path, pathItem] of Object.entries(this.apiSpec.paths)) {
        if (!pathItem) continue;
  
        for (const [method, operation] of Object.entries(pathItem)) {
          if (['get', 'post', 'put', 'delete', 'patch', 'head', 'options'].includes(method) && operation) {
            const op = operation as OpenAPIV3.OperationObject;
            const toolName = `${method}${path.replace('browser', 'profile').replace(/[^a-zA-Z0-9]/g, '_')}`;
  
            const inputSchema = this.buildInputSchema(op, path);
  
            tools.push({
              name: toolName,
              description: op.summary || op.description || `${method.toUpperCase()} ${path}`,
              inputSchema,
            });
          }
        }
      }
    }
  
    return { tools };
  });

• src/index.ts:468-489 (handler)

  Handler logic that matches the tool name 'delete_share_folder__id_' to the specific OpenAPI path and method (DELETE /share/folder/{id}), setting up the API call parameters.

  for (const [path, pathItem] of Object.entries(this.apiSpec.paths)) {
    if (!pathItem) continue;
  
    for (const [method, op] of Object.entries(pathItem)) {
      if (['get', 'post', 'put', 'delete', 'patch', 'head', 'options'].includes(method) && op) {
        const opObj = op as OpenAPIV3.OperationObject;
        const generatedToolName = `${method}${path.replace('browser', 'profile').replace(/[^a-zA-Z0-9]/g, '_')}`;
  
        if (generatedToolName === toolName) {
          targetPath = path;
          targetMethod = method.toUpperCase();
          operation = opObj;
          break;
        }
      }
    }
    if (operation) break;
  }
  
  
  if (!operation) {
    throw new Error(`Tool "${toolName}" not found`);

• src/index.ts:492-567 (handler)

  The HTTP request execution logic in callDynamicTool that performs the actual DELETE request to delete the share folder via GoLogin API, constructs URL with path param 'id', adds auth, and formats response.

  let url = `${this.baseUrl}${targetPath}`;
  const requestHeaders: Record<string, string> = { ...headers };
  let requestBody: string | undefined;
  
  requestHeaders['User-Agent'] = 'gologin-mcp';
  console.error('this.token', this.token);
  if (this.token) {
    requestHeaders['Authorization'] = `Bearer ${this.token}`;
  }
  
  if (parameters.path) {
    for (const [key, value] of Object.entries(parameters.path)) {
      url = url.replace(`{${key}}`, encodeURIComponent(value));
    }
  }
  
  const queryParams = new URLSearchParams();
  if (parameters.query) {
    for (const [key, value] of Object.entries(parameters.query)) {
      if (value) {
        queryParams.append(key, value);
      }
    }
  }
  
  if (queryParams.toString()) {
    url += `?${queryParams.toString()}`;
  }
  if (parameters.body && ['POST', 'PUT', 'PATCH', 'DELETE'].includes(targetMethod)) {
    requestHeaders['Content-Type'] = 'application/json';
    requestBody = JSON.stringify(parameters.body);
  }
  console.log('requestBody', requestBody);
  try {
    const fetchOptions: RequestInit = {
      method: targetMethod,
      headers: requestHeaders,
    };
    console.error('fetchOptions', fetchOptions);
    if (requestBody) {
      fetchOptions.body = requestBody;
    }
    const response = await fetch(url, fetchOptions);
  
    const responseHeaders: Record<string, string> = {};
    response.headers.forEach((value, key) => {
      responseHeaders[key] = value;
    });
  
    let responseBody: any;
    const contentType = response.headers.get('content-type') || '';
  
  
    if (contentType.includes('application/json')) {
      try {
        responseBody = await response.json();
      } catch {
        responseBody = await response.text();
      }
    } else {
      responseBody = await response.text();
    }
    return {
      content: [
        {
          type: 'text',
          text: `API Call Result:\n` +
            `URL: ${url}\n` +
            `Method: ${targetMethod}\n` +
            `Status: ${response.status} ${response.statusText}\n\n` +
            `Response Headers:\n${JSON.stringify(responseHeaders, null, 2)}\n\n` +
            `Response Body:\n${typeof responseBody === 'object' ? JSON.stringify(responseBody, null, 2) : responseBody}`,
        },
      ],
    };
  } catch (error) {

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

  Call to buildInputSchema which generates the input schema for the tool, including the required 'id' path parameter for delete_share_folder__id_.

  const inputSchema = this.buildInputSchema(op, path);