Hosted remote MCP
Swipe Pilot MCP for agents
Connect an MCP-compatible agent to your workspace. It sees your iPhones, uploads slideshows, schedules posts, runs your scripts and sets up routines, then reads what went out. You allow it in your browser, and you can revoke it at any time.
Connect
Pick your AI tool
The steps below follow your choice.
Add the Swipe Pilot server
In a terminal:
Terminalclaude mcp add --transport http swipe-pilot https://pilot-relay.darvens485.workers.dev/mcpOpen the MCP menu
Start Claude Code, run
/mcp, pickswipe-pilotand choose Authenticate.Claude Code/mcpAllow it
Your browser opens Swipe Pilot. Sign in if it asks, read what the connection will be able to do, and click Allow.You're set
Ready to useTry: “List my iPhones and their accounts.”
--header "Authorization: Bearer sp_your_key" to the command: there is no browser step then.Available tools
| Tool | Purpose | Access |
|---|---|---|
| list_iphones | Your iPhones: online or paused, the country their traffic must leave from, their accounts | Read |
| upload_media | Stores a photo or a video from a public https address or base64, and returns its id | Write |
| list_media | The photos and videos already uploaded, with their ids | Read |
| queue_post | Queues a post on an iPhone or for an account: media in slide order, caption, title, now or at a time | Write |
| list_queue | The 50 latest tasks with their state: scheduled, running, posted, failed, to check | Read |
| cancel_task | Cancels a task that has not started | Write |
| list_scripts | Your scripts, and those installed on each iPhone with the command that runs them | Read |
| run_script | Runs a script on an iPhone, now or at a time, importing it first when it is not installed | Write |
| list_routines | Your routines: what they run, where, their next run, how often | Read |
| create_routine | Repeats a post or a script every so many hours, each run at a random moment in its window | Write |
| update_routine | Pauses, resumes, moves or changes a routine | Write |
| delete_routine | Deletes a routine | Write |
| daily_summary | Posts each iPhone confirmed over the last hours, per account, failures and quiet iPhones | Read |
Each tool's arguments, answers and limits are in the MCP tools reference.
What to ask
- “List my iPhones and their accounts.”
- “Upload these three images and post them on @mybrand tomorrow at 9:00 with this caption.”
- “Run Morning scroll on every iPhone at 8:00, a few minutes apart.”
- “Post this slideshow on @mybrand every day around 18:00, within a 45-minute window.”
- “What did my iPhones post in the last 24 hours? Which one went quiet?”
- “Pause the routines on Alpha until Monday.”
Your own files
upload_media takes a public https address, or the file in base64 for small ones. For large files on your computer, have the agent upload them with the REST API and pass the returned ids to queue_post. Files are 25 MB at most: JPEG, PNG, WebP, HEIC, MP4 or MOV.
When a post counts as done
Every post script ends with a double tap on the companion, after its Post step. When the iPhone confirms that end, the post shows as posted in list_queue and counts in daily_summary. Swipe Pilot never opens TikTok to check it.
Security
Allowed in your browser. The connection uses OAuth with PKCE: you sign in to Swipe Pilot and click Allow. The code it gets lasts five minutes and works once.
A key you can revoke. What the agent receives is an API key named after it, listed in Settings, then API & MCP, with when it was last used. Revoke it there and the agent is cut off.
Limited on purpose. A connection reads your iPhones, accounts and scripts, uploads media, runs scripts, and manages the queue and routines. It cannot edit your scripts, change your plan or your settings, set up or purge an iPhone, or delete media.
Each workspace keeps at most ten keys, and requests are limited to 120 a minute.