mcpField
Q
QuickerSpot MCP Server

QuickerSpot MCP Server

Local
quickerspot.comMedia & Design0Updated 8w ago
RepositoryVisit website

About QuickerSpot MCP Server

QuickerSpot MCP Server exposes QuickerSpot's commercial audio production capabilities to AI assistants, for indoor radio, commercial voiceovers, and promotional audio. It supports AI script generation, voice synthesis, and background-music mixing.

Key features

  1. 01Browse commercial voice options
  2. 02Create campaigns and generate scripts
  3. 03Approve scripts and synthesize voice audio
  4. 04Replace background music and remix audio
  5. 05Check campaign status and MP3 links
  6. 06Generate instant in-store announcements

Use cases

  1. 01Produce audio for commercial campaigns
  2. 02Create indoor radio spots and announcements
  3. 03Add or replace background music in voice audio

MCP support

The MCP server provides AI clients with QuickerSpot tools for campaigns, voice synthesis, and audio mixing. An API key is required to connect.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "raphaelinacio-quickerspot": {
      "command": "uvx",
      "args": [
        "quickerspot-mcp"
      ],
      "env": {
        "QUICKERSPOT_API_KEY": "<QUICKERSPOT_API_KEY>",
        "QUICKERSPOT_API_URL": "<QUICKERSPOT_API_URL>"
      }
    }
  }
}
Run commanduvx quickerspot-mcp
Environment variables to set
QUICKERSPOT_API_KEYSecretAPI Key M2M gerada no painel do QuickerSpot (/settings)
QUICKERSPOT_API_URLURL do backend do QuickerSpot em produção

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiquickerspot-mcp0.1.7

Tools

6

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

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.

🛠️ 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"
      }
    }
  }
}

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.