AppScreen

@appscreen/mcp

Servidor MCP para AppScreen — gere capturas de tela da App Store / Play Store a partir de qualquer agente compatível com MCP (Claude Desktop, Claude Code, Cursor, Codex, etc.).

Instalação

# Latest, no install — recommended for end users
npx -y @appscreen/mcp

Configuração (Claude Desktop)

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "appscreen": {
      "command": "npx",
      "args": ["-y", "@appscreen/mcp"],
      "env": {
        "APPSCREEN_API_KEY": "mcm_live_…"
      }
    }
  }
}

Omita APPSCREEN_API_KEY para uso anônimo (5 renderizações vitalícias, depois é necessário cadastro).

Configuração (outros clientes)

• Claude Code: claude mcp add appscreen -- npx -y @appscreen/mcp

• Cursor: .cursor/mcp.json — mesma estrutura JSON acima.

• Codex: codex mcp add appscreen -- npx -y @appscreen/mcp, ou adicione ao ~/.codex/config.toml:

  [mcp_servers.appscreen]
  command = "npx"
  args = ["-y", "@appscreen/mcp"]
  env = { APPSCREEN_API_KEY = "mcm_live_…" }
  

Ferramentas

• render_screenshots — Aceita telas (JSON de layout) e arquivos de imagem. Retorna um jobId (com chave/assíncrono) ou um link de download (anônimo/inline). Uso anônimo gratuito limitado a 5 vitalícios.
• get_render_status — Consulta um jobId. Retorna status + URL de download assinada quando concluído.

Envie imagens por caminho, não por base64

O servidor roda localmente, então forneça um caminho de arquivo — ele lê os bytes do disco. Não codifique capturas de tela reais em base64 na chamada: um LLM que emite uma string base64 de 18k–90k caracteres perde um caractere no meio e o PNG fica preto abaixo dele.

"files": [
  { "name": "1.png", "path": "~/app/screenshots/home.png" },   // ✅ preferred
  { "name": "2.png", "path": "/abs/path/settings.png" }
]
// base64 is accepted only for tiny synthetic test images:
// { "name": "x.png", "base64": "iVBORw0KG..." }

As URLs de download em lote são assinadas e expiram após ~1h. Consulte novamente para atualizar.

Cota

O uso com login é medido em créditos: 1 crédito = 1 imagem exportada (telas × tamanhos × idiomas). Uma exportação com falha é reembolsada; tradução automática é gratuita. Uma chave MCP gasta os créditos do workspace em que foi criada.

Plano	Créditos / mês	Observações
Gratuito	50	iOS 6.9, inglês, 10 telas por exportação. 3 renderizações / hora.
Starter — US$ 4 / mês	400	Todos os 4 tamanhos, até 3 idiomas por exportação, tradução automática. 3 renderizações / hora.
Pro — US$ 8 / mês	2.500	Todos os 15 idiomas, 200 telas por exportação. MCP em ritmo integral.
Equipe — US$ 29 / mês	8.000 compartilhados	3 assentos incluídos. MCP em ritmo integral.

Pacotes de crédito avulsos funcionam em todos os planos, incluindo o Gratuito: 100 por US$ 5, 400 por US$ 15, 1.500 por US$ 39, válidos por 12 meses. Uso anônimo (sem chave) não é medido em créditos — é limitado a 5 renderizações, vitalícias.

Toda resposta de ferramenta inclui _meta.quota = {used, cap, tier, resetAt}, além de balance (créditos restantes) e, ao enviar uma renderização, cost quando a API os informa. Para um chamador com login, used e cap contam créditos (cap − used = balance) e tier é o id do plano; para um chamador anônimo, eles contam as 5 renderizações vitalícias e tier é anon-mcp. Quando resta menos da metade, o conteúdo de texto traz um aviso curto ("N créditos restantes …"); abaixo de 20%, ou em zero, a resposta também inclui _meta.upgradeUrl.

Uma exportação que o workspace não consegue cobrir falha com HTTP 402 insufficient_credits — o texto do erro informa o custo e o saldo. Detalhes completos: https://appscreen.co/pricing.

Ambiente

Variável	Finalidade
APPSCREEN_API_KEY	Opcional. Chave MCP (mcm_live_…) de https://appscreen.co/account/keys. Funciona em todos os planos, incluindo o Gratuito. Não é a mesma coisa que a chave de API programática ask_live_….
APPSCREEN_BASE_URL	Substitui a URL da API. Padrão: https://api.appscreen.co.
APPSCREEN_MCP_CLIENT	Substitui o identificador do cliente (detectado automaticamente pela inicialização do MCP).

Licença

MIT