Skip to main content
Glama

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: qs_live_...).

2. Configurar o mcp.json

Adicione a definição do servidor no seu arquivo mcp.json (ou claude_desktop_config.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 "QUICKERSPOT_API_URL": "http://localhost:8000" no bloco env.


Related MCP server: ElevenLabs MCP Server

🛠️ Ferramentas MCP Disponíveis (tools)

  1. list_voices() — Retorna o catálogo de vozes comerciais disponíveis (Camila, Helena, Marcos, Carlos, Ricardo).

  2. create_campaign(name, data, voice_tone, free_text) — Cria uma nova campanha comercial e gera o roteiro síncrono via IA.

  3. approve_script(campaign_id, script, background_music) — Aprova o roteiro e dispara a síntese de voz pura em estúdio.

  4. remix_campaign_audio(campaign_id, background_music, audio_style) — Aplica ou substitui a trilha sonora de fundo e masterização sem custo adicional de síntese de voz (TTS).

  5. get_campaign_status(campaign_id) — Consulta o status (PENDING, PROCESSING, COMPLETED), roteiro e URLs de download dos MP3s.

  6. list_campaigns() — Lista todas as campanhas ativas da sua conta.

  7. create_recado(text, voice_id) — 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"
      }
    }
  }
}

Available Tools

6 tools
approve_scriptA

Aprova (ou edita) o roteiro de uma campanha e dispara a produção de áudio (TTS e mixagem) em background.

Parâmetros:

  • campaign_id: ID da campanha a ser aprovada.

  • script: Texto do roteiro final editado (opcional). Se não informado, utiliza o roteiro gerado pela IA.

  • action: Ação a realizar ("approve" para aprovar e gerar áudio, ou "regenerate" para solicitar novo roteiro). Default: "approve".

Retorna uma confirmação de que o processamento foi iniciado em background (Status 202 Accepted). Use get_campaign_status após alguns segundos para verificar a conclusão da produção.

Inputs: campaign_id (required), action, script. Returns: result

create_campaignA

Cria uma nova campanha comercial no QuickerSpot e gera o roteiro em formato texto via IA.

Esta operação é síncrona para a geração do roteiro (leva de 5 a 15 segundos). Após a criação, o estado da campanha fica como PENDING aguardando aprovação do roteiro.

Parâmetros:

  • name: Nome identificador da campanha (ex: "Ofertas de Fim de Semana").

  • data: Lista opcional de produtos com preços, ex: [{"product": "Detergente 500ml", "price": "R$ 2,99"}].

  • voice_tone: Tom de voz desejado (ex: "Friendly", "Enthusiastic", "Professional", "Urgent"). Default: "Friendly".

  • slogan: Slogan comercial da loja ou marca (opcional).

  • free_text: Instrução ou texto livre em formato plain text para a IA gerar o comercial (opcional se enviar data).

  • voice_id: ID da voz selecionada (consulte via list_voices) (opcional).

  • background_music: Trilha sonora de fundo (opcional).

  • audio_style: Estilo do áudio ("standard" | "dramatic") (opcional).

  • production_mode: Modo de produção ("standard" | "ai_production") (opcional).

Retorna um JSON com os dados da campanha criada, o ID da campanha (campaign_id ou id) e os roteiros gerados.

Inputs: name (required), data, slogan, voice_id, +5 more. Returns: result

create_recadoA

Gera um áudio instantâneo de recado curto (fast-lane TTS sem fluxo de aprovação HITL).

Ideal para anúncios rápidos de loja, avisos de estacionamento, chamadas de clientes ou recados operacionais. O áudio gerado já inclui vinheta/chime sonora no início.

Parâmetros:

  • text: Texto do recado a ser sintetizado (máximo 300 caracteres).

  • voice_id: ID da voz (opcional).

Retorna um JSON contendo os detalhes do áudio e a URL direta para download/reprodução do MP3.

Inputs: text (required), voice_id. Returns: result

get_campaign_statusA

Consulta o status atual, roteiros e links para os arquivos de áudio de uma campanha específica.

Utilize esta ferramenta para verificar se o áudio de uma campanha já terminou de ser produzido.

Status possíveis:

  • PENDING: Aguardando aprovação do roteiro.

  • PROCESSING: Áudio sendo gerado e mixado em background.

  • COMPLETED: Áudio gerado com sucesso. As URLs dos arquivos MP3 estão disponíveis no campo audios.

  • FAILED: Ocorreu uma falha durante o processamento.

Parâmetros:

  • campaign_id: ID da campanha a ser consultada.

Inputs: campaign_id (required). Returns: result

list_campaignsA

Lista todas as campanhas comerciais pertencentes ao usuário vinculado à API Key M2M.

Retorna uma lista em JSON com o histórico de campanhas, incluindo status e URLs de áudio.

Inputs: no named parameters. Returns: result

list_voicesA

Lista todas as vozes comerciais disponíveis no QuickerSpot para narração e vinhetas.

Utilize esta ferramenta antes de criar uma campanha ou recado para escolher o timbre de voz mais apropriado para o seu produto/anúncio.

Retorna um JSON contendo uma lista de objetos com id, elevenlabs_id e name.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 6 tools

    Disambiguation4/5

    Each tool targets a distinct workflow stage: listing campaigns, creating a campaign, approving scripts, checking status, and direct TTS recados. The two creation tools (create_campaign vs create_recado) could be confused at a glance, but their descriptions clearly separate the full campaign workflow from instant short audio.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern: list_, create_, approve_, get_. The use of 'recado' is a localized noun, but it is still consistent with the naming convention and does not create structural inconsistency.

    Tool Count5/5

    With 6 tools, the server is well-scoped for campaign management and quick audio generation. Each tool covers a necessary step in the workflow without redundancy or bloat.

    Completeness4/5

    The core lifecycle is covered: list voices, create campaign, approve script, check status, and generate instant recados. Minor gaps exist, such as no delete/cancel operation for campaigns and no listing/history of generated recados, but agents can complete primary workflows without dead ends.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers