Twitter Spaces MCP Server
An MCP (Model Context Protocol) server for downloading and transcribing Twitter Spaces using AI.
Features
- ✅ Check Twitter Space availability
- 📥 Download Twitter Spaces
- 🎤 AI-powered transcription using Deepgram
- 📝 Multiple transcript formats (JSON, TXT, Paragraphs, Time-coded, Summary)
- 📋 List all downloaded spaces
- 🔄 Complete download + transcription workflow
Tools
check_space_availability
Check if a Twitter Space is available for download.
Parameters:
space_url(string): Full Twitter Space URL
download_twitter_space
Download a Twitter Space and optionally wait for completion.
Parameters:
space_url(string): Full Twitter Space URLwait_for_completion(boolean): Whether to wait for completion
transcribe_space
Transcribe a downloaded Twitter Space using AI.
Parameters:
space_id(string): Space ID (extracted from URL)wait_for_completion(boolean): Whether to wait for completion
get_transcript
Download transcript in various formats.
Parameters:
space_id(string): Space IDformat(string): Format (json, txt, paragraphs, timecoded, summary)
list_spaces
List all downloaded Twitter Spaces.
download_and_transcribe_space
Complete workflow: download and transcribe a space.
Parameters:
space_url(string): Full Twitter Space URL
Configuration
apiUrl(required): Base URL of the Twitter Spaces API backendtimeout(optional): Request timeout in seconds (default: 30)
Usage Examples
- Check if a space is available:
Use check_space_availability with space_url="https://x.com/i/spaces/1ZkKzYLnWOLxv"
- Download and transcribe in one step:
Use download_and_transcribe_space with space_url="https://x.com/i/spaces/1ZkKzYLnWOLxv"
- Get transcript with speaker diarization:
Use get_transcript with space_id="1ZkKzYLnWOLxv" and format="paragraphs"
Code
Backend Requirements
This MCP server requires a compatible Twitter Spaces API backend running with the following endpoints:
- POST /api/download
- GET /api/status/{download_id}
- POST /api/transcribe
- GET /api/transcription/status/{transcription_id}
- GET /api/transcript/{space_id}/download/{format}
- GET /api/spaces
- GET /api/check-space/{space_id}