@opentweet/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,99 @@
+# @opentweet/mcp-server
+
+MCP server for [OpenTweet](https://opentweet.io) — manage your Twitter/X presence from Claude, Cursor, or any AI assistant.
+
+## Quick Start
+
+### 1. Get an API Key
+
+Sign up at [opentweet.io](https://opentweet.io) and create an API key from the [Developer Dashboard](https://opentweet.io/developer).
+
+### 2. Configure Your AI Client
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "opentweet": {
+      "command": "npx",
+      "args": ["-y", "@opentweet/mcp-server"],
+      "env": {
+        "OPENTWEET_API_KEY": "ot_your_key_here"
+      }
+    }
+  }
+}
+```
+
+For **Claude Code**:
+```bash
+claude mcp add opentweet -- npx -y @opentweet/mcp-server
+```
+
+### 3. Start Using
+
+Ask your AI assistant:
+- "Schedule a tweet about React performance for tomorrow at 9am"
+- "Show me my posting streak and analytics"
+- "Create a 5-tweet thread about TypeScript tips"
+- "What are my best posting times?"
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `opentweet_create_tweet` | Create a tweet (draft, scheduled, or publish now) |
+| `opentweet_create_thread` | Create a multi-tweet thread (2-25 tweets) |
+| `opentweet_list_tweets` | List tweets with status filters and pagination |
+| `opentweet_get_tweet` | Get full details of a specific tweet |
+| `opentweet_update_tweet` | Edit tweet text, category, schedule, or media |
+| `opentweet_delete_tweet` | Delete a tweet |
+| `opentweet_publish_tweet` | Publish a draft/scheduled tweet immediately to X |
+| `opentweet_batch_schedule` | Schedule up to 50 tweets at once |
+| `opentweet_get_analytics` | Get posting stats, streaks, trends, engagement |
+| `opentweet_get_followers` | Get follower growth data over time |
+| `opentweet_get_account` | Get account status, subscription, and limits |
+| `opentweet_upload_media` | Upload images/videos for use in tweets |
+
+## Resources
+
+| URI | Description |
+|-----|-------------|
+| `opentweet://account` | Account status and limits |
+| `opentweet://posts/scheduled` | Currently scheduled tweets |
+| `opentweet://posts/drafts` | Draft tweets |
+| `opentweet://analytics/summary` | Analytics overview |
+
+## Prompts
+
+| Name | Description |
+|------|-------------|
+| `weekly_content_plan` | Generate a week of tweet content |
+| `review_and_schedule_drafts` | Review drafts and suggest scheduling |
+| `content_from_url` | Generate tweets from a URL or topic |
+| `performance_review` | Analyze performance and get suggestions |
+
+## Requirements
+
+- Node.js 18+
+- OpenTweet account with API key ([get one here](https://opentweet.io/developer))
+- Connected X/Twitter account in OpenTweet
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `OPENTWEET_API_KEY` | Yes | Your OpenTweet API key (starts with `ot_`) |
+| `OPENTWEET_BASE_URL` | No | API base URL (default: `https://opentweet.io`) |
+
+## Links
+
+- [OpenTweet](https://opentweet.io)
+- [MCP Server Feature Page](https://opentweet.io/mcp)
+- [Developer Dashboard](https://opentweet.io/developer)
+- [API Documentation](https://opentweet.io/developer)
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,102 @@
+import type { OpenTweetConfig, PaginatedResponse, Post, AccountStatus, AnalyticsOverview, UploadResponse } from './types.js';
+export declare class OpenTweetClient {
+    private apiKey;
+    private baseUrl;
+    constructor(config: OpenTweetConfig);
+    private request;
+    listPosts(params?: {
+        status?: string;
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedResponse<Post>>;
+    getPost(id: string): Promise<Post>;
+    createPost(data: {
+        text: string;
+        category?: string;
+        scheduled_date?: string;
+        is_thread?: boolean;
+        thread_tweets?: string[];
+        media_urls?: string[];
+        thread_media?: string[][];
+        community_id?: string;
+        share_with_followers?: boolean;
+        publish_now?: boolean;
+    }): Promise<{
+        success: boolean;
+        count: number;
+        posts: Post[];
+        message?: string;
+    }>;
+    createBatchPosts(posts: Array<{
+        text: string;
+        category?: string;
+        scheduled_date?: string;
+        is_thread?: boolean;
+        thread_tweets?: string[];
+        media_urls?: string[];
+    }>): Promise<{
+        success: boolean;
+        count: number;
+        posts: Post[];
+    }>;
+    updatePost(id: string, data: {
+        text?: string;
+        category?: string;
+        scheduled_date?: string | null;
+        is_thread?: boolean;
+        thread_tweets?: string[];
+        media_urls?: string[];
+        thread_media?: string[][];
+        community_id?: string;
+        share_with_followers?: boolean;
+    }): Promise<Post>;
+    deletePost(id: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    schedulePost(id: string, scheduledDate: string): Promise<{
+        success: boolean;
+        id: string;
+        text: string;
+        scheduled_date: string;
+        message: string;
+    }>;
+    publishPost(id: string): Promise<{
+        success: boolean;
+        id: string;
+        text: string;
+        x_post_id: string;
+        posted_date: string;
+        message: string;
+    }>;
+    batchSchedule(schedules: Array<{
+        post_id: string;
+        scheduled_date: string;
+    }>, communityId?: string, shareWithFollowers?: boolean): Promise<{
+        success: boolean;
+        message: string;
+        scheduled: Array<{
+            id: string;
+            text: string;
+            scheduled_date: string;
+        }>;
+        errors?: Array<{
+            post_id: string;
+            error: string;
+        }>;
+    }>;
+    getAccountStatus(): Promise<AccountStatus>;
+    getAnalyticsOverview(): Promise<AnalyticsOverview>;
+    getTweetAnalytics(params?: {
+        period?: string;
+        sort_by?: string;
+        limit?: number;
+    }): Promise<Record<string, unknown>>;
+    getBestTimes(): Promise<Record<string, unknown>>;
+    getFollowerGrowth(params?: {
+        days?: number;
+    }): Promise<Record<string, unknown>>;
+    getGrowthSummary(): Promise<Record<string, unknown>>;
+    uploadMedia(fileBuffer: Buffer, fileName: string, mimeType: string): Promise<UploadResponse>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,IAAI,EACJ,aAAa,EACb,iBAAiB,EACjB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,eAAe;YAKrB,OAAO;IAqCf,SAAS,CAAC,MAAM,GAAE;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IASnC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,UAAU,CAAC,IAAI,EAAE;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3E,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC;QAClC,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC;IAI1D,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QACjC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIX,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAItE,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7D,OAAO,EAAE,OAAO,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAII,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QACrC,OAAO,EAAE,OAAO,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAII,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC;QACnC,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAC/D,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACvE,MAAM,CAAC,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACpD,CAAC;IASI,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAK1C,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAIlD,iBAAiB,CAAC,MAAM,GAAE;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IASnC,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIhD,iBAAiB,CAAC,MAAM,GAAE;QAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;KACV,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAOnC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKpD,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAoBnG"}

package/dist/api-client.js

@@ -0,0 +1,125 @@
+export class OpenTweetClient {
+    apiKey;
+    baseUrl;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+    }
+    async request(method, path, body, isFormData) {
+        const url = `${this.baseUrl}/api/v1${path}`;
+        const headers = {
+            'Authorization': `Bearer ${this.apiKey}`,
+        };
+        if (!isFormData) {
+            headers['Content-Type'] = 'application/json';
+        }
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body && !isFormData ? JSON.stringify(body) : body,
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            const errorMessage = data.error || `API error: ${response.status}`;
+            const details = data.details
+                ? Array.isArray(data.details)
+                    ? data.details.join('; ')
+                    : data.details
+                : '';
+            throw new Error(details ? `${errorMessage} — ${details}` : errorMessage);
+        }
+        return data;
+    }
+    // Posts
+    async listPosts(params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.status)
+            searchParams.set('status', params.status);
+        if (params.page)
+            searchParams.set('page', String(params.page));
+        if (params.limit)
+            searchParams.set('limit', String(params.limit));
+        const qs = searchParams.toString();
+        return this.request('GET', `/posts${qs ? `?${qs}` : ''}`);
+    }
+    async getPost(id) {
+        return this.request('GET', `/posts/${id}`);
+    }
+    async createPost(data) {
+        return this.request('POST', '/posts', data);
+    }
+    async createBatchPosts(posts) {
+        return this.request('POST', '/posts', { posts });
+    }
+    async updatePost(id, data) {
+        return this.request('PUT', `/posts/${id}`, data);
+    }
+    async deletePost(id) {
+        return this.request('DELETE', `/posts/${id}`);
+    }
+    async schedulePost(id, scheduledDate) {
+        return this.request('POST', `/posts/${id}/schedule`, { scheduled_date: scheduledDate });
+    }
+    async publishPost(id) {
+        return this.request('POST', `/posts/${id}/publish`);
+    }
+    async batchSchedule(schedules, communityId, shareWithFollowers) {
+        return this.request('POST', '/posts/batch-schedule', {
+            schedules,
+            community_id: communityId,
+            share_with_followers: shareWithFollowers,
+        });
+    }
+    // Account
+    async getAccountStatus() {
+        return this.request('GET', '/me');
+    }
+    // Analytics
+    async getAnalyticsOverview() {
+        return this.request('GET', '/analytics/overview');
+    }
+    async getTweetAnalytics(params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.period)
+            searchParams.set('period', params.period);
+        if (params.sort_by)
+            searchParams.set('sort_by', params.sort_by);
+        if (params.limit)
+            searchParams.set('limit', String(params.limit));
+        const qs = searchParams.toString();
+        return this.request('GET', `/analytics/tweets${qs ? `?${qs}` : ''}`);
+    }
+    async getBestTimes() {
+        return this.request('GET', '/analytics/best-times');
+    }
+    async getFollowerGrowth(params = {}) {
+        const searchParams = new URLSearchParams();
+        if (params.days)
+            searchParams.set('days', String(params.days));
+        const qs = searchParams.toString();
+        return this.request('GET', `/analytics/followers${qs ? `?${qs}` : ''}`);
+    }
+    async getGrowthSummary() {
+        return this.request('GET', '/analytics/growth');
+    }
+    // Upload
+    async uploadMedia(fileBuffer, fileName, mimeType) {
+        const formData = new FormData();
+        const blob = new Blob([new Uint8Array(fileBuffer)], { type: mimeType });
+        formData.append('file', blob, fileName);
+        const url = `${this.baseUrl}/api/v1/upload`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: formData,
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            throw new Error(data.error || `Upload failed: ${response.status}`);
+        }
+        return data;
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { OpenTweetClient } from './api-client.js';
+import { registerPostTools } from './tools/posts.js';
+import { registerSchedulingTools } from './tools/scheduling.js';
+import { registerAnalyticsTools } from './tools/analytics.js';
+import { registerAccountTools } from './tools/account.js';
+import { registerMediaTools } from './tools/media.js';
+import { registerResources } from './resources/index.js';
+import { registerPrompts } from './prompts/index.js';
+const API_KEY = process.env.OPENTWEET_API_KEY;
+const BASE_URL = process.env.OPENTWEET_BASE_URL || 'https://opentweet.io';
+if (!API_KEY) {
+    console.error('Error: OPENTWEET_API_KEY environment variable is required.');
+    console.error('');
+    console.error('Get your API key from: https://opentweet.io/developer');
+    console.error('');
+    console.error('Set it in your MCP client config:');
+    console.error('  "env": { "OPENTWEET_API_KEY": "ot_your_key_here" }');
+    process.exit(1);
+}
+const client = new OpenTweetClient({
+    apiKey: API_KEY,
+    baseUrl: BASE_URL,
+});
+const server = new McpServer({
+    name: 'opentweet',
+    version: '1.0.0',
+});
+// Register all tools
+registerPostTools(server, client);
+registerSchedulingTools(server, client);
+registerAnalyticsTools(server, client);
+registerAccountTools(server, client);
+registerMediaTools(server, client);
+// Register resources
+registerResources(server, client);
+// Register prompts
+registerPrompts(server);
+// Start server with stdio transport
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,sBAAsB,CAAC;AAE1E,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAC5E,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACnD,OAAO,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;IACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;IACjC,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,QAAQ;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,qBAAqB;AACrB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACvC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnC,qBAAqB;AACrB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElC,mBAAmB;AACnB,eAAe,CAAC,MAAM,CAAC,CAAC;AAExB,oCAAoC;AACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

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;AAGpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QAiHhD"}

package/dist/prompts/index.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+export function registerPrompts(server) {
+    server.prompt('weekly_content_plan', 'Generate a week of tweet content based on topics and preferences', {
+        topics: z.string().describe('Comma-separated topics to tweet about (e.g. "AI, startups, product launches")'),
+        tone: z.enum(['professional', 'casual', 'humorous', 'inspirational', 'technical']).optional()
+            .describe('Desired tone for the tweets'),
+        tweets_per_day: z.string().optional().describe('Number of tweets per day (default "2")'),
+    }, ({ topics, tone = 'professional', tweets_per_day = '2' }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Create a weekly content plan for X/Twitter.
+
+Topics: ${topics}
+Tone: ${tone}
+Tweets per day: ${tweets_per_day}
+
+For each day (Monday through Sunday), generate ${tweets_per_day} tweet(s). Each tweet should:
+- Be under 280 characters
+- Be engaging and encourage interaction
+- Include a mix of content types (insights, questions, tips, stories)
+- Be relevant to the topics listed
+
+After generating the tweets, use the opentweet_create_tweet tool to save each one as a draft with an appropriate category. Then I can review and schedule them.
+
+Format each tweet clearly with the day and tweet number.`,
+                },
+            }],
+    }));
+    server.prompt('review_and_schedule_drafts', 'Review your current drafts and suggest optimal scheduling times', {}, () => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Please help me review and schedule my draft tweets.
+
+1. First, use opentweet_list_tweets with status "draft" to see all my drafts
+2. Then use opentweet_get_analytics with type "best_times" to find my optimal posting times
+3. Review each draft for quality - suggest any improvements
+4. Propose a schedule that spreads the tweets across the next few days at optimal times
+5. After I approve, use opentweet_batch_schedule to schedule them all
+
+Show me the drafts and your recommended schedule before taking action.`,
+                },
+            }],
+    }));
+    server.prompt('content_from_url', 'Generate tweets from a URL/article/topic', {
+        source: z.string().describe('URL, article title, or topic to generate tweets about'),
+        count: z.string().optional().describe('Number of tweets to generate (default "5")'),
+        style: z.string().optional().describe('Additional style instructions (e.g. "include statistics", "ask questions")'),
+    }, ({ source, count = '5', style }) => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Generate ${count} engaging tweets about: ${source}
+
+${style ? `Style: ${style}\n` : ''}
+Each tweet should:
+- Be under 280 characters
+- Have a unique angle or perspective
+- Be engaging and shareable
+- Include relevant hashtags where appropriate
+
+After generating them, use opentweet_create_tweet to save each as a draft so I can review and schedule them.`,
+                },
+            }],
+    }));
+    server.prompt('performance_review', 'Analyze your recent tweet performance and get improvement suggestions', {}, () => ({
+        messages: [{
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Analyze my Twitter/X performance and give me actionable suggestions.
+
+1. Use opentweet_get_analytics with type "overview" to get my posting stats and streaks
+2. Use opentweet_get_analytics with type "best_times" to see optimal posting times
+3. Use opentweet_get_analytics with type "tweets" to see per-tweet engagement (if available)
+4. Use opentweet_get_followers to check follower growth trends
+
+Based on the data, tell me:
+- How consistent am I with posting?
+- What categories/topics perform best?
+- Am I posting at optimal times?
+- What's my streak status and how can I maintain it?
+- Specific actionable tips to improve engagement
+- Any concerning trends I should address`,
+                },
+            }],
+    }));
+}
+//# 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":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,MAAM,CACX,qBAAqB,EACrB,kEAAkE,EAClE;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+EAA+E,CAAC;QAC5G,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;aAC1F,QAAQ,CAAC,6BAA6B,CAAC;QAC1C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;KACzF,EACD,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,cAAc,EAAE,cAAc,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5D,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;;UAEN,MAAM;QACR,IAAI;kBACM,cAAc;;iDAEiB,cAAc;;;;;;;;yDAQN;iBAChD;aACF,CAAC;KACH,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,4BAA4B,EAC5B,iEAAiE,EACjE,EAAE,EACF,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;;;;;;;;uEAQuD;iBAC9D;aACF,CAAC;KACH,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,kBAAkB,EAClB,0CAA0C,EAC1C;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;QACpF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QACnF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;KACpH,EACD,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACnC,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,YAAY,KAAK,2BAA2B,MAAM;;EAEhE,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE;;;;;;;6GAO2E;iBACpG;aACF,CAAC;KACH,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,oBAAoB,EACpB,uEAAuE,EACvE,EAAE,EACF,GAAG,EAAE,CAAC,CAAC;QACL,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE;;;;;;;;;;;;;yCAayB;iBAChC;aACF,CAAC;KACH,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/resources/index.d.ts

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

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

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

