Serveur MCP

prometiam-risk-mcp

Des données d’entreprises pour Claude, Cursor, VS Code et tout client MCP : registres du commerce de 35 pays, événements d’entreprise, avis d’insolvabilité, filtrage des sanctions (bêta), contrôle de TVA et de LEI et surveillance, en 36 outils typés. Une commande, sans clé et sans inscription. L’Allemagne provient des enregistrements LEI et du registre du marché de l’énergie, pas du Handelsregister.

  • Version 0.4.54
  • Outils 36
  • Pays 35
  • Transport stdio
  • Licence MIT
  • Nécessite Node 18 ou plus récent
Copie cette page en Markdown : les blocs d’installation, les outils avec leurs crédits, les erreurs et les limites.

Installez-le, sans clé

Choisissez votre client, collez le bloc et redémarrez-le. Sans clé, le serveur utilise une clé de démonstration partagée : le premier appel répond tout de suite. La recherche d’entreprises, les fiches, la TVA, le LEI et l’insolvabilité fonctionnent ; les événements d’entreprise et le filtrage des sanctions demandent un forfait, et la clé de démonstration est limitée pour tous ceux qui la partagent.

Où: claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\)

Sans clé

{
  "mcpServers": {
    "prometiam-risk": {
      "command": "npx",
      "args": ["-y", "prometiam-risk-mcp"]
    }
  }
}

Avec votre propre clé

{
  "mcpServers": {
    "prometiam-risk": {
      "command": "npx",
      "args": ["-y", "prometiam-risk-mcp"],
      "env": { "PROMETIAM_API_KEY": "rk_live_..." }
    }
  }
}

Votre propre clé vient avec l’essai gratuit de 14 jours : 500 crédits, carte bancaire requise, rien n’est débité pendant 14 jours. Une valeur vide ou le marqueur rk_live_your_key_here est ignoré et la clé de démonstration est utilisée.

Endpoint hébergé (sans installation)

Les mêmes 36 outils sont servis en Streamable HTTP sur https://api.prometiam.com/functions/v1/mcp : pas de npx ni de processus local. Envoyez votre propre clé dans l’en-tête Authorization: Bearer rk_live_... (X-API-Key fonctionne aussi). Sans clé, il fonctionne en mode démo avec la clé de démonstration partagée (30 requêtes par minute et 2 000 appels par jour pour tous, le quota que partage la démo npx) ; en mode démo, certains outils, comme sanctions_screen et events_search, répondent upgrade_required. L’endpoint ne conserve ni données ni secret : chaque appel d’outil est une requête à l’API, facturée en crédits comme l’appel REST (le filtrage des sanctions est en bêta). Votre propre clé ne fonctionne qu’avec un client capable d’envoyer un en-tête de requête.

Claude Code

Où: n’importe quel terminal ; ajoutez --scope project pour écrire un .mcp.json partagé

claude mcp add --transport http prometiam https://api.prometiam.com/functions/v1/mcp --header "Authorization: Bearer rk_live_..."

Cursor

Où: .cursor/mcp.json dans le projet, ou ~/.cursor/mcp.json pour tous les projets

{
  "mcpServers": {
    "prometiam": {
      "url": "https://api.prometiam.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:PROMETIAM_API_KEY}" }
    }
  }
}

VS Code

Où: .vscode/mcp.json (la section racine s’appelle servers, pas mcpServers ; inputs demande la clé d’API et la laisse hors du fichier)

{
  "servers": {
    "prometiam": {
      "type": "http",
      "url": "https://api.prometiam.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:prometiam-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "prometiam-key", "description": "Prometiam API key", "password": true }
  ]
}

Windsurf

Où: mcp_config.json

{
  "mcpServers": {
    "prometiam": {
      "serverUrl": "https://api.prometiam.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:PROMETIAM_API_KEY}" }
    }
  }
}

Connecteurs claude.ai et ChatGPT : pas encore. Ils demandent une connexion OAuth, que l’endpoint hébergé ne propose pas encore.

Vérifiez que cela fonctionne

Demandez à votre assistant :

Cherche les entreprises nommées Inditex en Espagne.

Il appelle companies_search et renvoie :

INDUSTRIA DE DISEÑO TEXTIL, S.A, NIF A15075062, active, forme juridique SA, Arteixo, LEI 549300TTCXZOGZM2EY83.

Un 401 au premier appel signifie une ancienne version de prometiam-risk-mcp qui envoyait le marqueur comme une vraie clé. Mettez-la à jour ou retirez le bloc env.

Dernière vérification dans Claude Desktop, Claude Code, Cursor et VS Code: À confirmer

Posez-lui la question

