Skip to content
Docs Insourcia

Tools RPC (/v1/rpc/tools)

L’API Tools RPC est une surface alternative à REST /v1, pensée pour les agents IA et les outils d’automation.

Au lieu d’un endpoint par ressource, tout passe par POST /v1/rpc/tools/{name} avec le payload dans le body. Même catalogue de tools que le serveur MCP, exposé en REST standard.

Pourquoi cette surface

Section titled “Pourquoi cette surface”
  • Custom GPTs (ChatGPT) consomment de l’OpenAPI — pas du MCP
  • n8n / Zapier / Make ont un node “HTTP request” générique mais pas de support MCP
  • OpenAI Assistants / function calling mappent une opération OpenAPI à une function

C’est un pattern REST-RPC hybride éprouvé.

Quick start

Section titled “Quick start”

1. Lister les tools disponibles

Section titled “1. Lister les tools disponibles”
Terminal window
curl https://api.insourcia.io/v1/rpc/tools \
  -H "Authorization: Bearer isk_xxx"

Réponse :

{
  "tools": [
    {
      "name": "search_companies",
      "description": "Recherche d'entreprises françaises par nom, SIREN, activité...",
      "inputSchema": { "type": "object", "properties": { "query": {...} }, ... }
    },
    ...
  ]
}

2. Invoquer un tool

Section titled “2. Invoquer un tool”
Terminal window
curl -X POST https://api.insourcia.io/v1/rpc/tools/search_companies \
  -H "Authorization: Bearer isk_xxx" \
  -H "Content-Type: application/json" \
  -d '{"query":"vinci","limit":3}'

Réponse (envelope JSend) :

{
  "success": true,
  "data": {
    "data": [
      { "siren": "552120222", "denomination": "VINCI", ... }
    ],
    "pagination": { "total": 1, "limit": 3, "has_more": false }
  }
}

Erreur :

{
  "success": false,
  "error": "Invalid input",
  "details": [{ "path": ["query"], "message": "Required" }]
}

Tools disponibles

Section titled “Tools disponibles”

17 outils, identiques sur le serveur MCP et sur la surface Tools RPC. Référence interactive avec try-it-now sur /docs/tools.

Découverte

Tool Action Détail
search_companies Recherche d'entreprises Filtres par secteur, géographie, taille, dirigeant, agrégats financiers (CA, EBE, dette, trésorerie) et présence d'un fonds au capital. Composés en langage naturel.
search_directors Recherche de dirigeants Retrouve une personne physique par son nom de famille à travers toutes les entreprises françaises.
search_director_companies Empreinte d'un dirigeant Toutes les sociétés où une personne détient un mandat direct, désambiguïsée par nom, prénom et date de naissance.

Profil

Tool Action Détail
get_company Fiche société Identité, activité, effectifs, dirigeants, bénéficiaires effectifs, immatriculation, codes NAF.
get_directors Dirigeants & mandats Dirigeants d'une société, leur rôle et la structure hiérarchique des mandats.
get_company_graph Cartographie de groupe Graphe orienté des entités autour d'une société : holdings, filiales, sociétés sœurs, dirigeants communs.

Finance

Tool Action Détail
get_financials Bilans & comptes annuels Compte de résultat, bilan, ratios (trésorerie, dette nette, BFR, marges, délais de paiement), dividendes versés, sur plusieurs exercices consécutifs.
get_credit_risk Score de risque crédit Grade de AAA à D, probabilité de défaut à 3, 6 et 12 mois, et les cinq principaux facteurs aggravants ou atténuants. Plan Pro.

Veille légale

Tool Action Détail
search_events Recherche d'événements Événements toutes sociétés confondues : cessions de fonds, procédures collectives, dépôts de comptes, augmentations de capital, marchés publics, subventions, radiations, créations.
get_events Timeline d'une société Tous les événements d'une société donnée, classés dans le temps.

Surveillance

Tool Action Détail
create_saved_search Recherche sauvegardée Enregistre des critères pour suivre un secteur ou un portefeuille de sociétés dans le temps, avec alerte.
list_saved_searches Mes recherches sauvegardées Les recherches suivies par votre compte, telles qu'elles apparaissent dans l'app.
watch_company Mise sous surveillance Ajoute une société à une liste de veille : ses nouveaux événements remontent ensuite dans l'app.
list_watched_companies Mes sociétés surveillées Les sociétés déjà sous surveillance dans vos listes de veille.
unwatch_company Retirer de la surveillance Retire une société d'une liste de veille : ses événements cessent de remonter.
get_news Fil de veille Ce qui a bougé sur vos sociétés surveillées : changements de dirigeants, procédures collectives, cessions, radiations, les plus récents d'abord. Filtrable sur les signaux non lus.
mark_news_read Signaux traités Marque comme lus les signaux du fil de veille que vous avez traités, pour que la prochaine lecture ne les remonte plus.

OpenAPI 3.1

Section titled “OpenAPI 3.1”

Spec téléchargeable et standards-compliant :

https://api.insourcia.io/v1/rpc/tools/openapi.json

Importable dans Postman, n8n, Custom GPT Actions, Insomnia, etc.

Authentification

Section titled “Authentification”

Bearer token, identique à REST :

Authorization: Bearer isk_xxx

Rate limits & gating

Section titled “Rate limits & gating”

Mêmes règles que /v1 : rate limit par clé API + plan-gating sur les champs premium. Le passage par Tools RPC ne contourne rien.