@exileum/meta-mcp 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yury Pikhtarev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,335 @@
+# meta-mcp
+
+[![npm version](https://img.shields.io/npm/v/@exileum/meta-mcp)](https://www.npmjs.com/package/@exileum/meta-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+MCP server for **Instagram Graph API** (v25.0), **Threads API**, and **Meta platform** management. Publish content, manage comments, view insights, and handle DMs — all through AI assistants.
+
+## Quick Start
+
+Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "meta": {
+      "command": "npx",
+      "args": ["-y", "@exileum/meta-mcp"],
+      "env": {
+        "INSTAGRAM_ACCESS_TOKEN": "your_ig_token",
+        "INSTAGRAM_USER_ID": "your_ig_user_id",
+        "THREADS_ACCESS_TOKEN": "your_threads_token",
+        "THREADS_USER_ID": "your_threads_user_id"
+      }
+    }
+  }
+}
+```
+
+Only set the variables for the platforms you use.
+
+### Manual Installation
+
+```bash
+git clone https://github.com/exileum/meta-mcp.git
+cd meta-mcp
+npm install
+npm run build
+```
+
+```json
+{
+  "mcpServers": {
+    "meta": {
+      "command": "node",
+      "args": ["/path/to/meta-mcp/dist/index.js"],
+      "env": {
+        "INSTAGRAM_ACCESS_TOKEN": "your_ig_token",
+        "INSTAGRAM_USER_ID": "your_ig_user_id",
+        "THREADS_ACCESS_TOKEN": "your_threads_token",
+        "THREADS_USER_ID": "your_threads_user_id"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `INSTAGRAM_ACCESS_TOKEN` | For Instagram | Instagram Graph API access token |
+| `INSTAGRAM_USER_ID` | For Instagram | Instagram Business/Creator account ID |
+| `THREADS_ACCESS_TOKEN` | For Threads | Threads API access token |
+| `THREADS_USER_ID` | For Threads | Threads user ID |
+| `META_APP_ID` | For token/webhook tools | Meta App ID |
+| `META_APP_SECRET` | For token/webhook tools | Meta App Secret |
+
+## Account Requirements
+
+| Platform | Account Type | Notes |
+|----------|-------------|-------|
+| **Instagram** | Business or Creator | Personal accounts cannot use the Graph API. Free to switch in settings |
+| **Threads** | Any account | Instagram link no longer required since Sep 2025 |
+| **Meta** (token/webhook) | Meta Developer App | Create at [developers.facebook.com](https://developers.facebook.com) |
+
+## Features
+
+- **57 tools** across Instagram (33), Threads (18), and Meta platform (6)
+- **Instagram**: Publish photos/videos/reels/stories/carousels with alt text, manage comments, view insights, search hashtags, handle DMs, manage collaboration invites
+- **Threads**: Publish text/images/videos/carousels with polls, GIFs, topic tags, link attachments, alt text, spoiler flags; manage replies; search posts; delete posts; view insights
+- **Meta**: Token exchange/refresh/debug, webhook management
+- **2 resources**: Instagram profile, Threads profile
+- **2 prompts**: Cross-platform content publishing, analytics report
+- Rate limit tracking via `x-app-usage` header
+
+## Tools
+
+### Meta Platform (6)
+
+| Tool | Description |
+|------|-------------|
+| `meta_exchange_token` | Exchange short-lived token for long-lived token (~60 days) |
+| `meta_refresh_token` | Refresh a long-lived token before expiration |
+| `meta_debug_token` | Inspect token validity, expiration, and scopes |
+| `meta_get_app_info` | Get Meta App information |
+| `meta_subscribe_webhook` | Subscribe to webhook notifications |
+| `meta_get_webhook_subscriptions` | List current webhook subscriptions |
+
+### Instagram — Publishing (6)
+
+| Tool | Description |
+|------|-------------|
+| `ig_publish_photo` | Publish a photo post (supports alt_text) |
+| `ig_publish_video` | Publish a video post |
+| `ig_publish_carousel` | Publish a carousel/album (2-10 items, supports alt_text per item) |
+| `ig_publish_reel` | Publish a Reel (supports alt_text) |
+| `ig_publish_story` | Publish a Story (24hr) |
+| `ig_get_container_status` | Check media container processing status |
+
+### Instagram — Media (5)
+
+| Tool | Description |
+|------|-------------|
+| `ig_get_media_list` | List published media |
+| `ig_get_media` | Get media details |
+| `ig_delete_media` | Delete a media post |
+| `ig_get_media_insights` | Get media analytics (views, reach, saved, shares) |
+| `ig_toggle_comments` | Enable/disable comments on a post |
+
+### Instagram — Comments (7)
+
+| Tool | Description |
+|------|-------------|
+| `ig_get_comments` | Get comments on a post |
+| `ig_get_comment` | Get comment details |
+| `ig_post_comment` | Post a comment |
+| `ig_get_replies` | Get replies to a comment |
+| `ig_reply_to_comment` | Reply to a comment |
+| `ig_hide_comment` | Hide/unhide a comment |
+| `ig_delete_comment` | Delete a comment |
+
+### Instagram — Profile & Insights (5)
+
+| Tool | Description |
+|------|-------------|
+| `ig_get_profile` | Get account profile info |
+| `ig_get_account_insights` | Get account-level analytics (views, reach, follower_count) |
+| `ig_business_discovery` | Look up another business account |
+| `ig_get_collaboration_invites` | Get pending collaboration invites |
+| `ig_respond_collaboration_invite` | Accept or decline collaboration invites |
+
+### Instagram — Hashtags (4)
+
+| Tool | Description |
+|------|-------------|
+| `ig_search_hashtag` | Search hashtag by name |
+| `ig_get_hashtag` | Get hashtag info |
+| `ig_get_hashtag_recent` | Get recent media for a hashtag |
+| `ig_get_hashtag_top` | Get top media for a hashtag |
+
+### Instagram — Mentions & Tags (2)
+
+| Tool | Description |
+|------|-------------|
+| `ig_get_mentioned_comments` | Get comments mentioning you |
+| `ig_get_tagged_media` | Get media you're tagged in |
+
+### Instagram — Messaging (4)
+
+| Tool | Description |
+|------|-------------|
+| `ig_get_conversations` | List DM conversations |
+| `ig_get_messages` | Get messages in a conversation |
+| `ig_send_message` | Send a DM |
+| `ig_get_message` | Get message details |
+
+### Threads — Publishing (7)
+
+| Tool | Description |
+|------|-------------|
+| `threads_publish_text` | Publish a text post (supports polls, GIFs, link attachments, topic tags, quote posts, spoiler flag) |
+| `threads_publish_image` | Publish an image post (supports alt_text, topic tags, spoiler flag) |
+| `threads_publish_video` | Publish a video post (supports alt_text, topic tags, spoiler flag) |
+| `threads_publish_carousel` | Publish a carousel (2-20 items, supports alt_text per item) |
+| `threads_delete_post` | Delete a post (max 100/day) |
+| `threads_get_container_status` | Check container processing status |
+| `threads_get_publishing_limit` | Check remaining publishing quota (250 posts/day) |
+
+### Threads — Media & Search (3)
+
+| Tool | Description |
+|------|-------------|
+| `threads_get_posts` | List published posts (includes topic_tag, poll, GIF fields) |
+| `threads_get_post` | Get post details |
+| `threads_search_posts` | Search public posts by keyword or topic tag |
+
+### Threads — Replies (4)
+
+| Tool | Description |
+|------|-------------|
+| `threads_get_replies` | Get replies to a post |
+| `threads_reply` | Reply to a post (supports image/video attachments) |
+| `threads_hide_reply` | Hide a reply |
+| `threads_unhide_reply` | Unhide a reply |
+
+### Threads — Profile (2)
+
+| Tool | Description |
+|------|-------------|
+| `threads_get_profile` | Get Threads profile info (includes is_verified) |
+| `threads_get_user_threads` | List user's threads |
+
+### Threads — Insights (2)
+
+| Tool | Description |
+|------|-------------|
+| `threads_get_post_insights` | Get post analytics (views, likes, replies, reposts, quotes, clicks) |
+| `threads_get_user_insights` | Get account-level analytics |
+
+## Resources
+
+| Resource URI | Description |
+|-------------|-------------|
+| `instagram://profile` | Instagram account profile data |
+| `threads://profile` | Threads account profile data (includes is_verified) |
+
+## Prompts
+
+| Prompt | Description |
+|--------|-------------|
+| `content_publish` | Cross-post content to Instagram and Threads |
+| `analytics_report` | Generate combined analytics report |
+
+## Setup Guide
+
+### Step 1: Create a Meta Developer App
+
+1. Go to [developers.facebook.com](https://developers.facebook.com) and log in
+2. Click **"My Apps"** -> **"Create App"**
+3. Select **"Other"** -> **"Business"** (or "None" for personal use)
+4. Enter an app name and create
+
+Your **`META_APP_ID`** and **`META_APP_SECRET`** are in **App Settings -> Basic**.
+
+### Step 2: Instagram Setup
+
+> Requires an **Instagram Business or Creator account**. Switch for free in Instagram app -> Settings -> Account type.
+
+1. In your Meta App, go to **"Add Products"** -> add **"Instagram Graph API"**
+2. Go to **"Instagram Graph API" -> "Settings"** and connect your Instagram Business account via a Facebook Page
+3. Open the [Graph API Explorer](https://developers.facebook.com/tools/explorer/)
+   - Select your app
+   - Add permissions: `instagram_basic`, `instagram_content_publish`, `instagram_manage_comments`, `instagram_manage_insights`, `instagram_manage_contents`, `pages_show_list`, `pages_read_engagement`
+   - Click **"Generate Access Token"** and authorize
+4. The generated token is short-lived (~1 hour). Exchange it for a long-lived token (~60 days):
+   ```
+   GET https://graph.facebook.com/v25.0/oauth/access_token
+     ?grant_type=fb_exchange_token
+     &client_id=YOUR_APP_ID
+     &client_secret=YOUR_APP_SECRET
+     &fb_exchange_token=SHORT_LIVED_TOKEN
+   ```
+   Or use the `meta_exchange_token` tool after setup.
+5. **Get your Instagram User ID**:
+   ```http
+   GET https://graph.facebook.com/v25.0/me/accounts?access_token=YOUR_TOKEN
+   ```
+   For each page, get the linked Instagram account:
+   ```http
+   GET https://graph.facebook.com/v25.0/{page-id}?fields=instagram_business_account&access_token=YOUR_TOKEN
+   ```
+   The `instagram_business_account.id` is your **`INSTAGRAM_USER_ID`**.
+
+### Step 3: Threads Setup
+
+> Works with **any Threads account**. Instagram link no longer required since Sep 2025.
+
+1. In your Meta App, go to **"Add Products"** -> add **"Threads API"**
+2. Go to **"Threads API" -> "Settings"**:
+   - Add your Threads account as a **Threads Tester** under "Roles"
+   - Accept the invitation in the Threads app: **Settings -> Account -> Website permissions -> Invites**
+3. Generate an authorization URL:
+   ```
+   https://threads.net/oauth/authorize
+     ?client_id=YOUR_APP_ID
+     &redirect_uri=YOUR_REDIRECT_URI
+     &scope=threads_basic,threads_content_publish,threads_manage_insights,threads_manage_replies,threads_read_replies
+     &response_type=code
+   ```
+   For local testing, use `https://localhost/` as redirect URI (configure in App Settings -> Threads API -> Redirect URIs).
+4. After authorization, exchange the code for an access token:
+   ```
+   POST https://graph.threads.net/oauth/access_token
+   Content-Type: application/x-www-form-urlencoded
+
+   client_id=YOUR_APP_ID
+   &client_secret=YOUR_APP_SECRET
+   &grant_type=authorization_code
+   &redirect_uri=YOUR_REDIRECT_URI
+   &code=AUTHORIZATION_CODE
+   ```
+5. Exchange for a long-lived token (~60 days):
+   ```
+   GET https://graph.threads.net/access_token
+     ?grant_type=th_exchange_token
+     &client_secret=YOUR_APP_SECRET
+     &access_token=SHORT_LIVED_TOKEN
+   ```
+6. **Get your Threads User ID**:
+   ```http
+   GET https://graph.threads.net/v1.0/me?fields=id,username&access_token=YOUR_TOKEN
+   ```
+   The `id` field is your **`THREADS_USER_ID`**.
+
+### Token Renewal
+
+Access tokens expire after ~60 days. Refresh before expiration:
+
+- **Instagram**: Use `meta_exchange_token` with the current valid token
+- **Threads**: Use `meta_refresh_token` or call:
+  ```
+  GET https://graph.threads.net/refresh_access_token
+    ?grant_type=th_refresh_token
+    &access_token=CURRENT_LONG_LIVED_TOKEN
+  ```
+
+Check token status anytime with `meta_debug_token`.
+
+## Deprecated Metrics (Graph API v22.0+)
+
+| Deprecated Metric | Replacement |
+|-------------------|-------------|
+| `impressions` | `views` |
+| `video_views` | `views` |
+| `plays` | `views` |
+| `clips_replays_count` | `views` |
+| `engagement` | `saves` + `shares` + `likes` + `comments` |
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+See [CHANGELOG.md](CHANGELOG.md) for release history.

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+export interface MetaConfig {
+    appId: string;
+    appSecret: string;
+    instagramAccessToken: string;
+    instagramUserId: string;
+    threadsAccessToken: string;
+    threadsUserId: string;
+}
+export declare function loadConfig(): MetaConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,UAAU,IAAI,UAAU,CASvC"}

package/dist/config.js

@@ -0,0 +1,11 @@
+export function loadConfig() {
+    return {
+        appId: process.env.META_APP_ID || "",
+        appSecret: process.env.META_APP_SECRET || "",
+        instagramAccessToken: process.env.INSTAGRAM_ACCESS_TOKEN || "",
+        instagramUserId: process.env.INSTAGRAM_USER_ID || "",
+        threadsAccessToken: process.env.THREADS_ACCESS_TOKEN || "",
+        threadsUserId: process.env.THREADS_USER_ID || "",
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE;QACpC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE;QAC5C,oBAAoB,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,EAAE;QAC9D,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE;QACpD,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE;QAC1D,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE;KACjD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createSandboxServer(): McpServer;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyEpE,wBAAgB,mBAAmB,cAkClC"}

package/dist/index.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { MetaClient } from "./services/meta-client.js";
+// Meta platform tools
+import { registerMetaAuthTools } from "./tools/meta/auth.js";
+// Instagram tools
+import { registerIgPublishingTools } from "./tools/instagram/publishing.js";
+import { registerIgMediaTools } from "./tools/instagram/media.js";
+import { registerIgCommentTools } from "./tools/instagram/comments.js";
+import { registerIgProfileTools } from "./tools/instagram/profile.js";
+import { registerIgHashtagTools } from "./tools/instagram/hashtags.js";
+import { registerIgMentionTools } from "./tools/instagram/mentions.js";
+import { registerIgMessagingTools } from "./tools/instagram/messaging.js";
+// Threads tools
+import { registerThreadsPublishingTools } from "./tools/threads/publishing.js";
+import { registerThreadsMediaTools } from "./tools/threads/media.js";
+import { registerThreadsReplyTools } from "./tools/threads/replies.js";
+import { registerThreadsProfileTools } from "./tools/threads/profile.js";
+import { registerThreadsInsightTools } from "./tools/threads/insights.js";
+// Resources & Prompts
+import { registerInstagramResources } from "./resources/instagram.js";
+import { registerThreadsResources } from "./resources/threads.js";
+import { registerPrompts } from "./prompts/index.js";
+const SERVER_VERSION = "3.0.0";
+const server = new McpServer({
+    name: "meta-mcp",
+    version: SERVER_VERSION,
+});
+const config = loadConfig();
+const client = new MetaClient(config);
+// Register tools
+registerMetaAuthTools(server, client);
+registerIgPublishingTools(server, client);
+registerIgMediaTools(server, client);
+registerIgCommentTools(server, client);
+registerIgProfileTools(server, client);
+registerIgHashtagTools(server, client);
+registerIgMentionTools(server, client);
+registerIgMessagingTools(server, client);
+registerThreadsPublishingTools(server, client);
+registerThreadsMediaTools(server, client);
+registerThreadsReplyTools(server, client);
+registerThreadsProfileTools(server, client);
+registerThreadsInsightTools(server, client);
+// Register resources
+registerInstagramResources(server, client);
+registerThreadsResources(server, client);
+// Register prompts
+registerPrompts(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+// ── Smithery Sandbox ──
+export function createSandboxServer() {
+    const sandbox = new McpServer({
+        name: "meta-mcp",
+        version: SERVER_VERSION,
+    });
+    const mockConfig = {
+        appId: "",
+        appSecret: "",
+        instagramAccessToken: "",
+        instagramUserId: "",
+        threadsAccessToken: "",
+        threadsUserId: "",
+    };
+    const mockClient = new MetaClient(mockConfig);
+    registerMetaAuthTools(sandbox, mockClient);
+    registerIgPublishingTools(sandbox, mockClient);
+    registerIgMediaTools(sandbox, mockClient);
+    registerIgCommentTools(sandbox, mockClient);
+    registerIgProfileTools(sandbox, mockClient);
+    registerIgHashtagTools(sandbox, mockClient);
+    registerIgMentionTools(sandbox, mockClient);
+    registerIgMessagingTools(sandbox, mockClient);
+    registerThreadsPublishingTools(sandbox, mockClient);
+    registerThreadsMediaTools(sandbox, mockClient);
+    registerThreadsReplyTools(sandbox, mockClient);
+    registerThreadsProfileTools(sandbox, mockClient);
+    registerThreadsInsightTools(sandbox, mockClient);
+    registerInstagramResources(sandbox, mockClient);
+    registerThreadsResources(sandbox, mockClient);
+    registerPrompts(sandbox);
+    return sandbox;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QAsEhD"}

package/dist/prompts/index.js

@@ -0,0 +1,61 @@
+export function registerPrompts(server) {
+    server.prompt("content_publish", "Cross-post content to Instagram and Threads simultaneously", {}, () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "Help me publish content across Instagram and Threads.",
+                        "",
+                        "Please follow these steps:",
+                        "1. Ask me what content I want to post (text, image URL, video URL)",
+                        "2. Use ig_publish_photo or ig_publish_video to post on Instagram",
+                        "3. Use threads_publish_text, threads_publish_image, or threads_publish_video to post on Threads",
+                        "4. Report back the permalink for each platform",
+                        "",
+                        "Tips:",
+                        "- Instagram captions can be up to 2200 characters",
+                        "- Threads posts are limited to 500 characters",
+                        "- Both platforms require publicly accessible HTTPS URLs for media",
+                        "- Video uploads may take time to process",
+                        "- You can add alt_text for accessibility on both platforms",
+                        "- On Threads, you can add a topic_tag, poll, or GIF attachment",
+                        "- On Threads, you can set reply_control (everyone, accounts_you_follow, mentioned_only, parent_post_author_only, followers_only)",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+    server.prompt("analytics_report", "Generate a combined analytics report for Instagram and Threads", {}, () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: [
+                        "Generate a comprehensive analytics report for my Instagram and Threads accounts.",
+                        "",
+                        "Please use the following tools:",
+                        "1. ig_get_profile — Get Instagram profile stats (followers, media count)",
+                        "2. ig_get_account_insights — Get Instagram insights for the last 7 days (metric: views,reach,follower_count, period: day)",
+                        "3. ig_get_media_list — Get recent 10 posts to analyze engagement",
+                        "4. threads_get_profile — Get Threads profile info",
+                        "5. threads_get_user_insights — Get Threads insights (metric: views,likes,replies,reposts,quotes,clicks)",
+                        "6. threads_get_posts — Get recent 10 Threads posts",
+                        "",
+                        "Then compile a report covering:",
+                        "- Follower count and growth trends",
+                        "- Top performing content on each platform",
+                        "- Engagement rate comparison (likes, comments, shares)",
+                        "- Recommendations for content strategy",
+                        "",
+                        "Note: 'impressions' and 'video_views' metrics were deprecated in Graph API v22.0.",
+                        "Use 'views' and 'reach' instead.",
+                    ].join("\n"),
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,MAAM,CACX,iBAAiB,EACjB,4DAA4D,EAC5D,EAAE,EACF,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;wBACJ,uDAAuD;wBACvD,EAAE;wBACF,4BAA4B;wBAC5B,oEAAoE;wBACpE,kEAAkE;wBAClE,iGAAiG;wBACjG,gDAAgD;wBAChD,EAAE;wBACF,OAAO;wBACP,mDAAmD;wBACnD,+CAA+C;wBAC/C,mEAAmE;wBACnE,0CAA0C;wBAC1C,4DAA4D;wBAC5D,gEAAgE;wBAChE,kIAAkI;qBACnI,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,kBAAkB,EAClB,gEAAgE,EAChE,EAAE,EACF,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;wBACJ,kFAAkF;wBAClF,EAAE;wBACF,iCAAiC;wBACjC,0EAA0E;wBAC1E,2HAA2H;wBAC3H,kEAAkE;wBAClE,mDAAmD;wBACnD,yGAAyG;wBACzG,oDAAoD;wBACpD,EAAE;wBACF,iCAAiC;wBACjC,oCAAoC;wBACpC,2CAA2C;wBAC3C,wDAAwD;wBACxD,wCAAwC;wBACxC,EAAE;wBACF,mFAAmF;wBACnF,kCAAkC;qBACnC,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/resources/instagram.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MetaClient } from "../services/meta-client.js";
+export declare function registerInstagramResources(server: McpServer, client: MetaClient): void;
+//# sourceMappingURL=instagram.d.ts.map

package/dist/resources/instagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram.d.ts","sourceRoot":"","sources":["../../src/resources/instagram.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,QAoB/E"}

package/dist/resources/instagram.js

@@ -0,0 +1,17 @@
+export function registerInstagramResources(server, client) {
+    server.resource("instagram-profile", "instagram://profile", { description: "Instagram Business/Creator account profile information", mimeType: "application/json" }, async () => {
+        const { data } = await client.ig("GET", `/${client.igUserId}`, {
+            fields: "id,name,username,biography,followers_count,follows_count,media_count,profile_picture_url,website",
+        });
+        return {
+            contents: [
+                {
+                    uri: "instagram://profile",
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=instagram.js.map

package/dist/resources/instagram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instagram.js","sourceRoot":"","sources":["../../src/resources/instagram.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,0BAA0B,CAAC,MAAiB,EAAE,MAAkB;IAC9E,MAAM,CAAC,QAAQ,CACb,mBAAmB,EACnB,qBAAqB,EACrB,EAAE,WAAW,EAAE,wDAAwD,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EACvG,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE;YAC7D,MAAM,EAAE,kGAAkG;SAC3G,CAAC,CAAC;QACH,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,qBAAqB;oBAC1B,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/resources/threads.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MetaClient } from "../services/meta-client.js";
+export declare function registerThreadsResources(server: McpServer, client: MetaClient): void;
+//# sourceMappingURL=threads.d.ts.map

package/dist/resources/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../../src/resources/threads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,QAoB7E"}

package/dist/resources/threads.js

@@ -0,0 +1,17 @@
+export function registerThreadsResources(server, client) {
+    server.resource("threads-profile", "threads://profile", { description: "Threads user profile information", mimeType: "application/json" }, async () => {
+        const { data } = await client.threads("GET", `/${client.threadsUserId}`, {
+            fields: "id,username,name,threads_profile_picture_url,threads_biography,is_verified",
+        });
+        return {
+            contents: [
+                {
+                    uri: "threads://profile",
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=threads.js.map

package/dist/resources/threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../../src/resources/threads.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,MAAkB;IAC5E,MAAM,CAAC,QAAQ,CACb,iBAAiB,EACjB,mBAAmB,EACnB,EAAE,WAAW,EAAE,kCAAkC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,EACjF,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,aAAa,EAAE,EAAE;YACvE,MAAM,EAAE,4EAA4E;SACrF,CAAC,CAAC;QACH,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,mBAAmB;oBACxB,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}