Skip to main content
Glama
raphaelInacio

quickerspot-mcp

by raphaelInacio
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
QUICKERSPOT_API_KEYYesYour QuickerSpot API key. Create one at https://quickerspot.com/settings
QUICKERSPOT_API_URLNoOptional base URL for the QuickerSpot API. Use http://localhost:8000 for local development.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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.

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.

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.

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.

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.

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.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

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

ActivityMaintained
ResponsivenessNo issues

Resources