Fastly NGWAF MCP Server

Instructions

Implementation Reference

• server.js:908-914 (handler)

  Handler logic for the 'get_site' MCP tool: resolves corporation and site names from context or arguments, validates siteName, and delegates to the FastlyNGWAFClient.getSite method to fetch site details.

  case 'get_site':
      const { corpName: corpForSite, siteName: siteForGet } = resolveContext(typedArgs);
      if (!siteForGet) {
          throw new Error('Site name is required. Please set context or provide siteName parameter.');
      }
      result = await client.getSite(corpForSite, siteForGet);
      break;

• server.js:480-490 (schema)

  Input schema definition for the 'get_site' tool, specifying optional corpName and siteName parameters with descriptions.

  {
      name: 'get_site',
      description: 'Get details of a specific site',
      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)' },
          },
      },
  },

• server.js:79-82 (helper)

  Helper method in FastlyNGWAFClient class that performs the actual API GET request to retrieve site details from the Fastly NGWAF API.

  async getSite(corpName, siteName) {
      const response = await this.api.get(`/corps/${corpName}/sites/${siteName}`);
      return response.data;
  }

• server.js:387-394 (helper)

  Utility function used by 'get_site' handler to resolve corpName and siteName from tool arguments or global context, with validation.

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

• server.js:814-816 (registration)

  MCP server request handler for ListToolsRequestSchema that returns the full list of tools, including 'get_site', effectively registering it for discovery.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
      return { tools };
  });