QuickerSpot MCP Server

<!-- mcp-name: io.github.raphaelInacio/quickerspot-mcp --> mcp-name: io.github.raphaelInacio/quickerspot-mcp

Servidor MCP QuickerSpot

Servidor oficial Model Context Protocol (MCP) para a plataforma QuickerSpot — Automação de vinhetas, rádio indoor e sonorização comercial com IA.

Conecte seus Assistentes de IA (Cursor IDE, Claude Desktop, Antigravity, Hermes Agent, OpenClaw) diretamente ao motor de voz ElevenLabs V3, gerador de roteiros por IA e mixer de rádio indoor do QuickerSpot.

🚀 Como Usar em 2 Passos

1. Obter sua API Key

Acesse o painel do QuickerSpot em quickerspot.com/settings e crie uma nova API Key (ex: qslive...).

2. Configurar o mcp.json

Adicione a definição do servidor no seu arquivo mcp.json (ou claudedesktopconfig.json):

{
  "mcpServers": {
    "quickerspot": {
      "command": "uvx",
      "args": ["quickerspot-mcp"],
      "env": {
        "QUICKERSPOT_API_KEY": "qs_live_SUA_CHAVE_AQUI"
      }
    }
  }
}

O quickerspot-mcp conecta-se automaticamente ao backend de produção do QuickerSpot. Se você estiver desenvolvendo localmente, pode adicionar "QUICKERSPOTAPIURL": "http://localhost:8000" no bloco env.

🛠️ Ferramentas MCP Disponíveis (tools)

1. listvoices()** — Retorna o catálogo de vozes comerciais disponíveis (Camila, Helena, Marcos, Carlos, Ricardo).
2. createcampaign(name, data, voicetone, freetext)** — Cria uma nova campanha comercial e gera o roteiro síncrono via IA.
3. approvescript(campaignid, script, backgroundmusic)** — Aprova o roteiro e dispara a síntese de voz pura em estúdio.
4. remixcampaignaudio(campaignid, backgroundmusic, audiostyle)** — Aplica ou substitui a trilha sonora de fundo e masterização sem custo adicional de síntese de voz (TTS).
5. getcampaignstatus(campaignid)** — Consulta o status (PENDING, PROCESSING, COMPLETED), roteiro e URLs de download dos MP3s.
6. listcampaigns()** — Lista todas as campanhas ativas da sua conta.
7. createrecado(text, voiceid) — Gera áudio instantâneo de recado/aviso para loja com vinheta (fast-lane sem fluxo HITL).

💻 Execução com Python Local (Opcional)

Se preferir rodar localmente com Python:

{
  "mcpServers": {
    "quickerspot": {
      "command": "python",
      "args": ["-m", "quickerspot_mcp.server"],
      "env": {
        "QUICKERSPOT_API_KEY": "qs_live_SUA_CHAVE_AQUI"
      }
    }
  }
}