# screenmocks-mcp

[![screenmocks-mcp MCP server](https://glama.ai/mcp/servers/moetalaat/screenmocks-mcp/badges/card.svg)](https://glama.ai/mcp/servers/moetalaat/screenmocks-mcp)

A tiny stdio bridge to the hosted [ScreenMocks](https://www.screenmocks.com) MCP
server. ScreenMocks lets an AI agent design and export localized App Store and
Play Store screenshot sets: create projects, add screens, place device frames,
3D mockups, text, shapes and stock photos, apply per-size and per-locale
overrides across all 48 App Store locales, and read back a measured layout
report to verify its own design. 44 tools.

The product runs hosted; this repository is the open-source client shim for MCP
clients that only speak stdio. Clients that support Streamable HTTP should skip
it and connect directly.

## Direct connection (recommended)

```json
{
  "mcpServers": {
    "screenmocks": {
      "type": "http",
      "url": "https://www.screenmocks.com/api/mcp",
      "headers": { "Authorization": "Bearer sf_pat_your_token" }
    }
  }
}
```

## Via this bridge (stdio-only clients)

```json
{
  "mcpServers": {
    "screenmocks": {
      "command": "npx",
      "args": ["-y", "screenmocks-mcp"],
      "env": { "SCREENMOCKS_TOKEN": "sf_pat_your_token" }
    }
  }
}
```

## Getting a token

Sign in at [screenmocks.com](https://www.screenmocks.com), Settings → MCP →
Create token (paid plans). The token is shown once; treat it like a password —
it acts on your whole account. Without a token the bridge still starts and
answers `initialize` and `tools/list` from the
[public manifest](https://www.screenmocks.com/mcp.json), so you can inspect the
tool set; calling a tool returns an error pointing here.

## Docs

- Server page and connection details: <https://www.screenmocks.com/mcp>
- Tool reference: <https://www.screenmocks.com/docs> (MCP article)
- Manifest: <https://www.screenmocks.com/mcp.json>

## License

MIT (this bridge). The hosted service has its own [terms](https://www.screenmocks.com/terms).