YCloud WhatsApp API MCP Server

Instructions

Implementation Reference

• src/tools.ts:95-98 (registration)

  Remaps OpenAPI operation IDs containing 'template-delete-by-name-and-language' or 'whatsapp_template-delete-by-name-and-language' to the MCP tool name 'wa_template_delete'

  } else if (operationId.includes('template-delete-by-name-and-language') || 
            operationId.includes('whatsapp_template-delete-by-name-and-language')) {
    operationId = 'wa_template_delete';
  } else if (operationId.includes('template-edit-by-name-and-language') || 

• src/tools.ts:9-50 (schema)

  Extracts Zod input schema from OpenAPI operation parameters and requestBody for wa_template_delete and other tools

  function extractParamsSchema(operation: any): any {
    const properties: Record<string, any> = {};
    const required: string[] = [];
  
    // 处理路径参数
    if (operation.parameters) {
      operation.parameters.forEach((param: any) => {
        if (param.in === 'path' || param.in === 'query') {
          let schema;
          switch (param.schema?.type) {
            case 'string':
              schema = z.string();
              break;
            case 'integer':
              schema = z.number().int();
              break;
            case 'number':
              schema = z.number();
              break;
            case 'boolean':
              schema = z.boolean();
              break;
            default:
              schema = z.any();
          }
          
          properties[param.name] = schema;
          if (param.required) {
            required.push(param.name);
          }
        }
      });
    }
  
    // 处理请求体
    if (operation.requestBody) {
      properties['body'] = z.any();
      required.push('body');
    }
  
    return properties;
  }

• src/tools.ts:156-216 (handler)

  Generic handler function that registers the 'wa_template_delete' tool and proxies requests to the corresponding YCloud WhatsApp API endpoint for deleting templates by name and language

  server.tool(
    toolName,
    description,
    paramsSchema,
    async (args: Record<string, any>) => {
      try {
        // 解析URL中的路径参数
        let url = `${apiBaseUrl}${path}`;
        Object.keys(args).forEach(key => {
          if (path.includes(`{${key}}`)) {
            url = url.replace(`{${key}}`, encodeURIComponent(String(args[key])));
            delete args[key];
          }
        });
        
        // 提取请求体和查询参数
        const { body, ...queryParams } = args as Record<string, any>;
        
        // 设置请求选项
        const requestOptions: any = {
          url,
          method: method.toUpperCase(),
          headers: { 
            'Content-Type': 'application/json',
            ...headers
          },
          params: Object.keys(queryParams).length > 0 ? queryParams : undefined,
          data: body,
        };
        
        // 发送请求
        const response = await axios(requestOptions);
        return {
          content: [{ type: 'text' as const, text: JSON.stringify(response.data, null, 2) }]
        };
      } catch (error: unknown) {
        if (axios.isAxiosError(error) && error.response) {
          return {
            content: [{
              type: 'text' as const,
              text: JSON.stringify({
                error: true,
                status: error.response.status,
                message: error.response.data?.message || error.message,
                data: error.response.data
              }, null, 2)
            }]
          };
        }
        return {
          content: [{
            type: 'text' as const,
            text: JSON.stringify({
              error: true,
              message: error instanceof Error ? error.message : String(error)
            }, null, 2)
          }]
        };
      }
    }
  );