suprsonic-mcp Server

@suprsonic/mcp

Serveur MCP pour Suprsonic. Offre à tout agent IA des dizaines de capacités via une seule connexion.

Démarrage rapide

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

Obtenez votre clé API sur suprsonic.ai/app/apis.

Claude Desktop

Ajoutez à ~/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

Ajoutez à .cursor/mcp.json ou à la configuration MCP de VS Code :

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

HTTP distant (pour Claude API, ChatGPT, agents programmatiques)

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

Connectez-vous ensuite à http://localhost:3100/mcp.

Outils disponibles

Outil	Ce qu'il fait
search	Rechercher sur le web (synthèse IA, SERP, ou les deux)
scrape	Extraire le contenu de n'importe quelle URL en Markdown
profiles	Trouver des profils professionnels par nom ou URL LinkedIn
emails	Trouver des adresses email professionnelles
images	Générer des images à partir de descriptions textuelles
tts	Convertir du texte en parole
stt	Transcrire de l'audio en texte
sms	Envoyer des SMS ou des messages WhatsApp
documents	Extraire des données structurées depuis des URLs
companies	Rechercher des données d'entreprise par domaine
email-verify	Vérifier si un email est distribuable
transcribe	Transcrire de l'audio avec étiquettes de locuteur
invoice-parse	Extraire des données de factures
subtitle	Générer des sous-titres SRT/VTT
file-convert	Convertir des fichiers entre plus de 200 formats
bg-remove	Supprimer l'arrière-plan des images
screenshot	Capturer des captures d'écran de pages web

Format de réponse

Chaque outil retourne un objet de réponse unifié :

{
  "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 cas d'échec, success est false et error contient les détails (voir ci-dessous).

Gestion des erreurs

Structure de l'objet d'erreur (retourné lorsque success est 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"
}

Catégories d'erreur : transient (réessayer sans risque), permanent (mauvaise requête), authentication (clé invalide), billing (crédits épuisés).

Lors de l'utilisation de MCP, l'agent IA reçoit l'erreur dans la réponse de l'outil et peut décider de réessayer en fonction de is_retriable et retry_after_seconds.

Référence API complète avec tous les paramètres et exemples de réponses : suprsonic.ai/apis