oauth 2.0-authenticated tweet composition and publishing
Enables programmatic tweet posting with OAuth 2.0 authentication flow, supporting text content and media attachments through Twitter's v2 API with intelligent fallback to v1.1 endpoints when v2 media upload fails. Implements token refresh logic and secure credential management for long-lived authenticated sessions without requiring API keys to be stored in application code.
Unique: Implements dual-endpoint strategy with v2 API as primary and v1.1 fallback for media uploads, reducing failure rates when Twitter's v2 media endpoints are degraded. Handles OAuth token lifecycle (refresh, expiration, revocation) transparently within the MCP protocol layer rather than delegating to client.
vs alternatives: More resilient than direct REST API clients because fallback logic is server-side, and more secure than API-key-based approaches because OAuth tokens are short-lived and scoped to specific permissions
media attachment handling with format conversion and upload optimization
Processes image, video, and GIF attachments for tweet composition by validating formats, optimizing file sizes, and uploading through Twitter's v2 media endpoint with automatic chunked upload for large files. Falls back to v1.1 media upload endpoint if v2 fails, with format-specific handling (JPEG/PNG for images, MP4/MOV for video, GIF for animations).
Unique: Implements server-side format validation and chunked upload protocol for v2 API, with transparent fallback to v1.1 if v2 media endpoint fails. Handles media ID tracking and attachment to tweets within the MCP layer, abstracting away Twitter's separate media upload → tweet composition workflow.
vs alternatives: Simpler than raw Twitter API clients because media upload and tweet composition are unified in a single MCP tool call, and more reliable than naive implementations because it includes v1.1 fallback and handles chunked uploads for large files
tweet search and retrieval with semantic and keyword filtering
Queries Twitter's v2 search API to retrieve tweets matching keyword, author, date range, and engagement criteria. Implements pagination through result sets, applies rate limiting per search tier, and returns structured tweet objects with metadata (author, engagement metrics, creation time, media references). Supports both recent tweets (last 7 days) and full-archive search depending on API tier.
Unique: Abstracts Twitter's v2 search API pagination and rate limiting within the MCP protocol, allowing agents to retrieve tweets without managing token state or rate limit headers. Supports both recent and full-archive search modes with automatic tier detection.
vs alternatives: More agent-friendly than raw API clients because pagination and rate limiting are handled transparently, and more flexible than pre-built search tools because it supports custom query syntax and field selection
tweet deletion with authentication and authorization validation
Enables programmatic deletion of tweets owned by the authenticated user through Twitter's v2 delete endpoint. Validates that the authenticated user owns the tweet before deletion, handles authorization errors gracefully, and returns confirmation of successful deletion. Implements rate limiting per Twitter's delete API tier.
Unique: Implements authorization validation at the MCP server layer, preventing agents from attempting to delete tweets they don't own and returning clear error messages. Handles rate limiting transparently without exposing Twitter's rate limit headers to the agent.
vs alternatives: Safer than raw API clients because authorization is validated server-side, and more agent-friendly because rate limiting and error handling are abstracted away
comprehensive rate limiting and quota management with per-endpoint tracking
Tracks rate limits across all Twitter API v2 endpoints (tweet creation, search, deletion, media upload) by parsing rate limit headers from responses and maintaining per-endpoint quota state. Implements backoff strategies (exponential backoff, retry-after headers) and prevents requests when quota is exhausted. Exposes rate limit status to agents for intelligent request scheduling.
Unique: Implements per-endpoint rate limit tracking within the MCP server, parsing Twitter's rate limit headers and maintaining quota state across multiple API calls. Exposes rate limit status to agents for proactive request scheduling rather than reactive error handling.
vs alternatives: More proactive than naive clients that retry after rate limit errors, and more transparent than libraries that hide rate limit details because agents can see quota consumption and plan requests accordingly
dual api version support with intelligent endpoint selection and fallback
Maintains compatibility with both Twitter API v2 (primary) and v1.1 (fallback) endpoints, automatically selecting the appropriate version based on feature availability and endpoint health. Implements fallback logic for media uploads (v2 → v1.1) and graceful degradation when v2 endpoints are unavailable. Abstracts API version differences from agents through a unified interface.
Unique: Implements server-side API version negotiation and fallback, allowing agents to use v2 features without worrying about v1.1 compatibility. Automatically retries failed v2 requests with v1.1 endpoints for media uploads, reducing failure rates.
vs alternatives: More resilient than v2-only clients because it includes v1.1 fallback for media uploads, and more agent-friendly than clients requiring explicit API version selection because version negotiation is automatic
mcp protocol integration with standardized tool schema and error handling
Implements the Model Context Protocol (MCP) server specification, exposing Twitter capabilities as standardized MCP tools with JSON schema definitions for inputs/outputs. Handles MCP protocol messages (tool calls, responses, errors) and integrates with MCP clients (Claude, custom agents) through stdio or HTTP transports. Provides structured error responses following MCP conventions.
Unique: Implements full MCP server specification with standardized tool schemas for all Twitter capabilities, enabling seamless integration with Claude and other MCP-compatible agents without custom protocol handling.
vs alternatives: More standardized than custom API integrations because it follows MCP conventions, and more agent-friendly than direct API clients because tool schemas are pre-defined and error handling is protocol-compliant