@granitebps/twitter-mcp 1.0.0

package/dist/providers/rettiwt/provider.js

@@ -0,0 +1,161 @@
+import { Rettiwt } from "rettiwt-api";
+import { TwitterError, toTwitterError } from "../../errors/twitter-error.js";
+import { withDeadline } from "../deadline.js";
+import { mapRettiwtTweet, mapRettiwtUser, } from "./mapper.js";
+function timeoutError() {
+    return new TwitterError({
+        code: "TIMEOUT",
+        safeMessage: "The Rettiwt request timed out",
+        provider: "rettiwt",
+        retryable: true,
+    });
+}
+function mapRettiwtFailure(error) {
+    if (error instanceof TwitterError)
+        return error;
+    const message = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+    if (message.includes("401") || message.includes("auth")) {
+        return new TwitterError({
+            code: "AUTH_FAILED",
+            safeMessage: "Rettiwt authentication failed. Generate a new RETTIWT_API_KEY.",
+            provider: "rettiwt",
+            retryable: false,
+            cause: error,
+        });
+    }
+    if (message.includes("429") || message.includes("rate limit")) {
+        return new TwitterError({
+            code: "RATE_LIMITED",
+            safeMessage: "X rate limit reached",
+            provider: "rettiwt",
+            retryable: true,
+            cause: error,
+        });
+    }
+    if (message.includes("timeout") || message.includes("econnaborted"))
+        return timeoutError();
+    return toTwitterError(error, "rettiwt");
+}
+function parseSearch(query) {
+    const fromUsers = [];
+    const hashtags = [];
+    const mentions = [];
+    const includeWords = [];
+    const warnings = [];
+    let language;
+    for (const token of query.split(/\s+/).filter(Boolean)) {
+        if (token.startsWith("from:") && token.length > 5)
+            fromUsers.push(token.slice(5));
+        else if (token.startsWith("lang:") && token.length > 5)
+            language = token.slice(5);
+        else if (token.startsWith("#") && token.length > 1)
+            hashtags.push(token.slice(1));
+        else if (token.startsWith("@") && token.length > 1)
+            mentions.push(token.slice(1));
+        else if (token.includes(":")) {
+            warnings.push({
+                code: "UNSUPPORTED_SEARCH_OPERATOR",
+                message: `Ignored search operator: ${token}`,
+            });
+        }
+        else
+            includeWords.push(token);
+    }
+    return {
+        filter: {
+            ...(includeWords.length ? { includeWords } : {}),
+            ...(fromUsers.length ? { fromUsers } : {}),
+            ...(hashtags.length ? { hashtags } : {}),
+            ...(mentions.length ? { mentions } : {}),
+            ...(language ? { language } : {}),
+        },
+        warnings,
+    };
+}
+export class RettiwtProvider {
+    client;
+    capabilities = {
+        provider: "rettiwt",
+        authenticated: true,
+        operations: {
+            getTweet: true,
+            getTweetReplies: true,
+            getUserProfile: true,
+            searchTweets: true,
+        },
+        pagination: { replies: true, search: true },
+        limits: { replies: 100, search: 100 },
+    };
+    constructor(client) {
+        this.client = client;
+    }
+    static create(config) {
+        return new RettiwtProvider(new Rettiwt({
+            apiKey: config.apiKey,
+            timeout: config.requestTimeoutMs,
+            logging: false,
+            maxRetries: 0,
+        }));
+    }
+    async getTweet(request, context) {
+        try {
+            const tweet = await withDeadline(this.client.tweet.details(request.tweetId), context.signal, context.deadline, timeoutError);
+            if (!tweet) {
+                throw new TwitterError({
+                    code: "NOT_FOUND",
+                    safeMessage: `Post ${request.tweetId} was not found`,
+                    provider: "rettiwt",
+                    retryable: false,
+                });
+            }
+            return mapRettiwtTweet(tweet);
+        }
+        catch (error) {
+            throw mapRettiwtFailure(error);
+        }
+    }
+    async getTweetReplies(request, context) {
+        try {
+            const result = await withDeadline(this.client.tweet.replies(request.tweetId), context.signal, context.deadline, timeoutError);
+            return {
+                items: result.list.slice(0, request.maxResults).map(mapRettiwtTweet),
+                ...(result.next ? { nextCursor: result.next } : {}),
+            };
+        }
+        catch (error) {
+            throw mapRettiwtFailure(error);
+        }
+    }
+    async getUserProfile(request, context) {
+        try {
+            const user = await withDeadline(this.client.user.details(request.username), context.signal, context.deadline, timeoutError);
+            if (!user) {
+                throw new TwitterError({
+                    code: "NOT_FOUND",
+                    safeMessage: `User @${request.username} was not found`,
+                    provider: "rettiwt",
+                    retryable: false,
+                });
+            }
+            return mapRettiwtUser(user);
+        }
+        catch (error) {
+            throw mapRettiwtFailure(error);
+        }
+    }
+    async searchTweets(request, context) {
+        try {
+            const { filter, warnings } = parseSearch(request.query);
+            const result = await withDeadline(this.client.tweet.search(filter, request.maxResults), context.signal, context.deadline, timeoutError);
+            return {
+                items: result.list.slice(0, request.maxResults).map(mapRettiwtTweet),
+                ...(result.next ? { nextCursor: result.next } : {}),
+                ...(warnings.length ? { warnings } : {}),
+            };
+        }
+        catch (error) {
+            throw mapRettiwtFailure(error);
+        }
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/providers/rettiwt/provider.js.map

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

package/dist/server/create-server.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import type { RuntimeConfig } from "../config/env.js";
+import type { TwitterProvider } from "../providers/provider.js";
+export interface CreateServerOptions {
+    config: RuntimeConfig;
+    provider: TwitterProvider;
+    version: string;
+}
+export declare function createTwitterServer(options: CreateServerOptions): McpServer;

package/dist/server/create-server.js

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import { registerTwitterTools } from "./register-tools.js";
+export function createTwitterServer(options) {
+    const server = new McpServer({ name: "twitter-mcp", version: options.version }, {
+        instructions: "Use these tools to read public X data. Results can omit fields that the selected provider does not return. Call get_server_info to check the provider, limits, and pagination support.",
+    });
+    registerTwitterTools(server, options);
+    return server;
+}
+//# sourceMappingURL=create-server.js.map

package/dist/server/create-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.js","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAIzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAQ3D,MAAM,UAAU,mBAAmB,CAAC,OAA4B;IAC9D,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EACjD;QACE,YAAY,EACV,wLAAwL;KAC3L,CACF,CAAC;IACF,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/input.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export declare function parseTweetReference(value: string): string;
+export declare function normalizeUsername(value: string): string;
+export declare const getTweetInputSchema: z.ZodObject<{
+    tweet_id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export declare const getTweetRepliesInputSchema: z.ZodObject<{
+    tweet_id: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    max_results: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const getUserProfileInputSchema: z.ZodObject<{
+    username: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export declare const searchTweetsInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    max_results: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;

package/dist/server/input.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+const TWEET_ID = /^\d{10,20}$/;
+const USERNAME = /^[A-Za-z0-9_]{1,15}$/;
+const STATUS_URL = /^https:\/\/(?:www\.)?(?:x\.com|twitter\.com)\/[^/]+\/status\/(\d{10,20})(?:[/?#].*)?$/i;
+export function parseTweetReference(value) {
+    const candidate = value.trim();
+    if (TWEET_ID.test(candidate))
+        return candidate;
+    const match = STATUS_URL.exec(candidate);
+    if (match?.[1])
+        return match[1];
+    throw new Error("tweet_id must be a valid X post ID or URL");
+}
+export function normalizeUsername(value) {
+    const candidate = value.trim().replace(/^@/, "");
+    if (USERNAME.test(candidate))
+        return candidate;
+    throw new Error("username must be a valid X username");
+}
+export const getTweetInputSchema = z.object({
+    tweet_id: z.string().transform(parseTweetReference),
+});
+export const getTweetRepliesInputSchema = z.object({
+    tweet_id: z.string().transform(parseTweetReference),
+    max_results: z.number().int().min(1).max(100).default(10),
+});
+export const getUserProfileInputSchema = z.object({
+    username: z.string().transform(normalizeUsername),
+});
+export const searchTweetsInputSchema = z.object({
+    query: z.string().trim().min(1).max(512),
+    max_results: z.number().int().min(1).max(100).default(10),
+});
+//# sourceMappingURL=input.js.map

package/dist/server/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/server/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,QAAQ,GAAG,aAAa,CAAC;AAC/B,MAAM,QAAQ,GAAG,sBAAsB,CAAC;AACxC,MAAM,UAAU,GACd,wFAAwF,CAAC;AAE3F,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAE/C,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAEhC,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,mBAAmB,CAAC;CACpD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,mBAAmB,CAAC;IACnD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,iBAAiB,CAAC;CAClD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC1D,CAAC,CAAC"}

package/dist/server/output.d.ts

@@ -0,0 +1,8 @@
+import type { CallToolResult } from "@modelcontextprotocol/server";
+import type { Tweet, TweetPage, UserProfile } from "../domain/schemas.js";
+import { type ProviderName } from "../errors/twitter-error.js";
+export declare function tweetResult(tweet: Tweet): CallToolResult;
+export declare function profileResult(profile: UserProfile): CallToolResult;
+export declare function pageResult(page: TweetPage): CallToolResult;
+export declare function objectResult(value: Record<string, unknown>): CallToolResult;
+export declare function errorResult(error: unknown, provider: ProviderName): CallToolResult;

package/dist/server/output.js

@@ -0,0 +1,34 @@
+import { toTwitterError } from "../errors/twitter-error.js";
+function text(value) {
+    return [{ type: "text", text: JSON.stringify(value, null, 2) }];
+}
+export function tweetResult(tweet) {
+    return { content: text(tweet), structuredContent: { tweet } };
+}
+export function profileResult(profile) {
+    return { content: text(profile), structuredContent: { profile } };
+}
+export function pageResult(page) {
+    return { content: text(page.items), structuredContent: page };
+}
+export function objectResult(value) {
+    return { content: text(value), structuredContent: value };
+}
+export function errorResult(error, provider) {
+    const mapped = toTwitterError(error, provider);
+    const details = {
+        code: mapped.code,
+        message: mapped.safeMessage,
+        provider: mapped.provider,
+        retryable: mapped.retryable,
+        ...(mapped.retryAfterSeconds === undefined
+            ? {}
+            : { retryAfterSeconds: mapped.retryAfterSeconds }),
+    };
+    return {
+        isError: true,
+        content: [{ type: "text", text: `${mapped.code}: ${mapped.safeMessage}` }],
+        structuredContent: { error: details },
+    };
+}
+//# sourceMappingURL=output.js.map

package/dist/server/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/server/output.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAqB,MAAM,4BAA4B,CAAC;AAE/E,SAAS,IAAI,CAAC,KAAc;IAC1B,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAoB;IAChD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA8B;IACzD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,QAAsB;IAChE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,WAAW;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,CAAC,MAAM,CAAC,iBAAiB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC;KACrD,CAAC;IAEF,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1E,iBAAiB,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;KACtC,CAAC;AACJ,CAAC"}

package/dist/server/register-tools.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+import type { RuntimeConfig } from "../config/env.js";
+import type { TwitterProvider } from "../providers/provider.js";
+export interface RegisterToolsOptions {
+    config: RuntimeConfig;
+    provider: TwitterProvider;
+    version: string;
+}
+export declare function registerTwitterTools(server: McpServer, { config, provider, version }: RegisterToolsOptions): void;

package/dist/server/register-tools.js

@@ -0,0 +1,106 @@
+import { z } from "zod";
+import { TweetPageSchema, TweetSchema, UserProfileSchema } from "../domain/schemas.js";
+import { getTweetInputSchema, getTweetRepliesInputSchema, getUserProfileInputSchema, searchTweetsInputSchema, } from "./input.js";
+import { errorResult, objectResult, pageResult, profileResult, tweetResult } from "./output.js";
+const annotations = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+const tweetOutputSchema = z.object({ tweet: TweetSchema });
+const profileOutputSchema = z.object({ profile: UserProfileSchema });
+const pageOutputSchema = TweetPageSchema;
+const providerCapabilitiesSchema = z.object({
+    provider: z.enum(["rettiwt", "api"]),
+    authenticated: z.boolean(),
+    operations: z.object({
+        getTweet: z.boolean(),
+        getTweetReplies: z.boolean(),
+        getUserProfile: z.boolean(),
+        searchTweets: z.boolean(),
+    }),
+    pagination: z.object({ replies: z.boolean(), search: z.boolean() }),
+    limits: z.object({ replies: z.number().int(), search: z.number().int() }),
+});
+const serverInfoOutputSchema = z.object({
+    name: z.string(),
+    version: z.string(),
+    mode: z.enum(["rettiwt", "api"]),
+    provider: z.enum(["rettiwt", "api"]),
+    authenticated: z.boolean(),
+    tools: z.array(z.string()),
+    capabilities: providerCapabilitiesSchema,
+});
+const publicTools = [
+    "get_tweet",
+    "get_tweet_replies",
+    "get_user_profile",
+    "search_tweets",
+];
+async function execute(context, provider, timeoutMs, operation, format) {
+    const controller = new AbortController();
+    const deadline = Date.now() + timeoutMs;
+    const cancel = () => controller.abort(context.mcpReq.signal.reason);
+    const timeout = setTimeout(() => controller.abort(new Error("Request deadline exceeded")), timeoutMs);
+    if (context.mcpReq.signal.aborted)
+        cancel();
+    else
+        context.mcpReq.signal.addEventListener("abort", cancel, { once: true });
+    try {
+        return format(await operation({ signal: controller.signal, deadline }));
+    }
+    catch (error) {
+        return errorResult(error, provider.capabilities.provider);
+    }
+    finally {
+        clearTimeout(timeout);
+        context.mcpReq.signal.removeEventListener("abort", cancel);
+    }
+}
+export function registerTwitterTools(server, { config, provider, version }) {
+    server.registerTool("get_tweet", {
+        title: "Get tweet",
+        description: "Fetch a public X post from its numeric ID or status URL.",
+        inputSchema: getTweetInputSchema,
+        outputSchema: tweetOutputSchema,
+        annotations,
+    }, (input, context) => execute(context, provider, config.requestTimeoutMs, (requestContext) => provider.getTweet({ tweetId: input.tweet_id }, requestContext), tweetResult));
+    server.registerTool("get_tweet_replies", {
+        title: "Get tweet replies",
+        description: "Fetch replies to a public X post.",
+        inputSchema: getTweetRepliesInputSchema,
+        outputSchema: pageOutputSchema,
+        annotations,
+    }, (input, context) => execute(context, provider, config.requestTimeoutMs, (requestContext) => provider.getTweetReplies({ tweetId: input.tweet_id, maxResults: input.max_results }, requestContext), pageResult));
+    server.registerTool("get_user_profile", {
+        title: "Get user profile",
+        description: "Fetch a public X profile by username.",
+        inputSchema: getUserProfileInputSchema,
+        outputSchema: profileOutputSchema,
+        annotations,
+    }, (input, context) => execute(context, provider, config.requestTimeoutMs, (requestContext) => provider.getUserProfile({ username: input.username }, requestContext), profileResult));
+    server.registerTool("search_tweets", {
+        title: "Search tweets",
+        description: "Search public X posts. The selected provider determines which operators work.",
+        inputSchema: searchTweetsInputSchema,
+        outputSchema: pageOutputSchema,
+        annotations,
+    }, (input, context) => execute(context, provider, config.requestTimeoutMs, (requestContext) => provider.searchTweets({ query: input.query, maxResults: input.max_results }, requestContext), pageResult));
+    server.registerTool("get_server_info", {
+        title: "Get server info",
+        description: "Show the server version, selected provider, limits, and supported operations.",
+        inputSchema: z.object({}),
+        outputSchema: serverInfoOutputSchema,
+        annotations,
+    }, () => objectResult({
+        name: "twitter-mcp",
+        version,
+        mode: config.mode,
+        provider: provider.capabilities.provider,
+        authenticated: provider.capabilities.authenticated,
+        tools: [...publicTools],
+        capabilities: provider.capabilities,
+    }));
+}
+//# sourceMappingURL=register-tools.js.map

package/dist/server/register-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-tools.js","sourceRoot":"","sources":["../../src/server/register-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGvF,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEhG,MAAM,WAAW,GAAG;IAClB,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;CACX,CAAC;AAEX,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;AAC3D,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC;AACrE,MAAM,gBAAgB,GAAG,eAAe,CAAC;AACzC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;QACrB,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;QAC5B,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;QAC3B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE;KAC1B,CAAC;IACF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;IACnE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;CAC1E,CAAC,CAAC;AACH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACpC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,0BAA0B;CACzC,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG;IAClB,WAAW;IACX,mBAAmB;IACnB,kBAAkB;IAClB,eAAe;CACP,CAAC;AAEX,KAAK,UAAU,OAAO,CACpB,OAAsB,EACtB,QAAyB,EACzB,SAAiB,EACjB,SAAyD,EACzD,MAAoC;IAEpC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,UAAU,CACxB,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAC9D,SAAS,CACV,CAAC;IAEF,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO;QAAE,MAAM,EAAE,CAAC;;QACvC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7E,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAQD,MAAM,UAAU,oBAAoB,CAClC,MAAiB,EACjB,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAwB;IAEnD,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE,mBAAmB;QAChC,YAAY,EAAE,iBAAiB;QAC/B,WAAW;KACZ,EACD,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CACjB,OAAO,CACL,OAAO,EACP,QAAQ,EACR,MAAM,CAAC,gBAAgB,EACvB,CAAC,cAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,EAClF,WAAW,CACZ,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,mCAAmC;QAChD,WAAW,EAAE,0BAA0B;QACvC,YAAY,EAAE,gBAAgB;QAC9B,WAAW;KACZ,EACD,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CACjB,OAAO,CACL,OAAO,EACP,QAAQ,EACR,MAAM,CAAC,gBAAgB,EACvB,CAAC,cAAc,EAAE,EAAE,CACjB,QAAQ,CAAC,eAAe,CACtB,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,EAC1D,cAAc,CACf,EACH,UAAU,CACX,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,uCAAuC;QACpD,WAAW,EAAE,yBAAyB;QACtC,YAAY,EAAE,mBAAmB;QACjC,WAAW;KACZ,EACD,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CACjB,OAAO,CACL,OAAO,EACP,QAAQ,EACR,MAAM,CAAC,gBAAgB,EACvB,CAAC,cAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,EACzF,aAAa,CACd,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,+EAA+E;QAC5F,WAAW,EAAE,uBAAuB;QACpC,YAAY,EAAE,gBAAgB;QAC9B,WAAW;KACZ,EACD,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CACjB,OAAO,CACL,OAAO,EACP,QAAQ,EACR,MAAM,CAAC,gBAAgB,EACvB,CAAC,cAAc,EAAE,EAAE,CACjB,QAAQ,CAAC,YAAY,CACnB,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,WAAW,EAAE,EACrD,cAAc,CACf,EACH,UAAU,CACX,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,+EAA+E;QAC5F,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,YAAY,EAAE,sBAAsB;QACpC,WAAW;KACZ,EACD,GAAG,EAAE,CACH,YAAY,CAAC;QACX,IAAI,EAAE,aAAa;QACnB,OAAO;QACP,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,QAAQ;QACxC,aAAa,EAAE,QAAQ,CAAC,YAAY,CAAC,aAAa;QAClD,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC;QACvB,YAAY,EAAE,QAAQ,CAAC,YAAY;KACpC,CAAC,CACL,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@granitebps/twitter-mcp",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "twitter-mcp": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "server.json"
+  ],
+  "mcpName": "io.github.granitebps/twitter-mcp",
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "dev": "npm run build && npm start",
+    "start": "node dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && vitest run",
+    "test:coverage": "npm run build && vitest run --coverage",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check:package": "node scripts/check-package.mjs",
+    "check:install": "node scripts/check-install.mjs",
+    "test:live": "npm run build && vitest run --config vitest.live.config.ts",
+    "check": "npm run format:check && npm run lint && npm run typecheck && npm run test:coverage && npm run check:package && npm run check:install",
+    "prepack": "npm run clean && npm run build"
+  },
+  "engines": {
+    "node": "^22.21.0"
+  },
+  "keywords": [
+    "mcp",
+    "twitter",
+    "x",
+    "ai",
+    "model-context-protocol",
+    "stdio"
+  ],
+  "author": "granitebps",
+  "license": "ISC",
+  "description": "Read public Twitter/X posts, replies, profiles, and search results through MCP.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/granitebps/twitter-mcp.git"
+  },
+  "homepage": "https://github.com/granitebps/twitter-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/granitebps/twitter-mcp/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.0.0",
+    "dotenv": "^17.4.2",
+    "rettiwt-api": "^7.1.3",
+    "twitter-api-v2": "^1.29.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@modelcontextprotocol/client": "^2.0.0",
+    "@types/node": "^25.5.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^3.0.0"
+  }
+}

package/server.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.granitebps/twitter-mcp",
+  "title": "Twitter/X MCP",
+  "description": "Read public Twitter/X posts, replies, profiles, and search results through Rettiwt or the official X API.",
+  "repository": {
+    "url": "https://github.com/granitebps/twitter-mcp",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@granitebps/twitter-mcp",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "RETTIWT_API_KEY",
+          "description": "Rettiwt key containing an authenticated X browser session",
+          "isRequired": true,
+          "isSecret": true,
+          "format": "string"
+        }
+      ]
+    }
+  ]
+}