screenmocks-mcp

A tiny stdio bridge to the hosted ScreenMocks 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)

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

Via this bridge (stdio-only clients)

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

Getting a token

Sign in at 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, 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.