suprsonic-mcp Server

@suprsonic/mcp

Servidor MCP para Suprsonic. Oferece a qualquer agente de IA dezenas de funcionalidades através de uma única conexão.

Início Rápido

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

Obtenha sua chave de API em suprsonic.ai/app/apis.

Claude Desktop

Adicione ao ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "suprsonic": {
      "command": "npx",
      "args": ["-y", "@suprsonic/mcp"],
      "env": {
        "SUPRSONIC_API_KEY": "omk_your_key"
      }
    }
  }
}

Cursor / VS Code

Adicione ao .cursor/mcp.json ou à configuração MCP do VS Code:

{
  "suprsonic": {
    "command": "npx",
    "args": ["-y", "@suprsonic/mcp"],
    "env": {
      "SUPRSONIC_API_KEY": "omk_your_key"
    }
  }
}

HTTP Remoto (para Claude API, ChatGPT, agentes programáticos)

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp --http --port 3100

Em seguida, conecte-se a http://localhost:3100/mcp.

Ferramentas Disponíveis

Ferramenta	O que faz
search	Pesquisa na web (síntese de IA, SERP ou ambos)
scrape	Extrai conteúdo de qualquer URL como Markdown
profiles	Encontra perfis profissionais por nome ou URL do LinkedIn
emails	Encontra endereços de e-mail profissionais
images	Gera imagens a partir de prompts de texto
tts	Converte texto em fala
stt	Transcreve áudio para texto
sms	Envia mensagens SMS ou WhatsApp
documents	Extrai dados estruturados de URLs
companies	Consulta dados de empresas por domínio
email-verify	Verifica se um e-mail é entregável
transcribe	Transcreve áudio com identificação de locutores
invoice-parse	Extrai dados de faturas
subtitle	Gera legendas SRT/VTT
file-convert	Converte arquivos entre mais de 200 formatos
bg-remove	Remove fundos de imagens
screenshot	Captura capturas de tela de páginas web

Formato de Resposta

Toda ferramenta retorna um objeto de resposta unificado:

{
  "success": true,
  "data": {
    "results": [
      { "title": "OpenAI raises $6.6B", "url": "https://...", "snippet": "..." }
    ]
  },
  "error": null,
  "metadata": {
    "provider_used": "serperdev",
    "providers_tried": ["serperdev"],
    "response_time_ms": 1200,
    "request_id": "req_abc123"
  },
  "credits_used": 1
}

Em caso de falha, success é false e error contém os detalhes (veja abaixo).

Tratamento de Erros

Estrutura do objeto de erro (retornado quando success é false):

{
  "type": "billing_error",
  "title": "Insufficient credits",
  "status": 402,
  "detail": "Your account has 0 credits remaining. Add credits at suprsonic.ai/app/billing.",
  "is_retriable": false,
  "retry_after_seconds": null,
  "error_category": "billing"
}

Categorias de erro: transient (seguro para repetir), permanent (requisição inválida), authentication (chave inválida), billing (sem créditos).

Ao usar MCP, o agente de IA recebe o erro na resposta da ferramenta e pode decidir se deve tentar novamente com base em is_retriable e retry_after_seconds.

Referência completa da API com todos os parâmetros e exemplos de resposta: suprsonic.ai/apis