Fastly NGWAF MCP Server

Instructions

Implementation Reference

• server.js:58-66 (handler)

  Core handler implementing the get_corp_overview tool logic. Fetches attack reports overview for a corporation from the Fastly NGWAF API, optionally filtered by date range.

  async getCorpOverview(corpName, from, until) {
      const params = new URLSearchParams();
      if (from)
          params.append('from', from);
      if (until)
          params.append('until', until);
      const response = await this.api.get(`/corps/${corpName}/reports/attacks?${params.toString()}`);
      return response.data;
  }

• server.js:458-465 (schema)

  Input schema definition for the get_corp_overview tool, defining parameters corpName, from, and until.

  inputSchema: {
      type: 'object',
      properties: {
          corpName: { type: 'string', description: 'Corporation name (uses context default if not provided)' },
          from: { type: 'string', description: 'Start date (e.g., "-7d")' },
          until: { type: 'string', description: 'End date (e.g., "-1d")' },
      },
  },

• server.js:456-466 (registration)

  Tool registration in the tools array returned by listTools handler.

      name: 'get_corp_overview',
      description: 'Get attack overview for a corporation',
      inputSchema: {
          type: 'object',
          properties: {
              corpName: { type: 'string', description: 'Corporation name (uses context default if not provided)' },
              from: { type: 'string', description: 'Start date (e.g., "-7d")' },
              until: { type: 'string', description: 'End date (e.g., "-1d")' },
          },
      },
  },

• server.js:900-903 (registration)

  MCP CallToolRequest handler case that invokes the get_corp_overview tool implementation using resolved context.

  case 'get_corp_overview':
      const { corpName: corpForOverview } = resolveContext(typedArgs);
      result = await client.getCorpOverview(corpForOverview, typedArgs.from, typedArgs.until);
      break;

• server.js:387-394 (helper)

  Helper function resolveContext used to determine corpName from args or context, required for get_corp_overview.

  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 };
  }