thumbs

thumbs: an iPhone for your AI agent (MCP)

thumbs gives Claude Code, or any MCP client, an iPhone to see, tap and type on, through one remote MCP server URL with Google sign-in. Nothing to install on your side: no Mac, no Xcode, no cable.

https://mcp.usethumbs.com/mcp

Status: early access, by waitlist. Free early access runs on the iOS Simulator (Safari and Apple's built-in apps), shared between testers and let in one at a time. A real iPhone of your own is planned; it is not available yet and has no date or price.

Join the waitlist →

This repository holds the documentation only. The server's source code is not published here. Docs are MIT licensed (see LICENSE).

What an agent can do

An agent gets a screenshot of the phone and a numbered list of everything it can tap, with labels and positions, so it can say "tap 4" instead of guessing pixels. It can tap, type, swipe, scroll, open apps and links, press the home button and answer system alerts.

What you can use it for

• Check your web app on iOS (works in early access): open your pages in Safari on an iPhone Simulator and see what a phone shows, such as the keyboard covering a form. Guide: How to test your web app on an iPhone with an AI agent.
• Test your own app, map other apps, use apps with no API (these need your own iPhone, which is planned and not available yet).

More: How to give an AI agent an iPhone with MCP.

Connect

Only accounts that have been let in from the waitlist can use a phone. Join the waitlist if you aren't in yet.

Generic config for clients that take a URL:

{ "mcpServers": { "thumbs": { "url": "https://mcp.usethumbs.com/mcp" } } }

Server details

An unauthenticated request gets 401 with a WWW-Authenticate header pointing to the OAuth metadata. That is expected.

Measured

On a real iPhone 17 Pro, 23 October 2026, run by the maker (not on the Simulator that early access uses today): a screenshot in about 63 ms; a tap in 0.4 to 0.8 s depending on the app; 296 commands in 20 minutes with no failures; a language app's 19-screen onboarding walked to its paywall in 3.2 minutes.

Limits

• Early access is the iOS Simulator: Safari and Apple's built-in apps, not App Store apps. It is not a real device.
• The Simulator is shared between testers, in turns of up to 30 minutes. Don't sign in to personal accounts on it; anything left on it may be seen by us and the next tester, and may be deleted.
• No banking apps, no Apple Pay, nothing behind Face ID.
• It may be slow, unavailable or change at any time. Early access is provided as it is, without warranty.

Usage policy

Use thumbs for your own apps, your own accounts and your own research. Don't use it to spam, make fake accounts, get around an app's rules or security, harm others, or anything illegal. Don't try to break, overload or reverse-engineer the service. You are responsible for what your agent does and for having the right to test the apps you point it at. Full text: Terms · Privacy.

Links

• Website and waitlist: usethumbs.com
• Guides: usethumbs.com/guides
• Contact: [email protected]
• Maker: Jorge García González.

License

The documentation in this repository is released under the MIT License. "thumbs" and the thumbs logo are not covered by it.