Semrush MCP Server

Instructions

Implementation Reference

• src/index.ts:312-321 (handler)

  The handler logic for 'related_keywords' tool: parses input arguments using the schema, calls Semrush API with 'phrase_related' report type and specific parameters/export_columns, and assigns the result to 'data' for further processing.
  case 'related_keywords': { const { phrase, database, limit } = RelatedKeywordsSchema.parse(args); data = await callSemrushAPI('phrase_related', { phrase, database, display_limit: limit, export_columns: 'Ph,Nq,Cp,Co,Nr,Td,Rr', }); break; }
• src/index.ts:96-100 (schema)

  Zod schema defining the input parameters for the 'related_keywords' tool: phrase (required string), database (optional string, default 'us'), limit (optional number, default 10).
  const RelatedKeywordsSchema = z.object({ phrase: z.string().describe('Seed keyword phrase'), database: z.string().default('us').describe('Database code'), limit: z.coerce.number().default(10).describe('Number of results'), });
• src/index.ts:228-236 (registration)

  Tool registration in the list of available tools: specifies name 'related_keywords', description, and inputSchema based on RelatedKeywordsSchema.
  { name: 'related_keywords', description: 'Get related keywords and suggestions for a seed keyword', inputSchema: { type: 'object', properties: RelatedKeywordsSchema.shape, required: ['phrase'], }, },