Outils Ofrr.io : MCP, API et CLI

Un registre unique expose les mêmes actions Ofrr.io aux agents, à l’API et à la CLI.

Ofrr.io déclare chaque capacité une seule fois puis l’expose par trois interfaces : MCP, API REST et CLI. Le schéma d’entrée, la logique métier, les permissions et la trace d’audit restent donc identiques quelle que soit la surface.

Capacités disponibles

Outil	Usage
`search_proposals`	Rechercher une offre ou un client
`get_proposal`	Lire l’état structuré d’une offre
`get_proposal_history`	Lire ses versions et ses événements
`explain_price`	Expliquer le prix recommandé
`get_skill`	Charger un playbook agent canonique
`create_proposal_from_brief`	Créer un brouillon depuis un pitch
`update_proposal`	Modifier un brouillon autorisé
`recalculate_proposal`	Recalculer cadrage et prix
`create_proposal_version`	Créer une V2 depuis une offre existante
`publish_proposal`	Publier un instantané immuable
`set_proposal_status`	Enregistrer envoyée, acceptée, refusée ou expirée
`record_proposal_event`	Tracer une action externe vérifiable
`trash_proposal`	Placer une offre dans la corbeille récupérable
`restore_proposal`	Restaurer une offre

Autorisation

Le serveur MCP utilise OAuth et présente une liste d’autorisations granulaires au premier branchement. Une clé d’API d’organisation peut aussi être utilisée pour un script ou la CLI. Dans les deux cas, Ofrr.io résout l’organisation depuis le justificatif : aucun identifiant d’organisation n’est accepté dans le contenu libre d’un appel.

Chaque outil exige la permission précise qui lui correspond. Une permission de lecture ne permet pas une modification et la permission de modifier un brouillon ne permet pas de publier.

MCP

Le point d’entrée distant est :

https://ofrr.io/api/mcp

Il accepte Streamable HTTP et annonce automatiquement le parcours OAuth quand aucun justificatif n’est présent.

Ses instructions annoncent les playbooks create_offer et defend_offer. L’agent charge le playbook utile avec get_skill avant d’orchestrer les outils d’offre.

API REST

Découverte :

GET /api/v1/tools
GET /api/v1/tools/:name
GET /api/v1/skills
GET /api/v1/skills/:name

Exécution :

POST /api/v1/tools/:name
Authorization: Bearer VOTRE_CLE_OU_JETON
Content-Type: application/json

Exemple :

curl https://ofrr.io/api/v1/tools/search_proposals \
  -H "Authorization: Bearer VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"query":"Acme"}'

CLI

Dans un checkout Ofrr.io :

export OFRR_API_KEY="VOTRE_CLE"
pnpm tools list
pnpm tools run search_proposals '{"query":"Acme"}'

La CLI ajoute automatiquement la source cli à la trace de l’action.

Playbook MCP et skill natif

Le registre Ofrr.io est la source canonique des deux formes :

le playbook MCP est retourné par get_skill et fonctionne depuis tout client compatible ;
le skill natif est le même contenu rendu en SKILL.md pour les agents qui savent installer des skills locaux.

Cette distinction évite de promettre une installation automatique sur les surfaces qui ne la proposent pas. Consultez le guide universel Agents IA pour choisir la procédure adaptée.

Garanties commerciales

Une publication crée un instantané immuable.
Une modification commerciale après publication exige une V2.
Placer dans la corbeille reste récupérable.
Un agent ne peut marquer une offre comme envoyée après une action externe qu’en fournissant la référence de cette action.
Les mises à jour de statut et les mutations conservent leur provenance : interface, Assistant, API, MCP ou CLI.