v0.3.11

What's Changed

• feat: Updated date In CHANGELOG of release 0.3.10 by @GenAIwithMS in #34
• feat: Updated date In CHANGELOG of release 0.3.10 by @GenAIwithMS in #35
• chore: fix security vulnerabilities by @GenAIwithMS in #37

Full Changelog: v0.3.10...v0.3.11

v0.3.10

Added

• media_extraction_helper tool — Extracts direct media URLs (images, videos, animated GIFs) from a tweet. Returns the tweet ID, an array of media items with type, direct URL, preview image, dimensions, duration, and all available variants with bit rates for video content.
• engage_with_tweet tool — Perform quick engagement actions: like, retweet, or bookmark a tweet. Accepts tweet_id and action ("like" | "retweet" | "bookmark"), returns a success boolean.
  Changed
• Renamed binary and MCP config key from x-mcp to twitter-mcp for consistency with the package name. Users upgrading may need to update their client's MCP server key from x-mcp to twitter-mcp.
• Package version bumped to 0.3.10.

v0.3.9

v0.3.9

🚀 New Features

• Thread Retrieval: Added fetch_thread_history tool to retrieve full conversation threads seamlessly.
• Mention Monitoring: Added search_recent_mentions tool for real-time mention tracking and specific keyword searches.
• Long-Form Content: Added publish_smart_thread tool to automatically break up and publish long-form content into connected threads.
• Quote Tweeting: Added draft_quote_tweet tool to facilitate structured content sharing and commentary.

📝 Documentation & Maintenance

• Updated the project changelog with the release date.
• Incremented the twitter-mcp package version to v0.3.9.

Full Changelog: https://github.com

v0.3.8

v0.3.8 – 2026-06-12
Added

• get_user_profile_context tool — Fetches a comprehensive Twitter/X user profile including bio, profile metadata, public metrics (followers, following, tweet count), the pinned tweet (if set), and the 5 most recent original tweets with engagement metrics. Input is a username string (without @).
  Changed
• Updated twitter-api-v2 dependency from 1.27.0 → 1.29.0
• Updated README with profile lookup feature, usage examples, and API reference
• Package version bumped to 0.3.8

v0.3.7

This release centralizes the MCP server launch arguments to always include --stdio, fixing a bug where some generated client configs omitted the stdio flag. It also streamlines the installer and documentation so users run the interactive setup and no longer need manual config edits.

Notable changes:

• Centralized MCP launch: single source-of-truth for npx -y @muhammadsiddiq/twitter-mcp --stdio used for JSON, YAML, TOML, and OpenCode config output.
• Bug fix: ensured --stdio is present in all generated server entries to prevent clients from failing to connect.
• Installer-first UX: README rewritten to document the interactive installer (npx @muhammadsiddiq/twitter-mcp) and the questions it asks (target client, Twitter credentials, optional search keys).
• Docs: added step-by-step instructions for obtaining Twitter consumer keys and access tokens, plus guides for XQuik/Hermes and GetXAPI optional search backends.
• Images: improved guidance for posting images (CLI vs agent flows), filesystem/permission notes, path examples, supported formats, limits, and best practices.
• Build: updated compiled installer artifact to reflect the source changes.

v0.3.6

• --stdio routing: The main entry point now detects the --stdio flag. When present, the installer is bypassed entirely and the MCP JSON-RPC server starts directly on stdio. This prevents the 30-second timeout error when AI clients (Claude Desktop, OpenCode, etc.) spawn the package as a background process.

• New AI client presets: The interactive installer now supports two additional environments:

  • Hermes — writes to ~/.hermes/config.yaml in YAML mcp_servers format with --stdio in the args
  • Kilo — writes to ~/.config/kilo/kilo.json in OpenCode-compatible format

• YAML configuration support: Added js-yaml dependency. The installer can now read/write YAML config files (used by Hermes). A "YAML mcp_servers Block" option is also available under Custom Agent.

• Optional search API keys: After the required Twitter OAuth credentials, the installer now asks if you'd like to configure optional XQuik and GetXAPI search backends. If provided, the corresponding base URL is auto-injected (no manual URL entry needed).

🔧 Refactoring

• src/index.ts: startServer() is now exported and no longer auto-runs on import
• src/universal-installer.ts: startInstaller() is now exported; routing logic at module level decides which function to invoke based on process.argv

📦 Dependencies

• Added: js-yaml, @types/js-yaml

---

Full changelog: v0.3.5...v0.3.6

v0.3.5

What's Changed

• ci: fix smithery auth flag by switching to SMITHERY_API_KEY env var by @GenAIwithMS in #12
• ci(smithery): remove stray double quote from publish command by @GenAIwithMS in #13
• ci: optimize bundle size using esbuild and native smithery.yaml by @GenAIwithMS in #14
• ci: replace strict npm ci with npm install to fix lockfile mismatch by @GenAIwithMS in #15
• build: mark dependencies as external in esbuild bundle script by @GenAIwithMS in #16
• ci: assemble and target a lightweight .mcpb bundle for smithery release by @GenAIwithMS in #17
• ci: fix bundle compression format from tar to native zip archive by @GenAIwithMS in #18
• ci: synchronize configuration blocks and staging workflow by @GenAIwithMS in #19
• docs: align configuration schemas and enrich tool metadata for smithe… by @GenAIwithMS in #20
• fix: correct entry point path to build/index.js in smithery.yaml by @GenAIwithMS in #21
• fix: resolve runtime typeerror by migrating to official mcpserver arc… by @GenAIwithMS in #22
• feat: add interactive universal-installer for ai client configuration by @GenAIwithMS in #23
• refactor: switch installer payload from smithery to native npm distri… by @GenAIwithMS in #24
• chore: bump version to 0.3.5 by @GenAIwithMS in #25

Full Changelog: v0.3.4...v0.3.5

v0.3.4

What's Changed

• docs: improve README structure, add section, and reorder content by @GenAIwithMS in #8
• docs: Improve Smithery configuration metadata and update .gitignore by @GenAIwithMS in #9
• ci: add Smithery deployment automation and configurations by @GenAIwithMS in #10
• Fix Smithery publish workflow to pass token explicitly by @GenAIwithMS in #11

Full Changelog: v0.3.3...v0.3.4

v0.3.3

What's Changed

• chore: update publish workflow to trigger on version changes by @GenAIwithMS in #4
• fix: correct step syntax in publish workflow by @GenAIwithMS in #5
• docs: consolidate duplicate MCP config blocks and remove stale wiki f… by @GenAIwithMS in #6
• Updated package version by @GenAIwithMS in #7

Full Changelog: v0.3.2...v0.3.3

v0.3.2

What's Changed

• feat: add optional Hermes Tweet/Xquik search backend by @kriptoburak in #2
• feat: add optional GetXAPI backend for search_tweets by @bozad in #3

New Contributors

• @kriptoburak made their first contribution in #2
• @bozad made their first contribution in #3

Full Changelog: v0.3.1...v0.3.2