quickerspot-mcp
This server provides MCP tools to create and manage AI-generated commercial audio campaigns and short voice messages using QuickerSpot.
list_voices: Lists available commercial voices (with id, elevenlabs_id, name).
create_campaign: Creates a commercial campaign, generating a script via AI (tone, slogan, free text, voice, background music, production mode).
approve_script: Approves or edits a campaign script and triggers background audio production (TTS + mixing).
get_campaign_status: Checks campaign status (PENDING, PROCESSING, COMPLETED, FAILED) and retrieves MP3 URLs.
list_campaigns: Lists all campaigns belonging to the user's API key.
create_recado: Generates an instant short audio message (up to 300 chars) with jingle/chime, no approval flow.
Provides access to the ElevenLabs V3 voice engine for generating and managing commercial voice-over audio, including voice selection and TTS production.
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)
list_voices()— Retorna o catálogo de vozes comerciais disponíveis (Camila, Helena, Marcos, Carlos, Ricardo).create_campaign(name, data, voice_tone, free_text)— Cria uma nova campanha comercial e gera o roteiro síncrono via IA.approve_script(campaign_id, script, background_music)— Aprova o roteiro e dispara a síntese de voz pura em estúdio.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).get_campaign_status(campaign_id)— Consulta o status (PENDING,PROCESSING,COMPLETED), roteiro e URLs de download dos MP3s.list_campaigns()— Lista todas as campanhas ativas da sua conta.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 toolsapprove_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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
The OpenRouter MCP server plugs OpenRouter into the AI tools you already use. Once connected, your assistant can pull live OpenRouter data (models, prices, your credits, rankings, and docs) and send quick test messages, all without leaving your editor.
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Related MCP Servers
- AlicenseAqualityDmaintenanceA simple MCP server for interacting with OpenAI assistants. This server allows other tools (like Claude Desktop) to create and interact with OpenAI assistants through the Model Context Protocol.939MIT

ElevenLabs MCP Serverofficial
AlicenseBqualityFmaintenanceAn official Model Context Protocol (MCP) server that enables AI clients to interact with ElevenLabs' Text to Speech and audio processing APIs, allowing for speech generation, voice cloning, audio transcription, and other audio-related tasks.271,558MIT- AlicenseAqualityDmaintenanceOfficial AllVoiceLab Model Context Protocol (MCP) server, supporting interaction with powerful text-to-speech and video translation APIs.1262MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI assistants like Claude Desktop to interact with Spotify's music streaming service, supporting playback control, playlist management, music search, and user profile access.412MIT