Des demandes qui fonctionnent, l’outil que chacune appelle et ce qui est revenu. Les réponses enregistrées ont été prises avec la clé de démonstration le 24 oct. 2026, depuis le point d’accès que l’outil enveloppe ; le serveur MCP renvoie le même JSON.

  • “La TVA ESA15075062 est-elle valide, et à quelle entreprise correspond-elle ?”

    Appelle vat_validate, company_by_identifier

    VIES confirme que le numéro est valide. La correspondance au registre est INDUSTRIA DE DISEÑO TEXTIL, S.A (BORME), la même entreprise que ci-dessus.

    Réponse enregistrée
  • “Cherche le LEI 549300TTCXZOGZM2EY83.”

    Appelle lei_lookup

    INDUSTRIA DE DISEÑO TEXTIL, S.A., juridiction ES, statut de l’entité ACTIVE, domiciliée Avenida de la Diputación, Arteixo.

    Réponse enregistrée
  • “Que s’est-il passé dans cette entreprise l’an dernier ?”

    Appelle events_timeline

    La clé de démonstration répond 403 upgrade_required : les événements d’entreprise ne sont pas dans le forfait gratuit, le forfait Starter (9,99 EUR/mois) les inclut.

    Refusée avec la clé de démonstration
  • “Filtre le nom Juan Perez contre les listes de sanctions au seuil 85.”

    Appelle sanctions_screen

    La clé de démonstration répond 403 upgrade_required : le filtrage des sanctions (bêta) n’est pas dans le forfait gratuit, le forfait Professional (29,99 EUR/mois) l’inclut. Un score est un signal à examiner, pas une décision.

    Refusée avec la clé de démonstration
  • “Vérifie si ces cinq contreparties ont des avis d’insolvabilité d’entreprise en France et en Allemagne.”

    Appelle insolvency_check

    Un appel, 2 crédits par nom et un statut par nom. Avis d’entreprises uniquement, seize marchés.

    Non enregistrée ici

Outils, crédits et forfait

Un appel réussi coûte des crédits et une erreur ne coûte rien. Le forfait est le plus bas qui exécute l’outil ; Gratuit est la clé de démonstration et l’essai de 14 jours. Les outils par lot facturent chaque élément.

Company lookup

Trouver une entreprise et lire sa fiche, par nom, identifiant, TVA ou LEI ; jusqu’à 100 à la fois. Les comptes annuels sont réservés au forfait Scale.

OutilCréditsForfait
companies_search1Gratuit
company_detail1Gratuit
company_by_identifier1Gratuit
companies_lookup1 per itemGratuit
company_financials25Scale

People and directors

Dirigeants et personnes aux mandats multiples, là où le registre les publie.

OutilCréditsForfait
people_search2Starter
person_detail2Starter
directors_network2Gratuit

Corporate events

Événements d’une entreprise ou d’un pays entier, avec l’avis d’origine.

OutilCréditsForfait
events_search2Starter
events_timeline2Starter
event_detail2Starter

Insolvency

Avis d’insolvabilité des entreprises dans seize marchés, entreprises uniquement.

OutilCréditsForfait
insolvency_search2Gratuit
insolvency_notices_search2Gratuit
insolvency_check2 per itemGratuit
insolvency_record2Gratuit

Sanctions screening (beta)

Filtrage de noms contre les listes de sanctions et de contrôle des exportations (bêta), et surveillance d’une liste personnelle.

OutilCréditsForfait
sanctions_screen3Professional
sanctions_screen_batch3 per nameProfessional
sanctions_entity1Professional
sanctions_changes1Starter
sanctions_watchmodifie votre compte0Starter
sanctions_unwatchmodifie votre compte0Starter
sanctions_watchlist0Starter

VAT and LEI

Validation de la TVA dans VIES et consultation du LEI et de ses sociétés mères dans GLEIF.

OutilCréditsForfait
vat_validate1Gratuit
lei_lookup1Gratuit
lei_search1Gratuit
lei_relationships1Gratuit

Monitoring

Abonne des entreprises à une surveillance quotidienne avec webhook signé, dans tous les pays ouverts sauf la France et le Chili.

OutilCréditsForfait
monitor_list0Gratuit
monitor_get0Gratuit
monitor_subscribemodifie votre compte0Gratuit
monitor_stopmodifie votre compte0Gratuit

Public procurement (beta)

Attributions de marchés publics et profil de risque des acheteurs publics (bêta).

OutilCréditsForfait
procurement_awards2Gratuit
procurement_buyer2Gratuit
procurement_buyers2Gratuit
procurement_relationship2Gratuit

Account and coverage

Votre forfait, vos crédits et la couverture par pays.

OutilCréditsForfait
coverage0Gratuit
account0Gratuit

Quand un appel échoue

401 unauthorizedLa clé est absente, erronée ou révoquée. Avec le serveur MCP, laissez la clé de côté pour utiliser la clé de démonstration.
403 upgrade_requiredL’appel demande un forfait qui l’inclut ; le corps indique le forfait et le prix.
429 rate_limit_exceededLimite par minute ou par jour ; attendez les secondes de Retry-After. La clé de démonstration partagée est limitée pour tous ceux qui l’utilisent.

Serveur MCP ou API REST

