io.github.zezeron/tweetsave-mcp

Official5 tools

by zezeron · TypeScript

Twitter/X analysis without token waste. Fetch tweets, download media. No API key.

The Model Context Protocol (MCP) server io.github.zezeron/tweetsave-mcp provides Twitter/X analysis that avoids token waste. It can fetch tweets and download media without requiring an API key. The project is distributed as the tweetsave-mcp package and is licensed under MIT.

🛠️ Key Features

Twitter/X analysis
Fetch tweets
Download media
No API key required
Built as an MCP server (toolCount: 5)

🚀 Use Cases

Analyze Tweet/X content in LLM or agent workflows
Retrieve tweet data and associated media for downstream processing
Automate social-media ingestion without API credentials

⚡ Developer Benefits

MCP integration with 5 available tools
Package availability via npm (tweetsave-mcp)
MIT-licensed codebase

⚠️ Limitations

Limited scope to Twitter/X (as indicated by name/description and topics)

Topics

aiai-agentai-agentsanthropicblogclaudedownloadermcpmcp-serversocial-mediatweettwittertwitter-apitwitter-bottwitter-mcpvideoxx-mcpllmx-api

Captured live from the server via tools/list.

tweetsave_get_tweet

Fetch a single tweet with all its content including text, media (photos, videos, GIFs), polls, and engagement metrics. This tool retrieves tweet data from Twitter/X using the FxTwitter API. It returns the tweet content, author info, media URLs, and engagement stats. Args: - url (string): Tweet URL or tweet ID - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns: Tweet data including: - Author info (name, username, avatar) - Tweet text - Media URLs (photos, videos) - Engagement (likes, retweets, replies, views) - Poll data (if applicable) - Quote tweet (if applicable) Examples: - "Get tweet from https://x.com/elonmusk/status/123456" - "Fetch this tweet: 123456789" Note: Does not fetch replies. Use tweetsave_to_blog for a complete blog post with formatting.

Parameters2

url	string	required	Tweet URL or tweet ID. Examples: 'https://x.com/user/status/123456' or '123456'
response_format	string	optional	Output format: 'markdown' for human-readable or 'json' for structured data

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "description": "Tweet URL or tweet ID. Examples: 'https://x.com/user/status/123456' or '123456'"
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: 'markdown' for human-readable or 'json' for structured data"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tweetsave_get_thread

Fetch a tweet thread (multiple connected tweets by the same author). Note: Current implementation fetches the main tweet. Full thread crawling requires additional API access. Args: - url (string): URL or ID of any tweet in the thread - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns: Array of tweets in the thread with all content and media. Examples: - "Get the full thread from this tweet: https://x.com/user/status/123"

Parameters2

url	string	required	URL or ID of any tweet in the thread
response_format	string	optional	Output format: 'markdown' for human-readable or 'json' for structured data

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "description": "URL or ID of any tweet in the thread"
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: 'markdown' for human-readable or 'json' for structured data"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tweetsave_to_blog

Convert a tweet into a formatted blog post with title, content, media, and metadata. This tool transforms a tweet into a readable blog post format, perfect for: - Archiving tweets - Creating content from threads - Generating blog posts from viral tweets Args: - url (string): Tweet URL or tweet ID - include_engagement (boolean): Include likes/retweets/etc. (default: true) - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns: BlogPost with: - Generated title from tweet content - Author info with avatar - Formatted content with media - Tags from hashtags - Read time estimate - Engagement summary - Source link Examples: - "Convert this tweet to a blog post: https://x.com/user/status/123" - "Make a blog from tweet 123456789"

Parameters3

