suprsonic-mcp

suprsonic-mcp

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

Démarrage rapide

Connectez-vous au serveur hébergé, sans rien installer :

• URL : https://suprsonic.ai/v1/mcp (Streamable HTTP)
• En-tête : Authorization: Bearer omk_your_key (ou x-api-key: omk_your_key, pour un client ou une passerelle qui conserve Authorization pour sa propre authentification)

Ou exécutez le serveur sur votre propre machine :

SUPRSONIC_API_KEY=omk_your_key npx -y suprsonic-mcp

Obtenez votre clé API sur suprsonic.ai/app/api. Les deux options proposent les mêmes outils aux mêmes tarifs. Il n’est pas nécessaire d’avoir une clé pour afficher la liste des outils ; sans clé valide, un appel renvoie l’erreur propre à l’API, qui indique où en obtenir une.

Le package est suprsonic-mcp. Les versions précédentes de ce README indiquaient @suprsonic/mcp : ce scope npm appartient à une entreprise sans lien avec ce projet, ne l’installez donc jamais.

Serveur hébergé

Claude Code

claude mcp add --transport http suprsonic https://suprsonic.ai/v1/mcp --header "Authorization: Bearer omk_your_key"

Cursor

Ajoutez-le à ~/.cursor/mcp.json (ou à .cursor/mcp.json dans un projet) :

{
  "mcpServers": {
    "suprsonic": {
      "url": "https://suprsonic.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer omk_your_key"
      }
    }
  }
}

VS Code

Ajoutez-le à .vscode/mcp.json (VS Code vous demande la clé une seule fois et l’enregistre comme secret) :

{
  "inputs": [
    { "type": "promptString", "id": "suprsonic-key", "description": "Suprsonic API key (omk_...)", "password": true }
  ],
  "servers": {
    "suprsonic": {
      "type": "http",
      "url": "https://suprsonic.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:suprsonic-key}"
      }
    }
  }
}

Claude API (connecteur MCP)

Envoyez l’en-tête bêta anthropic-beta: mcp-client-2025-11-20 et ajoutez-le à votre requête Messages :

{
  "mcp_servers": [
    { "type": "url", "url": "https://suprsonic.ai/v1/mcp", "name": "suprsonic", "authorization_token": "omk_your_key" }
  ],
  "tools": [
    { "type": "mcp_toolset", "mcp_server_name": "suprsonic" }
  ]
}

OpenAI Responses API

Ajoutez-le à tools de la requête :

{
  "type": "mcp",
  "server_label": "suprsonic",
  "server_url": "https://suprsonic.ai/v1/mcp",
  "authorization": "omk_your_key",
  "require_approval": "never"
}

Smithery

Suprsonic est répertorié sur Smithery sous le nom suprsonic. Ajoutez-le à votre boîte à outils Smithery et collez votre clé lorsque Smithery vous la demande ; Smithery la transmet au serveur hébergé sous la forme x-api-key.

Serveur local (npx)

Claude Desktop

Ajoutez-le à ~/Library/Application Support/Claude/claude_desktop_config.json :

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

La même entrée fonctionne dans mcp.json de Cursor.

Votre propre point de terminaison HTTP

Pour servir le transport HTTP depuis votre propre machine au lieu d’utiliser le serveur hébergé :

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

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

Outils disponibles

Un appel ne coûte des crédits qu’en cas de réussite. Lorsqu’une plage est indiquée, le mode choisi détermine le prix.

Outil	Fonction	Crédits
search	Effectuer une recherche sur le Web avec SERP, synthèse par IA ou les deux	1-3
scrape	Extraire le contenu de n’importe quelle URL au format Markdown ou HTML	1-5
profiles	Trouver et enrichir des profils professionnels	3
emails	Trouver des adresses e-mail professionnelles	2
images	Générer des images à partir de prompts textuels	3
tts	Convertir du texte en audio parlé	2
stt	Transcrire de l’audio en texte avec horodatages	2
sound-generate	Générer des effets sonores et de courts morceaux de musique à partir de prompts textuels (PAS de parole : utilisez tts pour une voix parlée)	4
sms	Envoyer des SMS ou des messages WhatsApp. Le canal par défaut est le SMS (livraison fiable). WhatsApp nécessite le consentement préalable du destinataire : celui-ci doit avoir envoyé un message à votre numéro Business au cours des dernières 24 heures.	1
documents	Extraire des données structurées à partir d’URL ou de contenu	3
companies	Enrichir les données d’entreprise à partir d’un domaine	3
email-verify	Vérifier si une adresse e-mail est distribuable, catch-all ou jetable	1
transcribe	Transcrire de l’audio avec diarisation des locuteurs et horodatages	3
invoice-parse	Extraire des données structurées de factures et de reçus	3
subtitle	Générer des sous-titres SRT/VTT à partir d’audio ou de vidéo	2
file-convert	Convertir des documents, pages Web, feuilles de calcul et images entre différents formats	2
bg-remove	Supprimer l’arrière-plan de n’importe quelle image. Renvoie un PNG transparent.	2
screenshot	Capturer une capture d’écran rendue de n’importe quelle page Web	1
code-execute	Exécuter du code dans un bac à sable sécurisé avec des environnements préconfigurés	2
site-intel	Obtenir des renseignements complets sur un domaine : WHOIS, DNS, SSL, pile technologique, sécurité des e-mails, hébergement	1-2
research	Recherche approfondie en plusieurs étapes : rechercher, extraire, enrichir les entités et synthétiser le tout dans un rapport avec citations	10-35
video-info	Extraire les métadonnées vidéo, les formats disponibles et la miniature de n’importe quelle URL	1
video-download	Télécharger une vidéo depuis n’importe quelle URL et renvoyer un lien de téléchargement temporaire	2-3
domains	Trouver des noms de domaine et les extensions adaptées à une entreprise	1-5

Format de réponse

Chaque outil renvoie 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 vaut false et error contient les détails (voir ci-dessous).

Gestion des erreurs

Toutes les erreurs ont le même format d’objet. Une fonctionnalité qui échoue renvoie cet objet sous la forme error dans la réponse ci-dessus, avec success défini sur false et sans facturer de crédits. Un appel refusé (clé invalide, crédits insuffisants, limite de débit atteinte) renvoie une réponse HTTP 401, 402 ou 429 avec l’objet sous detail :

{
  "detail": {
    "type": "https://api.o-mega.ai/errors/insufficient-credits",
    "title": "Insufficient Suprsonic API credits",
    "status": 402,
    "detail": "This call needs 2 credits and your Suprsonic account has 0 left of its 200 free credits a month, which refill on November 12. This is your Suprsonic credit balance, not a provider's.",
    "is_retriable": false,
    "error_category": "billing",
    "alternative_action": "Pro gives 2,000 credits a month, 10 times the free plan: choose it at https://suprsonic.ai/app/subscription, or wait until November 12."
  }
}

Catégories d’erreurs : transient (nouvelle tentative sans risque), permanent (requête incorrecte), authentication (clé invalide), billing (crédits épuisés), content_access (cette URL ne peut pas être traitée : bloquée, soumise à une restriction régionale ou privée).

Avec MCP, l’agent IA reçoit l’objet d’erreur complet dans la réponse de l’outil. Il peut ainsi décider de réessayer en fonction de is_retriable et retry_after_seconds, et vous indiquer ce que alternative_action recommande de faire.

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