Adopte un Conteneur — MCP Server

Two AI tools for maritime container logistics in France, available via Model Context Protocol (MCP).

Tools

1. calculateContainerDeliveryCost

Calculates real-time delivery costs for maritime containers anywhere in France.

• Automatically selects the most economical depot (Toulouse, Lyon, Le Havre, Bordeaux, Fos-sur-Mer, etc.)
• Returns real HT and TTC prices from the live pricing engine
• Provides available depot alternatives

Input:

{
  "delivery_address": "69001 Lyon",
  "container_type": "20ft",
  "quantity": 1
}

Output example:

{
  "success": true,
  "delivery_address": "69001 Lyon, France",
  "container_type": "20ft",
  "quantity": 1,
  "selected_depot": "Lyon",
  "distance_km": 9,
  "total_cost_eur": 245,
  "total_cost_ttc": 294,
  "currency": "EUR",
  "vat_rate": "20%",
  "human_readable": "Livraison de 1 conteneur 20ft depuis Lyon (9 km) vers 69001 Lyon, France : 245 € HT / 294 € TTC.",
  "alternatives": [
    { "depot": "Fos-sur-Mer", "distance_km": 317, "total_cost_eur": 1010 }
  ],
  "links": {
    "calculator": "https://adopte-un-conteneur.fr/calculateur-cout-livraison-containers/",
    "order": "https://adopte-un-conteneur.fr/boutique/"
  }
}

2. getContainerDimensions

Returns interior and exterior dimensions, volumes, surfaces and weights for all container types.

• Filter by type, size, minimum volume or minimum surface
• Includes combined surface data for multiple containers placed side by side
• Covers: storage containers, dry maritime, high cube and refrigerated (reefer)

Input (all parameters optional):

{
  "type": "dry",
  "size": "20ft",
  "min_volume_m3": 30,
  "min_surface_m2": 13,
  "quantity": 2
}

Output example:

{
  "success": true,
  "count": 1,
  "containers": [
    {
      "type": "dry",
      "size": "20ft",
      "label": "Container maritime Dry 20 pieds",
      "interieur": { "longueur_m": 5.9, "largeur_m": 2.35, "hauteur_m": 2.39 },
      "exterieur": { "longueur_m": 6.06, "largeur_m": 2.44, "hauteur_m": 2.59 },
      "volume_m3": 33.14,
      "surface_m2": 13.86,
      "poids_vide_kg": 2200
    }
  ],
  "links": {
    "page": "https://adopte-un-conteneur.fr/a-propos-des-containers/dimensions-tailles-volumes-surfaces-poids-des-conteneurs/",
    "boutique": "https://adopte-un-conteneur.fr/boutique/"
  }
}

MCP Server Endpoint

https://adopte-un-conteneur.fr/api/v1/mcp-server.php

Protocol: MCP JSON-RPC 2.0 over HTTP Method: POST Authentication: None (public endpoint)

Quick Tests

List available tools:

curl -X POST https://adopte-un-conteneur.fr/api/v1/mcp-server.php \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Calculate a delivery cost:

curl -X POST https://adopte-un-conteneur.fr/api/v1/mcp-server.php \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "calculateContainerDeliveryCost",
      "arguments": {
        "delivery_address": "69001 Lyon",
        "container_type": "20ft",
        "quantity": 1
      }
    }
  }'

Get dimensions of all High Cube containers:

curl -X POST https://adopte-un-conteneur.fr/api/v1/mcp-server.php \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "getContainerDimensions",
      "arguments": {
        "type": "high_cube"
      }
    }
  }'

Get combined surface for 3 containers of 20ft placed side by side:

curl -X POST https://adopte-un-conteneur.fr/api/v1/mcp-server.php \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "getContainerDimensions",
      "arguments": {
        "size": "20ft",
        "quantity": 3
      }
    }
  }'

Additional Resources

About

Adopte un Conteneur is a French logistics company specialising in maritime container sales and delivery across France.

• 🌐 Website: adopte-un-conteneur.fr
• 📧 Contact: contact@adopte-un-conteneur.fr
• 📞 Tel: 07 80 90 19 89
• 💬 WhatsApp: wa.me/33780901989

License

MIT