{
  "markdown": "<p align=\"center\">\n  <img src=\"https://tweetsave.org/appIcon.png\" alt=\"TweetSave\" width=\"180\">\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.org/package/tweetsave-mcp\"><img src=\"https://img.shields.io/npm/v/tweetsave-mcp.svg\" alt=\"npm version\"></a>\n  <a href=\"https://www.npmjs.org/package/tweetsave-mcp\"><img src=\"https://img.shields.io/npm/dm/tweetsave-mcp.svg\" alt=\"npm downloads\"></a>\n  <a href=\"https://opensource.org/licenses/MIT\"><img src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License: MIT\"></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://modelcontextprotocol.io/\"><img src=\"https://img.shields.io/badge/MCP-Compatible-blue\" alt=\"MCP Server\"></a>\n  <a href=\"https://claude.ai\"><img src=\"https://img.shields.io/badge/Claude-Ready-orange\" alt=\"Claude\"></a>\n  <a href=\"https://mcp.tweetsave.org/health\"><img src=\"https://img.shields.io/badge/Server-Online-brightgreen\" alt=\"Server Status\"></a>\n</p>\n\n<p align=\"center\">\n  MCP server for fetching Twitter/X content and converting to blog posts.<br>\n  <strong>No Twitter API key required</strong> - Uses FxTwitter API (free, open source).\n</p>\n\n<p align=\"center\">\n  <a href=\"https://tweetsave.org\">Website</a> •\n  <a href=\"#quick-start\">Quick Start</a> •\n  <a href=\"#features\">Features</a> •\n  <a href=\"#installation\">Installation</a> •\n  <a href=\"#available-tools\">Tools</a>\n</p>\n\n---\n\n## Features\n\n- Fetch tweets with full content, media, and engagement metrics\n- Convert tweets to formatted blog posts\n- Extract media URLs (photos, videos, GIFs)\n- Batch fetch multiple tweets (up to 10)\n- Support for quote tweets and polls\n- Markdown and JSON output formats\n\n---\n\n## Quick Start\n\n### Remote MCP (Recommended)\n\nNo installation required - connect directly to hosted server:\n\n```bash\nnpx -y mcp-remote https://mcp.tweetsave.org/sse\n```\n\n### Local (npx)\n\n```bash\nnpx -y tweetsave-mcp\n```\n\n---\n\n## Installation\n\n### Remote MCP (Recommended)\n\nConnect to hosted server - no local installation needed.\n\n#### Claude Code\n\n```bash\n# Global (all projects)\nclaude mcp add -s user tweetsave -- npx -y mcp-remote https://mcp.tweetsave.org/sse\n\n# Project only\nclaude mcp add tweetsave -- npx -y mcp-remote https://mcp.tweetsave.org/sse\n```\n\n#### Claude Desktop / Cursor / Windsurf\n\nAdd to your MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"tweetsave\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.tweetsave.org/sse\"]\n    }\n  }\n}\n```\n\n**Config file locations:**\n- **Claude Desktop (macOS):** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Claude Desktop (Windows):** `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Cursor:** `~/.cursor/mcp.json`\n- **Windsurf:** `~/.codeium/windsurf/mcp_config.json`\n\n#### VS Code\n\nCreate `.vscode/mcp.json` in your workspace:\n\n```json\n{\n  \"servers\": {\n    \"tweetsave\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.tweetsave.org/sse\"]\n    }\n  }\n}\n```\n\n#### Gemini CLI\n\n```bash\ngemini mcp add tweetsave \"npx -y mcp-remote https://mcp.tweetsave.org/sse\"\n```\n\n#### JetBrains IDEs\n\nSettings → Tools → MCP Server → Add:\n\n- **Name:** TweetSave\n- **Command:** npx\n- **Arguments:** -y mcp-remote https://mcp.tweetsave.org/sse\n\n#### OpenCode\n\n```bash\nopencode mcp add\n```\n\nThen follow prompts:\n- **Name:** tweetsave\n- **Type:** Remote\n- **URL:** https://mcp.tweetsave.org/sse\n- **OAuth:** No\n\n#### Antigravity\n\nClick `...` menu → MCP → Manage MCP Server → View raw config:\n\n```json\n{\n  \"mcpServers\": {\n    \"tweetsave\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-remote\", \"https://mcp.tweetsave.org/sse\"]\n    }\n  }\n}\n```\n\n---\n\n### Local Installation\n\nFor offline use or development.\n\n#### Claude Code\n\n```bash\n# Global (all projects)\nclaude mcp add -s user tweetsave -- npx -y tweetsave-mcp\n\n# Project only\nclaude mcp add tweetsave -- npx -y tweetsave-mcp\n```\n\n#### Claude Desktop / Cursor / Windsurf\n\n```json\n{\n  \"mcpServers\": {\n    \"tweetsave\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"tweetsave-mcp\"]\n    }\n  }\n}\n```\n\n---\n\n## Available Tools\n\n### `tweetsave_get_tweet`\n\nFetch a single tweet with all content.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `url` | string | required | Tweet URL or ID |\n| `response_format` | 'markdown' \\| 'json' | 'markdown' | Output format |\n\n### `tweetsave_get_thread`\n\nFetch a tweet thread (connected tweets).\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `url` | string | required | Any tweet URL in thread |\n| `response_format` | 'markdown' \\| 'json' | 'markdown' | Output format |\n\n### `tweetsave_to_blog`\n\nConvert tweet to blog post format.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `url` | string | required | Tweet URL or ID |\n| `include_engagement` | boolean | true | Include likes/retweets |\n| `response_format` | 'markdown' \\| 'json' | 'markdown' | Output format |\n\n### `tweetsave_batch`\n\nFetch multiple tweets at once.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `urls` | string[] | required | Array of URLs (max 10) |\n| `response_format` | 'markdown' \\| 'json' | 'markdown' | Output format |\n\n### `tweetsave_extract_media`\n\nExtract direct media URLs from a tweet.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `url` | string | required | Tweet URL or ID |\n| `media_type` | 'all' \\| 'photos' \\| 'videos' | 'all' | Filter type |\n\n---\n\n## Output Examples\n\n### Markdown Format\n\n```markdown\n## @itsPaulAi (Paul Couvert)\n\nThis is so good 🔥\n\nYou can run this new model on a laptop which is:\n- 100% open source\n- Only 3B active parameters (!!)\n\n---\n**Engagement**: 228 likes | 15 retweets | 29.9K views\n**Posted**: January 19, 2026 at 08:02 PM\n```\n\n### Blog Post Format\n\n```markdown\n# This is so good 🔥 You can run this new model...\n\n*A post by @itsPaulAi*\n\n**Author**: Paul Couvert ([@itsPaulAi](https://x.com/itsPaulAi))\n**Published**: January 19, 2026 at 08:02 PM\n**Read time**: 1 min read\n\n---\n\n[Content here]\n\n---\n\n## Engagement\n\n- **Likes**: 228\n- **Retweets**: 15\n- **Views**: 29.9K\n```\n\n---\n\n## Limitations\n\n- **No replies/comments**: FxTwitter API doesn't support fetching replies\n- **Rate limits**: FxTwitter has rate limits for heavy usage\n- **Private tweets**: Cannot access protected/private accounts\n\n---\n\n## License\n\nMIT\n\n## Contributing\n\nContributions welcome! Please open an issue or PR.\n\n## Support\n\n- Issues: https://github.com/zezeron/tweetsave-mcp/issues\n- Twitter: [@zezeron](https://x.com/zezeron)\n",
  "bytes": 6603,
  "sha": "eece38b1c758205818d1a0491cedf903b1c208dbcd050f5c7a81d996f7396932",
  "repo_slug": "zezeron/tweetsave-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_zezeron_tweetsave_mcp_779e5ebb/readme"
}