Serveur MCP ou API RESTServeur MCPAPI REST
Qui appelleLe client IA choisit l’outil et ses paramètres pendant une conversation.Votre code, avec les paramètres que vous fixez.
IdentifiantsPROMETIAM_API_KEY facultative dans la configuration du client.Un en-tête Authorization: Bearer sur chaque requête.
Données et créditsLes mêmes points d’accès, le même JSON et les mêmes crédits par appel.Idem.
Idéal pourRecherche et vigilance dans un chat, prototypes, agents qui décident quoi consulter.Parcours d’entrée en relation, traitements par lot, webhooks de surveillance, tout ce qui doit s’exécuter toujours de la même façon.

La référence REST se trouve dans la documentation de l’API.

Limites de périmètre

  • Le filtrage des sanctions est en bêta. Le filtrage PPE (une option de sanctions_screen) est en bêta, limité à l’Espagne et sans proches ni associés.
  • Les avis d’insolvabilité concernent uniquement les entreprises, dans seize marchés : FR, DE, GB, AT, CH, NO, FI, US, NL, DK, HR, SE, ES, LV et EE. Contains CVR data (Erhvervsstyrelsen), CC BY 4.0.
  • La surveillance couvre tous les pays ouverts sauf la France et le Chili : changement de statut, dissolution, correspondance de sanctions et événements d’entreprise. Seuls monitor_subscribe, monitor_stop, sanctions_watch et sanctions_unwatch modifient quelque chose dans votre compte ; les autres outils sont en lecture seule.
  • Les dirigeants viennent d’Espagne, de France, du Royaume-Uni et de Norvège ; ceux de Pologne figurent sur la fiche de l’entreprise, les personnes physiques étant masquées par le registre lui-même. Les autres pays ne proposent que des fiches d’entreprise : ni dirigeants ni signal de conformité au registre. Les entrepreneurs individuels et autres personnes physiques ne sont pas servis dans la plupart des registres.
  • Les événements sont des avis de journaux officiels pour l’Espagne, la France et le Royaume-Uni (la Suisse aussi depuis la Feuille officielle suisse du commerce) et des événements de modification du registre pour les autres pays ouverts, datés du jour où la modification apparaît dans les données du registre. Irlande, Pologne et Norvège : événements de modification du registre uniquement, aucun avant le 14 oct. 2026.
  • L’Allemagne, ce sont des entités dotées d’un LEI et des entreprises du registre du marché de l’énergie, pas un extrait du Handelsregister. Les États-Unis ne proposent que des fiches d’entreprise : huit registres d’État plus des déclarants de la SEC et des titulaires de LEI, pas toutes les entreprises américaines.
  • Les comptes annuels (company_financials) sont des comptes déposés pour GB, FR, DK, SE, NO, LV, FI (dépôt numérique), EE, RO et LT (chiffres principaux), CO et US (déclarants de la SEC), plus les sociétés cotées en ES, PL, HR, BE et BR ; forfait Scale et supérieur, 10 appels par mois sur les forfaits inférieurs.

Questions fréquentes

Le serveur fonctionne-t-il sans clé d’API ?
Oui. Il embarque une clé de démonstration partagée : le premier appel répond juste après npx. La clé est limitée pour tous ceux qui la partagent ; quand le quota partagé est épuisé, l’erreur indique comment obtenir une clé gratuite.

Que m’apporte ma propre clé ?
Une clé personnelle n’est partagée avec personne et débloque les droits payants : personnes et événements dès Starter (9,99 EUR/mois), filtrage des sanctions dès Professional (29,99 EUR/mois), comptes annuels dès Scale (99,99 EUR/mois). L’essai gratuit de 14 jours donne 500 crédits, la carte est requise et rien n’est débité pendant 14 jours.

Avec quels clients cela fonctionne-t-il ?
Tout client qui parle MCP par stdio. Claude Desktop, Claude Code, Cursor et VS Code sont configurés ci-dessus ; Continue et Cline fonctionnent de la même façon.

L’agent peut-il modifier quelque chose dans mon compte ?
Seulement par monitor_subscribe, monitor_stop, sanctions_watch et sanctions_unwatch, signalés comme modifiant votre compte ; tous les autres outils sont en lecture seule. Gardez la clé dans la configuration du client, jamais dans un prompt.

Un appel d’outil compte-t-il dans mon quota ?
Oui. Un appel réussi coûte des crédits : 1 pour une recherche ou une fiche d’entreprise, 2 pour les personnes, les événements ou l’insolvabilité, 3 par nom filtré, 25 pour les comptes annuels d’une entreprise ; les erreurs ne coûtent rien. Les outils par lot facturent chaque élément.

Ce sont les mêmes données que l’API REST ?
Oui. Chaque outil appelle le même point d’accès que décrivent la documentation de l’API et la spécification OpenAPI.

Pourquoi mon client affiche-t-il une erreur 401 ?
Un prometiam-risk-mcp antérieur à la 0.4.45 lit le marqueur rk_live_your_key_here comme une vraie clé. Mettez-le à jour, ou retirez le bloc env pour utiliser la clé de démonstration.

À lire aussi

Cette page décrit prometiam-risk-mcp 0.4.54. Le même texte en Markdown : /mcp.md