spaces

Download or live-record X/Twitter Spaces audio. The tool auto-detects whether a Space is live or ended and handles both. Live Spaces record from the current moment using ffmpeg. Ended Spaces download the full recording via yt-dlp. All downloads run in the background so your agent keeps working. One tool, three modes based on what parameters you pass:

Download: pass url to start a background download
Check: pass recording_id to check download status
Stop: pass recording_id + stop: true to stop a live recording

Example: Download a Space

Request:

{
  "url": "https://x.com/i/spaces/1yNxaNvaMYQKj"
}

Response:

{
  "success": true,
  "recording_id": "a3f8c21b",
  "mode": "recording",
  "title": "AI Agents and the Future of Automation",
  "url": "https://twitter.com/i/spaces/1yNxaNvaMYQKj",
  "output_dir": "/Users/you/Downloads",
  "pid": 48291,
  "message": "Downloading full recording (ID: a3f8c21b). Use spaces with recording_id to check progress."
}

Example: Check status

Request:

{
  "recording_id": "a3f8c21b"
}

Response (downloading):

{
  "recording_id": "a3f8c21b",
  "status": "downloading",
  "elapsed_seconds": 45,
  "elapsed_formatted": "0m 45s",
  "file": {
    "path": "/Users/you/Downloads/AI_Agents_and_the_Future.m4a",
    "filename": "AI_Agents_and_the_Future.m4a",
    "size_mb": 12.4
  },
  "message": "Still downloading (0m 45s elapsed)"
}

Response (complete):

{
  "recording_id": "a3f8c21b",
  "status": "complete",
  "elapsed_seconds": 83,
  "elapsed_formatted": "1m 23s",
  "file": {
    "path": "/Users/you/Downloads/AI_Agents_and_the_Future.m4a",
    "filename": "AI_Agents_and_the_Future.m4a",
    "size_mb": 47.2
  },
  "message": "Download complete. Saved to /Users/you/Downloads/AI_Agents_and_the_Future.m4a"
}

Example: Stop a live recording

Request:

{
  "recording_id": "a3f8c21b",
  "stop": true
}

Response:

{
  "success": true,
  "recording_id": "a3f8c21b",
  "status": "stopped",
  "elapsed_seconds": 1847,
  "elapsed_formatted": "30m 47s",
  "file": {
    "path": "/Users/you/Downloads/Live_Space_Recording.m4a",
    "filename": "Live_Space_Recording.m4a",
    "size_mb": 22.1
  },
  "message": "Stopped after 30m 47s. Saved to /Users/you/Downloads/Live_Space_Recording.m4a"
}

Parameters

Parameter	Required	Default	Description
`url`	No	—	Twitter/X Space URL. Starts a background download.
`output_dir`	No	`~/Downloads`	Directory to save the audio file
`recording_id`	No	—	Check status of a previous download, or stop it when combined with `stop`
`stop`	No	`false`	Stop a live recording. Requires `recording_id`.

Pass url to start a download. Pass recording_id to check status. Pass recording_id + stop: true to stop.

Pipeline

Once a Space is downloaded, pipe it through the rest of Augent:

spaces(url=...) to download the audio
spaces(recording_id=...) to poll until complete
transcribe_audio(audio_path=...) to get the full transcript
search_audio, deep_search, chapters, highlights, etc.

Or use take_notes(url=...) directly if you just want formatted notes from the Space.

Setup

X/Twitter requires authentication to access Space audio. Any account works, including a burner. This is a one-time setup.

Log into x.com in any browser
Open DevTools (F12 or Cmd+Option+I), go to Application tab, then Cookies, then https://x.com
Copy the auth_token and ct0 cookie values
Create ~/.augent/auth.json:

{"auth_token": "PASTE_HERE", "ct0": "PASTE_HERE"}

Tokens are stored locally and only sent to Twitter’s own servers to fetch audio. Augent never posts, DMs, follows, or modifies anything on your account. To revoke access, log out of Twitter or delete ~/.augent/auth.json.

Notes

Live Spaces record from the current moment forward. Ended Spaces download the full recording.

Downloads run in the background. Your agent can continue doing other work while the Space downloads.

The recording_id is only valid for the current session. If the MCP server restarts, active recordings are lost.

Combine with identify_speakers to find out who said what in a multi-speaker Space.

Core

Search

Analysis

Processing

Memory

Example: Download a Space

Example: Check status

Example: Stop a live recording

Parameters

Pipeline

Setup

Notes

​Example: Download a Space

​Example: Check status

​Example: Stop a live recording

​Parameters

​Pipeline

​Setup

​Notes

Example: Download a Space

Example: Check status

Example: Stop a live recording

Parameters

Pipeline

Setup

Notes