ig_business_discovery
Retrieve public profile information of any Instagram Business or Creator account by username. Access fields like biography, follower counts, and media count.
Instructions
Look up another Instagram Business/Creator account's public info by username.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| username | Yes | Instagram username to look up (without @) | |
| fields | No | Fields to retrieve (default: id,username,name,biography,followers_count,follows_count,media_count) |
Implementation Reference
- src/tools/instagram/profile.ts:46-65 (handler)The handler function for 'ig_business_discovery' tool. It accepts a username (required) and optional fields, then calls the Meta Graph API using the authenticated client to do a business_discovery lookup on the given Instagram username, returning the discovered account's public info.
// ─── ig_business_discovery ─────────────────────────────────── server.tool( "ig_business_discovery", "Look up another Instagram Business/Creator account's public info by username.", { username: z.string().describe("Instagram username to look up (without @)"), fields: z.string().optional().describe("Fields to retrieve (default: id,username,name,biography,followers_count,follows_count,media_count)"), }, async ({ username, fields }) => { try { const f = fields || "id,username,name,biography,followers_count,follows_count,media_count"; const { data, rateLimit } = await client.ig("GET", `/${client.igUserId}`, { fields: `business_discovery.fields(${f}){username=${username}}`, }); return { content: [{ type: "text", text: JSON.stringify({ ...data as object, _rateLimit: rateLimit }, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Business discovery failed: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } } ); - src/tools/instagram/profile.ts:50-53 (schema)Input schema for ig_business_discovery: 'username' (string, required) and 'fields' (string, optional) defined via Zod.
{ username: z.string().describe("Instagram username to look up (without @)"), fields: z.string().optional().describe("Fields to retrieve (default: id,username,name,biography,followers_count,follows_count,media_count)"), }, - src/tools/instagram/profile.ts:5-108 (registration)The function registerIgProfileTools registers multiple Instagram profile-related tools (including ig_business_discovery) on the MCP server via server.tool().
export function registerIgProfileTools(server: McpServer, client: MetaClient): void { // ─── ig_get_profile ────────────────────────────────────────── server.tool( "ig_get_profile", "Get Instagram Business/Creator account profile information.", {}, async () => { try { const { data, rateLimit } = await client.ig("GET", `/${client.igUserId}`, { fields: "id,name,username,biography,followers_count,follows_count,media_count,profile_picture_url,website", }); return { content: [{ type: "text", text: JSON.stringify({ ...data as object, _rateLimit: rateLimit }, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Get profile failed: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } } ); // ─── ig_get_account_insights ───────────────────────────────── server.tool( "ig_get_account_insights", "Get Instagram account insights. Note: 'impressions', 'email_contacts', 'phone_call_clicks', 'text_message_clicks', 'get_directions_clicks', 'website_clicks', 'profile_views' were deprecated in v22.0. Use 'views', 'reach', 'follower_count', 'reposts' instead.", { metric: z.string().describe("Comma-separated metrics: views,reach,follower_count,reposts,accounts_engaged,total_interactions"), period: z.enum(["day", "week", "days_28", "month", "lifetime"]).describe("Aggregation period"), since: z.string().optional().describe("Start date (Unix timestamp or ISO 8601)"), until: z.string().optional().describe("End date (Unix timestamp or ISO 8601)"), }, async ({ metric, period, since, until }) => { try { const params: Record<string, unknown> = { metric, period }; if (since) params.since = since; if (until) params.until = until; const { data, rateLimit } = await client.ig("GET", `/${client.igUserId}/insights`, params); return { content: [{ type: "text", text: JSON.stringify({ ...data as object, _rateLimit: rateLimit }, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Get account insights failed: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } } ); // ─── ig_business_discovery ─────────────────────────────────── server.tool( "ig_business_discovery", "Look up another Instagram Business/Creator account's public info by username.", { username: z.string().describe("Instagram username to look up (without @)"), fields: z.string().optional().describe("Fields to retrieve (default: id,username,name,biography,followers_count,follows_count,media_count)"), }, async ({ username, fields }) => { try { const f = fields || "id,username,name,biography,followers_count,follows_count,media_count"; const { data, rateLimit } = await client.ig("GET", `/${client.igUserId}`, { fields: `business_discovery.fields(${f}){username=${username}}`, }); return { content: [{ type: "text", text: JSON.stringify({ ...data as object, _rateLimit: rateLimit }, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Business discovery failed: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } } ); // ─── ig_get_collaboration_invites ──────────────────────────── server.tool( "ig_get_collaboration_invites", "Get pending collaboration invites for the Instagram account. Added in December 2025.", { limit: z.number().optional().describe("Number of results"), after: z.string().optional().describe("Pagination cursor"), }, async ({ limit, after }) => { try { const params: Record<string, unknown> = {}; if (limit) params.limit = limit; if (after) params.after = after; const { data, rateLimit } = await client.ig("GET", `/${client.igUserId}/collaboration_invites`, params); return { content: [{ type: "text", text: JSON.stringify({ ...data as object, _rateLimit: rateLimit }, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Get collaboration invites failed: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } } ); // ─── ig_respond_collaboration_invite ───────────────────────── server.tool( "ig_respond_collaboration_invite", "Accept or decline a collaboration invite. Added in December 2025.", { invite_id: z.string().describe("Collaboration invite ID"), action: z.enum(["accept", "decline"]).describe("Accept or decline the invite"), }, async ({ invite_id, action }) => { try { const { data, rateLimit } = await client.ig("POST", `/${client.igUserId}/collaboration_invites`, { invite_id, action, }); return { content: [{ type: "text", text: JSON.stringify({ ...data as object, _rateLimit: rateLimit }, null, 2) }] }; } catch (error) { return { content: [{ type: "text", text: `Respond to collaboration invite failed: ${error instanceof Error ? error.message : String(error)}` }], isError: true }; } } ); } - src/index.ts:15-15 (registration)Import of registerIgProfileTools from the profile module.
import { registerIgProfileTools } from "./tools/instagram/profile.js"; - src/index.ts:45-45 (registration)Actual registration call: registerIgProfileTools(server, client) wires up all Instagram profile tools including ig_business_discovery.
registerIgProfileTools(server, client);