suprsonic-mcp Server

@suprsonic/mcp

Servidor MCP para Suprsonic. Otorga a cualquier agente de IA docenas de capacidades a través de una sola conexión.

Inicio Rápido

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

Obtén tu clave API en suprsonic.ai/app/apis.

Claude Desktop

Agrega a ~/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

Agrega a .cursor/mcp.json o a la configuración MCP de 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

Luego conéctate a http://localhost:3100/mcp.

Herramientas Disponibles

Herramienta	Qué hace
search	Busca en la web (síntesis de IA, SERP o ambos)
scrape	Extrae contenido de cualquier URL como Markdown
profiles	Encuentra perfiles profesionales por nombre o URL de LinkedIn
emails	Encuentra direcciones de correo electrónico profesionales
images	Genera imágenes a partir de descripciones de texto
tts	Convierte texto a voz
stt	Transcribe audio a texto
sms	Envía mensajes SMS o WhatsApp
documents	Extrae datos estructurados de URLs
companies	Consulta datos de empresas por dominio
email-verify	Verifica si un correo electrónico es entregable
transcribe	Transcribe audio con etiquetas de hablante
invoice-parse	Extrae datos de facturas
subtitle	Genera subtítulos SRT/VTT
file-convert	Convierte archivos entre más de 200 formatos
bg-remove	Elimina fondos de imágenes
screenshot	Captura capturas de pantalla de páginas web

Formato de Respuesta

Cada herramienta devuelve un objeto de respuesta 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
}

En caso de fallo, success es false y error contiene los detalles (ver más abajo).

Manejo de Errores

Estructura del objeto de error (devuelto cuando success es 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"
}

Categorías de error: transient (seguro para reintentar), permanent (solicitud incorrecta), authentication (clave inválida), billing (sin créditos).

Al usar MCP, el agente de IA recibe el error en la respuesta de la herramienta y puede decidir si reintentar basándose en is_retriable y retry_after_seconds.

Referencia completa de la API con todos los parámetros y ejemplos de respuestas: suprsonic.ai/apis