# thumbs

> thumbs is a free MCP server for developer tools. Remote MCP server that gives an agent an iPhone to see, tap and type on. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://www.usethumbs.com
- **Repository:** https://github.com/jorchg/usethumbs-mcp
- **MCP Registry name:** com.usethumbs/thumbs
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

After each action the agent receives a screenshot of the phone plus a numbered list of everything tappable, 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.

Right now it is early access by waitlist, and it runs on a shared iOS Simulator limited to Safari and Apple's built-in apps, not App Store apps. The README says a real iPhone of your own is planned, with no date or price, and that the uses involving your own apps or other apps depend on that. Today the working use is opening your web pages in Safari and seeing what a phone shows, such as a keyboard covering a button.

Sign-in is OAuth 2.1 with Google, and only accounts let in from the waitlist can use a phone. The maker's timings, taken on a real iPhone 17 Pro rather than the Simulator, include a 63 ms screenshot and 296 commands in 20 minutes with no failures. The repository holds documentation only, under MIT.

## Features

- **Numbered tap targets:** Each screen comes back with a screenshot and labelled, numbered elements.
- **Full touch input:** Tap, type, swipe, scroll, open apps and links, press home, answer alerts.
- **Safari testing:** Open web pages on a simulated iPhone to check layout and keyboard behaviour.
- **No local setup:** No Mac, Xcode or cable; one remote URL with Google sign-in.
- **Broad client support:** Setup steps for Claude Code, the Claude app, Cursor and VS Code.
- **Waitlist access:** Free early access, let in one tester at a time.

## Good for

- Check whether the keyboard hides a sign-up button on mobile
- Walk a web form in Safari and report what breaks
- Test a mobile web page layout from an agent
- Read system settings such as the iOS version on a simulator
- Prepare agent workflows for apps that only run on iPhone

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http thumbs https://mcp.usethumbs.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.usethumbs.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "thumbs": {
      "type": "http",
      "url": "https://mcp.usethumbs.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "thumbs": {
      "serverUrl": "https://mcp.usethumbs.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "thumbs": {
      "type": "http",
      "url": "https://mcp.usethumbs.com/mcp"
    }
  }
}
```

## FAQ

### Is it free?

Early access is free; a real iPhone is planned but has no date or price yet.

### Can it use App Store apps?

Not yet. Early access runs on the iOS Simulator with Safari and Apple's built-in apps only.

### How do I connect?

Add https://mcp.usethumbs.com/mcp, for example with claude mcp add --transport http, then sign in with Google once you are let in from the waitlist.

### Is the source code available?

No. The repository holds documentation only, under MIT; the server code is not published there.

### Is thumbs free?

Yes. thumbs is free to use.

### How do I add thumbs to Claude Code?

Run this command in your terminal: claude mcp add --transport http thumbs https://mcp.usethumbs.com/mcp

### What are the best alternatives to thumbs?

The closest alternatives to thumbs are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/thumbs
