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
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_..." }
}
}
}Où: any terminal; add --scope project to write a shared .mcp.json
Sans clé
claude mcp add prometiam-risk -- npx -y prometiam-risk-mcpAvec votre propre clé
claude mcp add prometiam-risk -e PROMETIAM_API_KEY=rk_live_... -- npx -y prometiam-risk-mcpOù: .cursor/mcp.json in the project, or ~/.cursor/mcp.json for every project
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_..." }
}
}
}Où: .vscode/mcp.json (the key is servers, not mcpServers)
Sans clé
{
"servers": {
"prometiam-risk": {
"type": "stdio",
"command": "npx",
"args": ["-y", "prometiam-risk-mcp"]
}
}
}Avec votre propre clé
{
"servers": {
"prometiam-risk": {
"type": "stdio",
"command": "npx",
"args": ["-y", "prometiam-risk-mcp"],
"env": { "PROMETIAM_API_KEY": "rk_live_..." }
}
}
}Où: Continue, Cline ou votre propre agent : lancez la commande et parlez MCP sur l’entrée et la sortie standard. Consultez la documentation MCP de votre client pour le nom exact du fichier de configuration, qui change selon les versions.
Sans clé
npx -y prometiam-risk-mcpAvec votre propre clé
PROMETIAM_API_KEY=rk_live_... npx -y prometiam-risk-mcpVotre 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 ?”
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.”
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 ?”
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.”
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.”
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.
| Outil | Crédits | Forfait |
|---|---|---|
companies_search | 1 | Gratuit |
company_detail | 1 | Gratuit |
company_by_identifier | 1 | Gratuit |
companies_lookup | 1 per item | Gratuit |
company_financials | 25 | Scale |
People and directors
Dirigeants et personnes aux mandats multiples, là où le registre les publie.
| Outil | Crédits | Forfait |
|---|---|---|
people_search | 2 | Starter |
person_detail | 2 | Starter |
directors_network | 2 | Gratuit |
Corporate events
Événements d’une entreprise ou d’un pays entier, avec l’avis d’origine.
| Outil | Crédits | Forfait |
|---|---|---|
events_search | 2 | Starter |
events_timeline | 2 | Starter |
event_detail | 2 | Starter |
Insolvency
Avis d’insolvabilité des entreprises dans seize marchés, entreprises uniquement.
| Outil | Crédits | Forfait |
|---|---|---|
insolvency_search | 2 | Gratuit |
insolvency_notices_search | 2 | Gratuit |
insolvency_check | 2 per item | Gratuit |
insolvency_record | 2 | Gratuit |
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.
| Outil | Crédits | Forfait |
|---|---|---|
sanctions_screen | 3 | Professional |
sanctions_screen_batch | 3 per name | Professional |
sanctions_entity | 1 | Professional |
sanctions_changes | 1 | Starter |
sanctions_watchmodifie votre compte | 0 | Starter |
sanctions_unwatchmodifie votre compte | 0 | Starter |
sanctions_watchlist | 0 | Starter |
VAT and LEI
Validation de la TVA dans VIES et consultation du LEI et de ses sociétés mères dans GLEIF.
| Outil | Crédits | Forfait |
|---|---|---|
vat_validate | 1 | Gratuit |
lei_lookup | 1 | Gratuit |
lei_search | 1 | Gratuit |
lei_relationships | 1 | Gratuit |
Monitoring
Abonne des entreprises à une surveillance quotidienne avec webhook signé, dans tous les pays ouverts sauf la France et le Chili.
| Outil | Crédits | Forfait |
|---|---|---|
monitor_list | 0 | Gratuit |
monitor_get | 0 | Gratuit |
monitor_subscribemodifie votre compte | 0 | Gratuit |
monitor_stopmodifie votre compte | 0 | Gratuit |
Public procurement (beta)
Attributions de marchés publics et profil de risque des acheteurs publics (bêta).
| Outil | Crédits | Forfait |
|---|---|---|
procurement_awards | 2 | Gratuit |
procurement_buyer | 2 | Gratuit |
procurement_buyers | 2 | Gratuit |
procurement_relationship | 2 | Gratuit |
Account and coverage
Votre forfait, vos crédits et la couverture par pays.
| Outil | Crédits | Forfait |
|---|---|---|
coverage | 0 | Gratuit |
account | 0 | Gratuit |
Quand un appel échoue
401 unauthorized | La 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_required | L’appel demande un forfait qui l’inclut ; le corps indique le forfait et le prix. |
429 rate_limit_exceeded | Limite 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 REST | Serveur MCP | API REST |
|---|---|---|
| Qui appelle | Le client IA choisit l’outil et ses paramètres pendant une conversation. | Votre code, avec les paramètres que vous fixez. |
| Identifiants | PROMETIAM_API_KEY facultative dans la configuration du client. | Un en-tête Authorization: Bearer sur chaque requête. |
| Données et crédits | Les mêmes points d’accès, le même JSON et les mêmes crédits par appel. | Idem. |
| Idéal pour | Recherche 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
- Pourquoi un agent IA a besoin de données officielles d’entreprises: en anglais
- Intégrations: n8n, Postman et les SDK TypeScript et Python
- Documentation de l’API: en anglais
- Tarifs
Cette page décrit prometiam-risk-mcp 0.4.54. Le même texte en Markdown : /mcp.md