Fastly NGWAF MCP Server

Instructions

Implementation Reference

• server.js:974-992 (handler)

  Primary handler for the 'create_site_rule' tool. Resolves corp/site context, validates siteName, constructs ruleData from input arguments, and delegates to the FastlyNGWAFClient's createSiteRule method.
  case 'create_site_rule': const { corpName: corpForSiteRule, siteName: siteForRule } = resolveContext(typedArgs); if (!siteForRule) { throw new Error('Site name is required. Please set context or provide siteName parameter.'); } const siteRuleData = { type: typedArgs.type, enabled: typedArgs.enabled, groupOperator: typedArgs.groupOperator, conditions: typedArgs.conditions, actions: typedArgs.actions, reason: typedArgs.reason, signal: typedArgs.signal, thresholdCount: typedArgs.thresholdCount, thresholdInterval: typedArgs.thresholdInterval, blockDurationSeconds: typedArgs.blockDurationSeconds, }; result = await client.createSiteRule(corpForSiteRule, siteForRule, siteRuleData); break;
• server.js:585-602 (schema)

  Input schema defining parameters and validation for the create_site_rule tool.
  inputSchema: { type: 'object', properties: { corpName: { type: 'string', description: 'Corporation name (uses context default if not provided)' }, siteName: { type: 'string', description: 'Site name (uses context default if not provided)' }, type: { type: 'string', enum: ['request', 'signal', 'rateLimit'], description: 'Rule type' }, enabled: { type: 'boolean', description: 'Whether rule is enabled' }, groupOperator: { type: 'string', enum: ['all', 'any'], description: 'Condition group operator' }, conditions: { type: 'array', description: 'Rule conditions' }, actions: { type: 'array', description: 'Rule actions' }, reason: { type: 'string', description: 'Description of the rule' }, signal: { type: 'string', description: 'Signal ID for exclusion/rate limit rules' }, thresholdCount: { type: 'number', description: 'Threshold count for rate limit rules' }, thresholdInterval: { type: 'number', description: 'Threshold interval for rate limit rules' }, blockDurationSeconds: { type: 'number', description: 'Block duration for rate limit rules' }, }, required: ['type', 'groupOperator', 'conditions', 'actions'], },
• server.js:122-124 (helper)

  Helper method in FastlyNGWAFClient class that performs the actual API call to create a site rule via POST to /corps/{corp}/sites/{site}/rules.
  async createSiteRule(corpName, siteName, ruleData) { const response = await this.api.post(`/corps/${corpName}/sites/${siteName}/rules`, ruleData); return response.data;
• server.js:814-816 (registration)

  Registration of all tools, including create_site_rule, via the ListToolsRequestSchema handler that returns the complete tools array.
  server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools }; });
• server.js:387-394 (helper)

  Helper function used by create_site_rule handler (and others) to resolve corpName and siteName from arguments or context.
  function resolveContext(args) { const corpName = args.corpName || context.defaultCorpName; const siteName = args.siteName || context.defaultSiteName; if (!corpName) { throw new Error('Corporation name is required. Please set context or provide corpName parameter.'); } return { corpName, siteName }; }