package/dist/resources/index.js

@@ -0,0 +1,55 @@
+export function registerResources(server, client) {
+    server.resource('account-status', 'opentweet://account', {
+        description: 'Your OpenTweet account status: subscription plan, daily limits, and post counts',
+        mimeType: 'application/json',
+    }, async () => {
+        const data = await client.getAccountStatus();
+        return {
+            contents: [{
+                    uri: 'opentweet://account',
+                    mimeType: 'application/json',
+                    text: JSON.stringify(data, null, 2),
+                }],
+        };
+    });
+    server.resource('scheduled-tweets', 'opentweet://posts/scheduled', {
+        description: 'All your currently scheduled tweets (upcoming posts waiting to be published)',
+        mimeType: 'application/json',
+    }, async () => {
+        const data = await client.listPosts({ status: 'scheduled', limit: 100 });
+        return {
+            contents: [{
+                    uri: 'opentweet://posts/scheduled',
+                    mimeType: 'application/json',
+                    text: JSON.stringify(data, null, 2),
+                }],
+        };
+    });
+    server.resource('draft-tweets', 'opentweet://posts/drafts', {
+        description: 'All your draft tweets (saved but not yet scheduled)',
+        mimeType: 'application/json',
+    }, async () => {
+        const data = await client.listPosts({ status: 'draft', limit: 100 });
+        return {
+            contents: [{
+                    uri: 'opentweet://posts/drafts',
+                    mimeType: 'application/json',
+                    text: JSON.stringify(data, null, 2),
+                }],
+        };
+    });
+    server.resource('analytics-summary', 'opentweet://analytics/summary', {
+        description: 'Your posting analytics: stats, streaks, trends, and category breakdown',
+        mimeType: 'application/json',
+    }, async () => {
+        const data = await client.getAnalyticsOverview();
+        return {
+            contents: [{
+                    uri: 'opentweet://analytics/summary',
+                    mimeType: 'application/json',
+                    text: JSON.stringify(data, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAuB;IAC1E,MAAM,CAAC,QAAQ,CACb,gBAAgB,EAChB,qBAAqB,EACrB;QACE,WAAW,EAAE,iFAAiF;QAC9F,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC7C,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,qBAAqB;oBAC1B,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,kBAAkB,EAClB,6BAA6B,EAC7B;QACE,WAAW,EAAE,8EAA8E;QAC3F,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACzE,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,6BAA6B;oBAClC,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,cAAc,EACd,0BAA0B,EAC1B;QACE,WAAW,EAAE,qDAAqD;QAClE,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACrE,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,0BAA0B;oBAC/B,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,QAAQ,CACb,mBAAmB,EACnB,+BAA+B,EAC/B;QACE,WAAW,EAAE,wEAAwE;QACrF,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,oBAAoB,EAAE,CAAC;QACjD,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,GAAG,EAAE,+BAA+B;oBACpC,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;iBACpC,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/account.d.ts

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

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

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

package/dist/tools/account.js

@@ -0,0 +1,38 @@
+export function registerAccountTools(server, client) {
+    server.tool('opentweet_get_account', 'Get your OpenTweet account status including subscription plan, daily posting limits, and post counts.', {}, async () => {
+        try {
+            const data = await client.getAccountStatus();
+            const { subscription: sub, limits, stats } = data;
+            let text = `OpenTweet Account Status\n\n`;
+            text += `Subscription:\n`;
+            text += `  Status: ${sub.status}\n`;
+            text += `  Has access: ${sub.has_access ? 'Yes' : 'No'}\n`;
+            if (sub.is_trialing) {
+                text += `  Trial: Active (ends ${sub.trial_ends_at})\n`;
+            }
+            if (sub.current_period_ends_at) {
+                text += `  Current period ends: ${sub.current_period_ends_at}\n`;
+            }
+            if (limits) {
+                text += `\nDaily Limits:\n`;
+                text += `  Can post: ${limits.can_post ? 'Yes' : 'No'}\n`;
+                text += `  Posted today: ${limits.posts_published_today}\n`;
+                text += `  Remaining today: ${limits.remaining_posts_today}\n`;
+                text += `  Daily limit: ${limits.daily_limit}\n`;
+            }
+            text += `\nPost Counts:\n`;
+            text += `  Total: ${stats.total_posts}\n`;
+            text += `  Scheduled: ${stats.scheduled_posts}\n`;
+            text += `  Posted: ${stats.posted_posts}\n`;
+            text += `  Drafts: ${stats.draft_posts}`;
+            return { content: [{ type: 'text', text }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=account.js.map

package/dist/tools/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/tools/account.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAuB;IAC7E,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,uGAAuG,EACvG,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAC7C,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;YAElD,IAAI,IAAI,GAAG,8BAA8B,CAAC;YAC1C,IAAI,IAAI,iBAAiB,CAAC;YAC1B,IAAI,IAAI,aAAa,GAAG,CAAC,MAAM,IAAI,CAAC;YACpC,IAAI,IAAI,iBAAiB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;YAC3D,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,IAAI,IAAI,yBAAyB,GAAG,CAAC,aAAa,KAAK,CAAC;YAC1D,CAAC;YACD,IAAI,GAAG,CAAC,sBAAsB,EAAE,CAAC;gBAC/B,IAAI,IAAI,0BAA0B,GAAG,CAAC,sBAAsB,IAAI,CAAC;YACnE,CAAC;YAED,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,IAAI,mBAAmB,CAAC;gBAC5B,IAAI,IAAI,eAAe,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;gBAC1D,IAAI,IAAI,mBAAmB,MAAM,CAAC,qBAAqB,IAAI,CAAC;gBAC5D,IAAI,IAAI,sBAAsB,MAAM,CAAC,qBAAqB,IAAI,CAAC;gBAC/D,IAAI,IAAI,kBAAkB,MAAM,CAAC,WAAW,IAAI,CAAC;YACnD,CAAC;YAED,IAAI,IAAI,kBAAkB,CAAC;YAC3B,IAAI,IAAI,YAAY,KAAK,CAAC,WAAW,IAAI,CAAC;YAC1C,IAAI,IAAI,gBAAgB,KAAK,CAAC,eAAe,IAAI,CAAC;YAClD,IAAI,IAAI,aAAa,KAAK,CAAC,YAAY,IAAI,CAAC;YAC5C,IAAI,IAAI,aAAa,KAAK,CAAC,WAAW,EAAE,CAAC;YAEzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,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/analytics.d.ts

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

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

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