url	string	required	Tweet URL or tweet ID to convert
include_engagement	boolean	optional	Include engagement metrics (likes, retweets, etc.)
response_format	string	optional	Output format: 'markdown' for blog post or 'json' for structured data

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "description": "Tweet URL or tweet ID to convert"
    },
    "include_engagement": {
      "type": "boolean",
      "default": true,
      "description": "Include engagement metrics (likes, retweets, etc.)"
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: 'markdown' for blog post or 'json' for structured data"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tweetsave_batch

Fetch multiple tweets at once (max 10). Useful for: - Collecting tweets from a list - Building a feed from multiple sources - Comparing multiple tweets Args: - urls (string[]): Array of tweet URLs or IDs (max 10) - response_format ('markdown' | 'json'): Output format (default: 'markdown') Returns: Array of tweets or a combined feed in markdown format. Examples: - "Fetch these tweets: [url1, url2, url3]"

Parameters2

urls	array	required	Array of tweet URLs or IDs (max 10)
response_format	string	optional	Output format: 'markdown' or 'json'

Raw schema

{
  "type": "object",
  "properties": {
    "urls": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 10,
      "description": "Array of tweet URLs or IDs (max 10)"
    },
    "response_format": {
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ],
      "default": "markdown",
      "description": "Output format: 'markdown' or 'json'"
    }
  },
  "required": [
    "urls"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tweetsave_extract_media

Extract direct media URLs (photos, videos, GIFs) from a tweet. Returns direct URLs that can be downloaded or embedded. Video URLs are the highest quality available. Args: - url (string): Tweet URL or tweet ID - media_type ('all' | 'photos' | 'videos'): Filter by media type (default: 'all') Returns: List of media items with: - type (photo/video/gif) - url (direct download URL) - dimensions (width/height) - duration (for videos) Examples: - "Get all media from this tweet: https://x.com/user/status/123" - "Extract video URLs from tweet 123456"

Parameters2

url	string	required	Tweet URL or tweet ID
media_type	string	optional	Type of media to extract: 'all', 'photos', or 'videos'

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "description": "Tweet URL or tweet ID"
    },
    "media_type": {
      "type": "string",
      "enum": [
        "all",
        "photos",
        "videos"
      ],
      "default": "all",
      "description": "Type of media to extract: 'all', 'photos', or 'videos'"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md6 KBView on GitHub

TweetSave

MCP server for fetching Twitter/X content and converting to blog posts.
No Twitter API key required - Uses FxTwitter API (free, open source).

Website • Quick Start • Features • Installation • Tools

Features

Fetch tweets with full content, media, and engagement metrics
Convert tweets to formatted blog posts
Extract media URLs (photos, videos, GIFs)
Batch fetch multiple tweets (up to 10)
Support for quote tweets and polls
Markdown and JSON output formats

Quick Start

Remote MCP (Recommended)

No installation required - connect directly to hosted server:

bash

npx -y mcp-remote https://mcp.tweetsave.org/sse

Local (npx)

bash

npx -y tweetsave-mcp

Installation

Remote MCP (Recommended)

Connect to hosted server - no local installation needed.

Claude Code

bash

# Global (all projects)
claude mcp add -s user tweetsave -- npx -y mcp-remote https://mcp.tweetsave.org/sse

# Project only
claude mcp add tweetsave -- npx -y mcp-remote https://mcp.tweetsave.org/sse

Claude Desktop / Cursor / Windsurf

Add to your MCP configuration:

json

{
  "mcpServers": {
    "tweetsave": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tweetsave.org/sse"]
    }
  }
}

Config file locations:

Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
Cursor: ~/.cursor/mcp.json
Windsurf: ~/.codeium/windsurf/mcp_config.json

VS Code

Create .vscode/mcp.json in your workspace:

json

{
  "servers": {
    "tweetsave": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tweetsave.org/sse"]
    }
  }
}

Gemini CLI

bash

gemini mcp add tweetsave "npx -y mcp-remote https://mcp.tweetsave.org/sse"

JetBrains IDEs

Settings → Tools → MCP Server → Add:

Name: TweetSave
Command: npx
Arguments: -y mcp-remote https://mcp.tweetsave.org/sse

OpenCode

bash

opencode mcp add

Then follow prompts:

Name: tweetsave
Type: Remote
URL: https://mcp.tweetsave.org/sse
OAuth: No

Antigravity

Click ... menu → MCP → Manage MCP Server → View raw config:

json

