ReviewWebsite MCP Server

Instructions

Implementation Reference

• src/tools/reviewwebsite.tool.ts:629-663 (handler)

  MCP tool handler function that executes the 'seo_traffic' tool logic by calling the ReviewWebsite controller's getTraffic method and formatting the response.

  async function handleGetTraffic(args: SeoTrafficToolArgsType) {
  	const methodLogger = Logger.forContext(
  		'tools/reviewwebsite.tool.ts',
  		'handleGetTraffic',
  	);
  	methodLogger.debug(`Checking traffic:`, {
  		...args,
  		api_key: args.api_key ? '[REDACTED]' : undefined,
  	});
  
  	try {
  		const result = await reviewWebsiteController.getTraffic(
  			args.domainOrUrl,
  			{
  				mode: args.mode,
  				country: args.country,
  			},
  			{
  				api_key: args.api_key,
  			},
  		);
  
  		return {
  			content: [
  				{
  					type: 'text' as const,
  					text: result.content,
  				},
  			],
  		};
  	} catch (error) {
  		methodLogger.error(`Error checking traffic`, error);
  		return formatErrorForMcpTool(error);
  	}
  }

• src/tools/reviewwebsite.tool.ts:811-816 (registration)

  Registration of the 'seo_traffic' tool with the MCP server, specifying name, description, input schema, and handler function.

  server.tool(
  	'seo_traffic',
  	`Check traffic for a domain or URL using ReviewWeb.site API.`,
  	SeoTrafficToolArgs.shape,
  	handleGetTraffic,
  );

• src/tools/reviewwebsite.types.ts:381-389 (schema)

  Zod schema definition for the input arguments of the 'seo_traffic' tool.

  export const SeoTrafficToolArgs = z.object({
  	domainOrUrl: z.string().describe('The domain or URL to check traffic for'),
  	mode: z
  		.enum(['subdomains', 'exact'])
  		.optional()
  		.describe('Mode to use (default: subdomains)'),
  	country: z.string().optional().describe('Country code (default: None)'),
  	api_key: z.string().optional().describe('Your ReviewWebsite API key'),
  });