OSINT MCP Server

Implementation Reference

• src/index.ts:743-752 (registration)

  Registration of the instagram_user_lookup tool in the MCP server.

  server.tool(
    "instagram_user_lookup",
    { username: z.string().describe("Instagram username to lookup") },
    async ({ username }) => {
      const result = await scavengerClient.getInstagramProfile(username);
      return {
        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
      };
    }
  );

• src/tools/social-scavenger.ts:38-53 (handler)

  Implementation of the getInstagramProfile logic that performs the lookup.

  async getInstagramProfile(username: string): Promise<any> {
    try {
      const url = `https://www.instagram.com/${username}/`;
      const response = await fetch(url, {
        headers: { "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36" }
      });
      return {
        platform: "Instagram",
        username,
        url,
        status: response.status === 200 ? "Active" : "Not Found or Blocked"
      };
    } catch (e) {
      return { platform: "Instagram", username, error: true };
    }
  }