@opentweet/mcp-server 1.0.0

package/dist/tools/analytics.js

@@ -0,0 +1,100 @@
+import { z } from 'zod';
+export function registerAnalyticsTools(server, client) {
+    server.tool('opentweet_get_analytics', 'Get your posting analytics including stats, streaks, trends, category breakdown, and recent activity. Use type parameter to get specific analytics.', {
+        type: z.enum(['overview', 'tweets', 'best_times', 'growth']).optional()
+            .describe('Type of analytics: "overview" (default, posting stats + streaks + trends), "tweets" (per-tweet engagement, requires Advanced plan), "best_times" (optimal posting hours/days), "growth" (follower growth predictions)'),
+        period: z.string().optional().describe('Time period for tweet analytics (e.g. "7d", "30d", "90d"). Only for type="tweets".'),
+        sort_by: z.string().optional().describe('Sort tweet analytics by metric (e.g. "impressions", "engagement_rate"). Only for type="tweets".'),
+    }, async ({ type = 'overview', period, sort_by }) => {
+        try {
+            if (type === 'overview') {
+                const data = await client.getAnalyticsOverview();
+                const { stats: s, streaks: st, trends: t, categories } = data;
+                let text = `📊 Posting Analytics Overview\n\n`;
+                text += `Stats:\n`;
+                text += `  Posts created: ${s.total_posts_created}\n`;
+                text += `  Posts published: ${s.total_posts_published}\n`;
+                text += `  Posts scheduled: ${s.total_posts_scheduled}\n`;
+                text += `  Publishing rate: ${s.publishing_rate}%\n`;
+                text += `  Active days: ${s.total_active_days}\n`;
+                text += `  Avg posts/week: ${s.avg_posts_per_week}\n`;
+                text += `  Most active day: ${s.most_active_day}\n`;
+                text += `  Most active hour: ${s.most_active_hour}:00\n`;
+                text += `  Threads created: ${s.total_threads_created}\n`;
+                text += `  Media posts: ${s.total_media_posts}\n\n`;
+                text += `Streaks:\n`;
+                text += `  Current streak: ${st.current} days\n`;
+                text += `  Longest streak: ${st.longest} days\n`;
+                text += `  Last posted: ${st.last_posted_date || 'Never'}\n\n`;
+                text += `Trends:\n`;
+                text += `  This week: ${t.this_week} posts (last week: ${t.last_week})\n`;
+                text += `  This month: ${t.this_month} posts (last month: ${t.last_month})\n`;
+                if (t.best_month)
+                    text += `  Best month: ${t.best_month.month} (${t.best_month.count} posts)\n`;
+                text += `\nTop categories:\n`;
+                categories.slice(0, 5).forEach(c => {
+                    text += `  ${c.name}: ${c.count} posts (${c.percentage}%)\n`;
+                });
+                text += `\nLast 7 days activity: [${data.recent_activity.last_7_days.join(', ')}]`;
+                return { content: [{ type: 'text', text }] };
+            }
+            if (type === 'tweets') {
+                const data = await client.getTweetAnalytics({ period, sort_by });
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Tweet Engagement Analytics:\n\n${JSON.stringify(data, null, 2)}`,
+                        }],
+                };
+            }
+            if (type === 'best_times') {
+                const data = await client.getBestTimes();
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Best Posting Times:\n\n${JSON.stringify(data, null, 2)}`,
+                        }],
+                };
+            }
+            if (type === 'growth') {
+                const data = await client.getGrowthSummary();
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Growth Summary:\n\n${JSON.stringify(data, null, 2)}`,
+                        }],
+                };
+            }
+            return {
+                content: [{ type: 'text', text: 'Unknown analytics type.' }],
+                isError: true,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('opentweet_get_followers', 'Get follower growth data over time. Shows follower count snapshots and growth trends.', {
+        days: z.number().int().min(1).max(365).optional().describe('Number of days of history to retrieve (default 30, max 365)'),
+    }, async ({ days }) => {
+        try {
+            const data = await client.getFollowerGrowth({ days });
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Follower Growth (${days || 30} days):\n\n${JSON.stringify(data, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=analytics.js.map

package/dist/tools/analytics.js.map

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

package/dist/tools/media.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { OpenTweetClient } from '../api-client.js';
+export declare function registerMediaTools(server: McpServer, client: OpenTweetClient): void;
+//# sourceMappingURL=media.d.ts.map

package/dist/tools/media.d.ts.map

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

package/dist/tools/media.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { readFileSync } from 'fs';
+import { basename, extname } from 'path';
+const MIME_MAP = {
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.png': 'image/png',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.mp4': 'video/mp4',
+    '.mov': 'video/quicktime',
+};
+export function registerMediaTools(server, client) {
+    server.tool('opentweet_upload_media', 'Upload an image or video file to use in tweets. Returns a URL that can be passed to create_tweet or update_tweet in the media_urls field. Supported formats: JPG, PNG, GIF, WebP (max 5MB), MP4, MOV (max 20MB).', {
+        file_path: z.string().describe('Absolute path to the image or video file on disk'),
+    }, async ({ file_path }) => {
+        try {
+            const ext = extname(file_path).toLowerCase();
+            const mimeType = MIME_MAP[ext];
+            if (!mimeType) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: `Error: Unsupported file type "${ext}". Supported: ${Object.keys(MIME_MAP).join(', ')}`,
+                        }],
+                    isError: true,
+                };
+            }
+            const buffer = readFileSync(file_path);
+            const fileName = basename(file_path);
+            const result = await client.uploadMedia(buffer, fileName, mimeType);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Media uploaded successfully.\n\nURL: ${result.url}\n\nUse this URL in the media_urls field when creating or updating a tweet.`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=media.js.map

package/dist/tools/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../src/tools/media.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEzC,MAAM,QAAQ,GAA2B;IACvC,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,iBAAiB;CAC1B,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAuB;IAC3E,MAAM,CAAC,IAAI,CACT,wBAAwB,EACxB,kNAAkN,EAClN;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;KACnF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,iCAAiC,GAAG,iBAAiB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;yBAC9F,CAAC;oBACF,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;YACvC,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAEpE,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,wCAAwC,MAAM,CAAC,GAAG,6EAA6E;qBACtI,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAW,KAAe,CAAC,OAAO,EAAE,EAAE,CAAC;gBAChF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/posts.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { OpenTweetClient } from '../api-client.js';
+export declare function registerPostTools(server: McpServer, client: OpenTweetClient): void;
+//# sourceMappingURL=posts.d.ts.map

package/dist/tools/posts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posts.d.ts","sourceRoot":"","sources":["../../src/tools/posts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA8N3E"}

package/dist/tools/posts.js

@@ -0,0 +1,194 @@
+import { z } from 'zod';
+export function registerPostTools(server, client) {
+    server.tool('opentweet_create_tweet', 'Create a tweet. Can save as draft, schedule for a specific time, or publish immediately to X.', {
+        text: z.string().max(280).describe('Tweet text content (max 280 characters)'),
+        category: z.string().optional().describe('Category/topic tag (e.g. "Tech", "Marketing"). Defaults to "General"'),
+        scheduled_date: z.string().optional().describe('ISO 8601 date-time to schedule the tweet (e.g. "2026-03-15T09:00:00Z"). Omit to save as draft.'),
+        publish_now: z.boolean().optional().describe('Set to true to publish immediately to X instead of saving as draft'),
+        media_urls: z.array(z.string()).optional().describe('Array of media URLs (upload first with opentweet_upload_media)'),
+    }, async ({ text, category, scheduled_date, publish_now, media_urls }) => {
+        try {
+            const result = await client.createPost({
+                text,
+                category,
+                scheduled_date,
+                publish_now,
+                media_urls,
+            });
+            const post = result.posts[0];
+            const status = publish_now
+                ? `Published to X (x.com/i/status/${post.x_post_id})`
+                : scheduled_date
+                    ? `Scheduled for ${scheduled_date}`
+                    : 'Saved as draft';
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Tweet created successfully.\n\nStatus: ${status}\nID: ${post.id}\nText: ${post.text}\nCategory: ${post.category}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('opentweet_create_thread', 'Create a Twitter/X thread (multiple connected tweets posted as a chain).', {
+        tweets: z.array(z.string().max(280)).min(2).max(25).describe('Array of tweet texts in order (each max 280 chars, 2-25 tweets)'),
+        category: z.string().optional().describe('Category/topic tag'),
+        scheduled_date: z.string().optional().describe('ISO 8601 date-time to schedule. Omit to save as draft.'),
+        publish_now: z.boolean().optional().describe('Set to true to publish immediately'),
+    }, async ({ tweets, category, scheduled_date, publish_now }) => {
+        try {
+            const result = await client.createPost({
+                text: tweets[0],
+                is_thread: true,
+                thread_tweets: tweets.slice(1),
+                category,
+                scheduled_date,
+                publish_now,
+            });
+            const post = result.posts[0];
+            const status = publish_now
+                ? 'Published to X'
+                : scheduled_date
+                    ? `Scheduled for ${scheduled_date}`
+                    : 'Saved as draft';
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Thread created (${tweets.length} tweets).\n\nStatus: ${status}\nID: ${post.id}\nFirst tweet: ${tweets[0]}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('opentweet_list_tweets', 'List your tweets with optional filtering by status. Returns paginated results.', {
+        status: z.enum(['scheduled', 'posted', 'draft', 'failed']).optional().describe('Filter by status: "scheduled" (upcoming), "posted" (published), "draft" (unscheduled), "failed" (errors)'),
+        page: z.number().int().min(1).optional().describe('Page number (default 1)'),
+        limit: z.number().int().min(1).max(100).optional().describe('Results per page (default 20, max 100)'),
+    }, async ({ status, page, limit }) => {
+        try {
+            const result = await client.listPosts({ status, page, limit });
+            if (result.posts.length === 0) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: status
+                                ? `No ${status} tweets found.`
+                                : 'No tweets found.',
+                        }],
+                };
+            }
+            const lines = result.posts.map((p, i) => {
+                const num = ((result.pagination.page - 1) * result.pagination.limit) + i + 1;
+                const statusLabel = p.posted
+                    ? 'POSTED'
+                    : p.failed
+                        ? 'FAILED'
+                        : p.scheduled_date
+                            ? `SCHEDULED ${p.scheduled_date}`
+                            : 'DRAFT';
+                const preview = p.text.length > 100 ? p.text.slice(0, 100) + '...' : p.text;
+                return `${num}. [${statusLabel}] (${p.id})\n   ${preview}`;
+            });
+            const { pagination: pg } = result;
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Tweets (page ${pg.page}/${pg.pages}, ${pg.total} total):\n\n${lines.join('\n\n')}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('opentweet_get_tweet', 'Get full details of a specific tweet by its ID.', {
+        id: z.string().describe('The tweet/post ID'),
+    }, async ({ id }) => {
+        try {
+            const post = await client.getPost(id);
+            const statusLabel = post.posted
+                ? `Posted on ${post.posted_date}`
+                : post.failed
+                    ? `Failed: ${post.failed_reason}`
+                    : post.scheduled_date
+                        ? `Scheduled for ${post.scheduled_date}`
+                        : 'Draft';
+            let text = `Tweet Details:\n\nID: ${post.id}\nStatus: ${statusLabel}\nCategory: ${post.category}\nText: ${post.text}`;
+            if (post.is_thread && post.thread_tweets) {
+                text += `\n\nThread (${post.thread_tweets.length + 1} tweets):\n1. ${post.text}`;
+                post.thread_tweets.forEach((t, i) => {
+                    text += `\n${i + 2}. ${t}`;
+                });
+            }
+            if (post.x_post_id)
+                text += `\nX Post ID: ${post.x_post_id}`;
+            if (post.media_urls?.length)
+                text += `\nMedia: ${post.media_urls.join(', ')}`;
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('opentweet_update_tweet', 'Update an existing tweet. Can change text, category, schedule, or media. Cannot edit already-posted tweets.', {
+        id: z.string().describe('The tweet/post ID to update'),
+        text: z.string().max(280).optional().describe('New tweet text'),
+        category: z.string().optional().describe('New category'),
+        scheduled_date: z.string().nullable().optional().describe('New schedule date (ISO 8601), or null to unschedule'),
+        media_urls: z.array(z.string()).optional().describe('New media URLs (replaces existing)'),
+    }, async ({ id, text, category, scheduled_date, media_urls }) => {
+        try {
+            const updated = await client.updatePost(id, {
+                text,
+                category,
+                scheduled_date,
+                media_urls,
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Tweet updated.\n\nID: ${updated.id}\nText: ${updated.text}\nCategory: ${updated.category}\nScheduled: ${updated.scheduled_date || 'Not scheduled (draft)'}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('opentweet_delete_tweet', 'Permanently delete a tweet. This cannot be undone.', {
+        id: z.string().describe('The tweet/post ID to delete'),
+    }, async ({ id }) => {
+        try {
+            await client.deletePost(id);
+            return {
+                content: [{ type: 'text', text: `Tweet ${id} deleted successfully.` }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=posts.js.map

package/dist/tools/posts.js.map

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

package/dist/tools/scheduling.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { OpenTweetClient } from '../api-client.js';
+export declare function registerSchedulingTools(server: McpServer, client: OpenTweetClient): void;
+//# sourceMappingURL=scheduling.d.ts.map

package/dist/tools/scheduling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../../src/tools/scheduling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA6DjF"}

package/dist/tools/scheduling.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export function registerSchedulingTools(server, client) {
+    server.tool('opentweet_publish_tweet', 'Publish an existing draft or scheduled tweet immediately to X/Twitter. Requires an active subscription and X account connection.', {
+        id: z.string().describe('The tweet/post ID to publish now'),
+    }, async ({ id }) => {
+        try {
+            const result = await client.publishPost(id);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Tweet published to X!\n\nID: ${result.id}\nText: ${result.text}\nX Post ID: ${result.x_post_id}\nURL: https://x.com/i/status/${result.x_post_id}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('opentweet_batch_schedule', 'Schedule multiple tweets at once. Each tweet must already exist as a draft. Provide an array of post IDs with their scheduled dates.', {
+        schedules: z.array(z.object({
+            post_id: z.string().describe('The tweet/post ID'),
+            scheduled_date: z.string().describe('ISO 8601 date-time (e.g. "2026-03-15T09:00:00Z")'),
+        })).min(1).max(50).describe('Array of {post_id, scheduled_date} pairs (max 50)'),
+        community_id: z.string().optional().describe('Optional X Community ID to post to'),
+        share_with_followers: z.boolean().optional().describe('Share community posts with followers too'),
+    }, async ({ schedules, community_id, share_with_followers }) => {
+        try {
+            const result = await client.batchSchedule(schedules, community_id, share_with_followers);
+            let text = `${result.message}\n\nScheduled:`;
+            result.scheduled.forEach(p => {
+                text += `\n- ${p.id}: "${p.text.slice(0, 60)}${p.text.length > 60 ? '...' : ''}" → ${p.scheduled_date}`;
+            });
+            if (result.errors?.length) {
+                text += `\n\nErrors:`;
+                result.errors.forEach(e => {
+                    text += `\n- ${e.post_id}: ${e.error}`;
+                });
+            }
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=scheduling.js.map

package/dist/tools/scheduling.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,104 @@
+export interface OpenTweetConfig {
+    apiKey: string;
+    baseUrl: string;
+}
+export interface PaginatedResponse<T> {
+    posts: T[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        pages: number;
+    };
+}
+export interface Post {
+    id: string;
+    category: string;
+    text: string;
+    scheduled_date: string | null;
+    posted: boolean;
+    posted_date: string | null;
+    failed: boolean;
+    failed_reason?: string;
+    is_thread: boolean;
+    thread_tweets?: string[];
+    media_urls?: string[];
+    thread_media?: string[][];
+    community_id?: string;
+    share_with_followers?: boolean;
+    x_post_id?: string;
+    review_status?: string;
+    created_at: string;
+    updated_at?: string;
+}
+export interface AccountStatus {
+    authenticated: boolean;
+    subscription: {
+        has_access: boolean;
+        status: string;
+        is_trialing: boolean;
+        trial_ends_at: string | null;
+        current_period_ends_at: string | null;
+    };
+    limits: {
+        can_post: boolean;
+        posts_published_today: number;
+        remaining_posts_today: number;
+        daily_limit: number;
+    } | null;
+    stats: {
+        total_posts: number;
+        scheduled_posts: number;
+        posted_posts: number;
+        draft_posts: number;
+    };
+}
+export interface AnalyticsOverview {
+    stats: {
+        total_posts_created: number;
+        total_posts_published: number;
+        total_posts_scheduled: number;
+        publishing_rate: number;
+        total_active_days: number;
+        avg_posts_per_week: number;
+        most_active_day: string;
+        most_active_hour: number;
+        total_characters_written: number;
+        total_threads_created: number;
+        total_media_posts: number;
+    };
+    streaks: {
+        current: number;
+        longest: number;
+        last_posted_date: string | null;
+        streak_start_date: string | null;
+    };
+    trends: {
+        this_week: number;
+        last_week: number;
+        this_month: number;
+        last_month: number;
+        best_month: {
+            month: string;
+            count: number;
+        } | null;
+    };
+    categories: {
+        name: string;
+        count: number;
+        percentage: number;
+    }[];
+    recent_activity: {
+        last_7_days: number[];
+        last_30_days: number[];
+    };
+}
+export interface UploadResponse {
+    url: string;
+}
+export interface ApiError {
+    error: string;
+    details?: string | string[];
+    remaining?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@opentweet/mcp-server",
+  "version": "1.0.0",
+  "description": "OpenTweet MCP Server - Manage your Twitter/X presence from any AI assistant",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "opentweet-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "opentweet",
+    "twitter",
+    "x",
+    "tweet",
+    "scheduling",
+    "ai",
+    "claude",
+    "automation"
+  ],
+  "author": "OpenTweet <hello@opentweet.io>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/opentweetio/mcp-server"
+  },
+  "homepage": "https://opentweet.io/mcp",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}