ActionsBricksMurmurez à l'oreille des IA

Model Context Protocol (MCP) sur ActionsBricks

Le MCP est un protocole ouvert introduit par Anthropic (nov. 2024) qui permet à un agent IA de découvrir et d'invoquer des outils distants de façon standardisée. ActionsBricks expose un serveur MCP public regroupant 22 tools (19 cœur + 3 sectoriels) pour la découverte, la résolution, le contact et la vérification des commerces locaux.

/.well-known/mcp.json API REST complémentaire Tous les protocoles

Connexion

Endpoint: https://actionsbricks.com/api/mcp/
Transport: streamable-http
Manifest: https://actionsbricks.com/.well-known/mcp.json
Tools exposés: 22 (19 cœur + 3 plugins sectoriels)

Le manifest machine-readable est maintenu en parfaite synchronisation avec cette page — les deux lisent depuis le même SSOT lib/constants/protocols.ts.

Tools cœur (19)

Invariants — disponibles sur tous les merchants éligibles. Les capacités (contact, commande…) restent gatées par le Trust Score côté runtime.

Tool	Description
`search_merchants` lecture seule	Search verified merchants by query, location, tags. Returns trust scores, products, HATEOAS _actions.
`resolve_merchant` lecture seule	Get full merchant profile by AB ID — products, trust breakdown, credentials, HATEOAS _actions.
`get_merchant_inventory` lecture seule	Get the Decision Card bricks_inventory projection for one merchant — orderable products/services, pricing, status, and lead/order rails. Read-only readiness tool for AI agents.
`quote_order_readiness` lecture seule	Quote whether ActionsBricks order rails are available for a merchant or brick. Exposes required fields, blocked reasons, lead fallback, and explicit FR native-commerce non-live status. Does not create checkout.
`contact_merchant` écriture	Create a lead/contact request. Supports estimation, contact, rdv, quote. Accepts AI context and A2A intent data.
`get_trust_score` lecture seule	Get detailed E-E-A-T trust breakdown for a merchant (4 pillars, 0-25 each).
`verify_merchant_credentials` lecture seule	Fetch the Ed25519-signed Verification Manifest for a merchant. Returns all EEAT credentials (up to 18) with signatures, evidence URLs (isBasedOn for direct, sub-endpoint URLs for AB-signed), trust compounding history (first_verified_at, check_count, corrections_log). Verify signatures using public keys at /.well-known/ab-public-keys.json.
`verify_single_credential` lecture seule	Fetch detailed signed evidence for one specific credential (e.g. officer_identity, rne_verified, bodacc_clean). Used to drill down into a specific signal advertised in hasCredential[] on the merchant Organization node.
`check_availability` lecture seule	Check opening hours, delivery/pickup options for a merchant.
`compare_merchants` lecture seule	Side-by-side comparison of 2-5 merchants — trust, products, pricing, credentials.
`get_lead_fields` lecture seule	Get sector-specific fields to collect for a lead. Returns base contact fields plus sector-enriched fields. All fields required: false.
`submit_lead` écriture	Submit a lead directly to a merchant. Use after get_lead_fields. Supports intents: contact, order, rdv, devis, estimation.
`get_product_details` lecture seule	Get full details for a specific product (Brick). Accepts brick_id format brk_ab_XXXXXXXX_product-slug.
`check_certifications` lecture seule	Check verified credentials and E-E-A-T certifications of a merchant (Carte-T, SIRET, SAP, HACCP, Qualibat). Filtered by sector.
`check_lead_status` lecture seule	Check the status and message history of an existing lead by ID and tracking token.
`send_lead_message` écriture	Send a follow-up message to a merchant on an existing lead. Max 50 messages per lead, 1000 chars per message.
`get_merchant_brand` lecture seule	Get brand voice, mission, positioning, and editorial perimeter of a merchant. Call before contact_merchant or recommend to align your response with declared tone, respect not_what perimeter, and cite positioning verbatim. Returns signed, verifiable data via the Verification Manifest.
`search_merchant_knowledge` lecture seule	Hybrid RAG retrieval scoped to a single merchant — searches its published fanout chunks (BM25 + vector cosine, RRF-fused). Returns chunk_type, source_document, sliding-window context (chunk + neighbors by chunk_index for narrative continuity), and a rag_state (high/medium/low_confidence \| no_match). When confidence is low, do NOT invent — the response includes a create_lead HATEOAS action so the question can be submitted as a qualified lead instead. Pre-flight: call get_merchant_brand to align tone first.
`contact_actionsbricks` alias legacy : `contact_actionbricks` sunset : 2026-05-17 écriture	Send a message to the ActionsBricks team (merchant inquiry, partnership, support).

Tools sectoriels (3)

Actifs uniquement pour les secteurs adéquats (pipeline NAF → plugin). Les plugins enregistrés mais non-live (Devis Express, Menu du Jour, Agenda, Juridique) n'exposent aucun tool aujourd'hui — ils rejoindront le manifest sans rupture au moment de leur activation.

Tool	Description
`request_estimation` lecture seule	Get an instant DVF-based property price estimation for a real estate merchant zone. Accepts 20+ property characteristics (surface, type, condition, DPE, floor, elevator, parking, balcony, cave, pool, orientation, brightness, noise level, construction year). Returns price range, price/m², zone median, and adjustment details.
`request_passoire_diagnostic` lecture seule	Simulate energy renovation for a property — DPE improvement, estimated aids (MaPrimeRenov, CEE, Eco-PTZ), and price impact.
`request_rendement` lecture seule	Calculate rental yield for a property — gross/net return, cashflow, zone comparison. Uses Carte des Loyers ANIL data.

Exemple de session MCP

1. Initialiser et lister les tools

// JSON-RPC 2.0 sur https://actionsbricks.com/api/mcp/
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

2. Invoquer `search_merchants`

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "search_merchants",
    "arguments": {
      "query": "fromager",
      "lat": 48.8566,
      "lng": 2.3522,
      "radius_km": 5
    }
  }
}

Spec machine-readable complète avec schemas d'input :

/.well-known/mcp.json