instagram-mcp

Instructions

Implementation Reference

• src/client.ts:553-563 (handler)

  The actual implementation of the getMentions method which makes the API request.

  async getMentions(limit = 25, accountId?: string): Promise<IGMention[]> {
    const id = accountId ?? this.aid();
    const data = await this.request("GET", `${id}/tags`, {
      params: {
        fields:
          "id,media_type,media_url,permalink,caption,timestamp,username",
        limit: String(Math.min(limit, 100)),
      },
    });
    return data.data ?? [];
  }

• src/index.ts:320-330 (registration)

  Tool registration for get_mentions defining its schema and description.

  {
    name: "get_mentions",
    description:
      "Get posts where your account has been tagged or @mentioned. Useful for tracking UGC.",
    inputSchema: {
      type: "object" as const,
      properties: {
        limit: { type: "integer", description: "Number of mentions (max 100)", minimum: 1, maximum: 100, default: 25 },
      },
    },
  },

• src/index.ts:458-461 (handler)

  The tool handler switch-case block that invokes getMentions.

  case "get_mentions": {
    const mentions = await c.getMentions(args.limit ?? 25);
    return JSON.stringify({ mentions, count: mentions.length }, null, 2);
  }