execute_browserql

Execute GraphQL queries for browser automation tasks like web scraping, content extraction, and performance audits using Browserless.io.

Instructions

Execute BrowserQL GraphQL queries

Input Schema

TableJSON Schema

Name	Required	Description	Default
`query`	Yes
`variables`	No

Implementation Reference

src/index.ts:490-509 (handler)

MCP CallToolRequest handler for 'execute_browserql' that validates arguments, calls BrowserlessClient.executeBrowserQL, and formats the response as MCP content.

case 'execute_browserql': {
  if (!args) throw new Error('Arguments are required');
  const result = await this.client!.executeBrowserQL(args as any);
  if (result.success && result.data) {
    return {
      content: [
        {
          type: 'text',
          text: 'BrowserQL query executed successfully.',
        },
        {
          type: 'text',
          text: JSON.stringify(result.data, null, 2),
        },
      ],
    };
  } else {
    throw new Error(result.error || 'Failed to execute BrowserQL query');
  }
}

src/client.ts:217-228 (helper)

BrowserlessClient method implementing the core logic: sends POST request to Browserless /chromium/bql endpoint with the BrowserQL query and variables.

async executeBrowserQL(request: BrowserQLRequest): Promise<BrowserlessResponse<BrowserQLResponse>> {
  try {
    const response: AxiosResponse<BrowserQLResponse> = await this.httpClient.post('/chromium/bql', request);

    return {
      success: true,
      data: response.data,
    };
  } catch (error) {
    return this.handleError(error);
  }
}

src/index.ts:206-217 (registration)

Tool registration in ListToolsRequestHandler, defining name, description, and input schema for execute_browserql.

{
  name: 'execute_browserql',
  description: 'Execute BrowserQL GraphQL queries',
  inputSchema: {
    type: 'object',
    properties: {
      query: { type: 'string' },
      variables: { type: 'object' },
    },
    required: ['query'],
  },
},

src/types.ts:226-231 (schema)

Zod schema and TypeScript type definition for BrowserQLRequest (input validation).

export const BrowserQLRequestSchema = z.object({
  query: z.string(),
  variables: z.record(z.any()).optional(),
});

export type BrowserQLRequest = z.infer<typeof BrowserQLRequestSchema>;

src/types.ts:305-308 (schema)
TypeScript interface for BrowserQLResponse (output type).
```
export interface BrowserQLResponse {
  data: any;
  errors?: any[];
}
```

Browserless MCP Server