get_stats_by_browser
Retrieve email statistics grouped by browser type to analyze email campaign performance across different web browsers and optimize email compatibility.
Instructions
Retrieve email statistics grouped by browser type
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| aggregated_by | No | How to group the statistics | day |
| browsers | No | Comma-separated list of browsers to filter by | |
| end_date | No | End date in YYYY-MM-DD format (defaults to today) | |
| start_date | Yes | Start date in YYYY-MM-DD format |
Implementation Reference
- src/tools/stats.ts:37-45 (handler)The core handler function that builds the SendGrid /v3/browsers/stats API URL based on input parameters and fetches the statistics data via makeRequest.handler: async ({ start_date, end_date, aggregated_by, browsers }: { start_date: string; end_date?: string; aggregated_by?: string; browsers?: string }): Promise<ToolResult> => { let url = `https://api.sendgrid.com/v3/browsers/stats?start_date=${start_date}`; if (end_date) url += `&end_date=${end_date}`; if (aggregated_by) url += `&aggregated_by=${aggregated_by}`; if (browsers) url += `&browsers=${encodeURIComponent(browsers)}`; const result = await makeRequest(url); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] }; },
- src/tools/stats.ts:30-35 (schema)Zod input schema defining parameters for the get_stats_by_browser tool: start_date (required), end_date, aggregated_by, browsers.inputSchema: { start_date: z.string().describe("Start date in YYYY-MM-DD format"), end_date: z.string().optional().describe("End date in YYYY-MM-DD format (defaults to today)"), aggregated_by: z.enum(["day", "week", "month"]).optional().default("day").describe("How to group the statistics"), browsers: z.string().optional().describe("Comma-separated list of browsers to filter by"), },
- src/tools/index.ts:9-17 (registration)Aggregates all tool sets including statsTools (which contains get_stats_by_browser) into allTools for top-level registration.export const allTools = { ...automationTools, ...campaignTools, ...contactTools, ...mailTools, ...miscTools, ...statsTools, ...templateTools, };
- src/index.ts:20-23 (registration)MCP server registration loop that registers every tool from allTools, including get_stats_by_browser, by name using its config and handler.// Register all tools for (const [name, tool] of Object.entries(allTools)) { server.registerTool(name, tool.config as any, tool.handler as any); }