{
  "mcpServers": {
    "tweetsave": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tweetsave.org/sse"]
    }
  }
}

Local Installation

For offline use or development.

Claude Code

bash

# Global (all projects)
claude mcp add -s user tweetsave -- npx -y tweetsave-mcp

# Project only
claude mcp add tweetsave -- npx -y tweetsave-mcp

Claude Desktop / Cursor / Windsurf

json

{
  "mcpServers": {
    "tweetsave": {
      "command": "npx",
      "args": ["-y", "tweetsave-mcp"]
    }
  }
}

Available Tools

`tweetsave_get_tweet`

Fetch a single tweet with all content.

Parameter	Type	Default	Description
`url`	string	required	Tweet URL or ID
`response_format`	'markdown' \| 'json'	'markdown'	Output format

`tweetsave_get_thread`

Fetch a tweet thread (connected tweets).

Parameter	Type	Default	Description
`url`	string	required	Any tweet URL in thread
`response_format`	'markdown' \| 'json'	'markdown'	Output format

`tweetsave_to_blog`

Convert tweet to blog post format.

Parameter	Type	Default	Description
`url`	string	required	Tweet URL or ID
`include_engagement`	boolean	true	Include likes/retweets
`response_format`	'markdown' \| 'json'	'markdown'	Output format

`tweetsave_batch`

Fetch multiple tweets at once.

Parameter	Type	Default	Description
`urls`	string[]	required	Array of URLs (max 10)
`response_format`	'markdown' \| 'json'	'markdown'	Output format

`tweetsave_extract_media`

Extract direct media URLs from a tweet.

Parameter	Type	Default	Description
`url`	string	required	Tweet URL or ID
`media_type`	'all' \| 'photos' \| 'videos'	'all'	Filter type

Output Examples

Markdown Format

markdown

## @itsPaulAi (Paul Couvert)

This is so good 🔥

You can run this new model on a laptop which is:
- 100% open source
- Only 3B active parameters (!!)

---
**Engagement**: 228 likes | 15 retweets | 29.9K views
**Posted**: January 19, 2026 at 08:02 PM

Blog Post Format

markdown

# This is so good 🔥 You can run this new model...

*A post by @itsPaulAi*

**Author**: Paul Couvert ([@itsPaulAi](https://x.com/itsPaulAi))
**Published**: January 19, 2026 at 08:02 PM
**Read time**: 1 min read

---

[Content here]

---

## Engagement

- **Likes**: 228
- **Retweets**: 15
- **Views**: 29.9K

Limitations

No replies/comments: FxTwitter API doesn't support fetching replies
Rate limits: FxTwitter has rate limits for heavy usage
Private tweets: Cannot access protected/private accounts

License

MIT

Contributing

Contributions welcome! Please open an issue or PR.

Support

Issues: https://github.com/zezeron/tweetsave-mcp/issues
Twitter: @zezeron

Install

Tools (5)

tweetsave_get_tweettweetsave_get_threadtweetsave_to_blogtweetsave_batchtweetsave_extract_media

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "tweetsave-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tweetsave-mcp@1.0.3"
      ]
    }
  }
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

tweetsave_get_tweet

tweetsave_get_thread

tweetsave_to_blog

tweetsave_batch

tweetsave_extract_media

Features

Quick Start

Remote MCP (Recommended)

Local (npx)

Installation

Remote MCP (Recommended)

Claude Code

Claude Desktop / Cursor / Windsurf

VS Code

Gemini CLI

JetBrains IDEs

OpenCode

Antigravity

Local Installation

Claude Code

Claude Desktop / Cursor / Windsurf

Available Tools

tweetsave_get_tweet

tweetsave_get_thread

tweetsave_to_blog

tweetsave_batch

tweetsave_extract_media

Output Examples

Markdown Format

Blog Post Format

Limitations

License

Contributing

Support

Install

Related servers

`tweetsave_get_tweet`

`tweetsave_get_thread`

`tweetsave_to_blog`

`tweetsave_batch`

`tweetsave_extract_media`