HDW MCP Server

Instructions

Implementation Reference

• src/index.ts:308-333 (handler)

  Handler function that executes the get_instagram_user tool logic. Prepares request data with user and timeout, calls makeRequest to the Instagram user API endpoint, and returns the JSON response or an error message.

  async ({ user, timeout }) => {
    const requestData = { timeout, user };
    log("Starting Instagram user lookup for:", user);
    try {
      const response = await makeRequest(API_CONFIG.ENDPOINTS.INSTAGRAM_USER, requestData);
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(response, null, 2)
          }
        ]
      };
    } catch (error) {
      log("Instagram user lookup error:", error);
      return {
        content: [
          {
            type: "text",
            text: `Instagram user API error: ${formatError(error)}`
          }
        ],
        isError: true
      };
    }
  }

• src/index.ts:305-307 (schema)

  Zod input schema defining parameters: user (string, required), timeout (number, optional default 300). Used in tool registration.

    user: z.string().describe("User ID, alias or URL"),
    timeout: z.number().default(300).describe("Timeout in seconds")
  },

• src/index.ts:301-334 (registration)

  Registration of the get_instagram_user tool on the MCP server, specifying name, description, input schema, and handler function.

  server.tool(
    "get_instagram_user",
    "Get Instagram user information",
    {
      user: z.string().describe("User ID, alias or URL"),
      timeout: z.number().default(300).describe("Timeout in seconds")
    },
    async ({ user, timeout }) => {
      const requestData = { timeout, user };
      log("Starting Instagram user lookup for:", user);
      try {
        const response = await makeRequest(API_CONFIG.ENDPOINTS.INSTAGRAM_USER, requestData);
        return {
          content: [
            {
              type: "text",
              text: JSON.stringify(response, null, 2)
            }
          ]
        };
      } catch (error) {
        log("Instagram user lookup error:", error);
        return {
          content: [
            {
              type: "text",
              text: `Instagram user API error: ${formatError(error)}`
            }
          ],
          isError: true
        };
      }
    }
  );

• src/index.ts:100-145 (helper)

  Helper function makeRequest used by the handler to perform authenticated HTTPS POST requests to the AnySite.io API endpoints.

  const makeRequest = (endpoint: string, data: any, method: string = "POST"): Promise<any> => {
    return new Promise((resolve, reject) => {
      const url = new URL(endpoint, API_CONFIG.BASE_URL);
      const postData = JSON.stringify(data);
  
      const options = {
        hostname: url.hostname,
        port: url.port || 443,
        path: url.pathname,
        method: method,
        headers: {
          "Content-Type": "application/json",
          "Content-Length": Buffer.byteLength(postData),
          "access-token": API_KEY,
          ...(ACCOUNT_ID && { "x-account-id": ACCOUNT_ID })
        }
      };
  
      const req = https.request(options, (res) => {
        let responseData = "";
        res.on("data", (chunk) => {
          responseData += chunk;
        });
  
        res.on("end", () => {
          try {
            const parsed = JSON.parse(responseData);
            if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
              resolve(parsed);
            } else {
              reject(new Error(`API error ${res.statusCode}: ${JSON.stringify(parsed)}`));
            }
          } catch (e) {
            reject(new Error(`Failed to parse response: ${responseData}`));
          }
        });
      });
  
      req.on("error", (error) => {
        reject(error);
      });
  
      req.write(postData);
      req.end();
    });
  };

• src/index.ts:48-48 (helper)

  API endpoint path definition for Instagram user data in the API_CONFIG.ENDPOINTS object.

  INSTAGRAM_USER: "/api/instagram/user",