MCP 服务器

Adopte un Conteneur — Container Delivery Calculator

Calculate empty shipping container delivery costs in France. Automatically selects the optimal depot and returns real prices (without and with VAT).

README

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
}

Parameter	Type	Required	Values
`delivery_address`	string	✅	Any French address or city
`container_type`	string	✅	`20ft` · `40ft` · `40ft_hc`
`quantity`	integer	✅	1 to 99

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
}

Parameter	Type	Required	Values
`type`	string	❌	`stockage` · `dry` · `high_cube` · `reefer`
`size`	string	❌	`6ft` · `8ft` · `10ft` · `20ft` · `40ft` · `40ft_hc` · `45ft_hc`
`min_volume_m3`	number	❌	Minimum interior volume in m³
`min_surface_m2`	number	❌	Minimum interior surface in m²
`quantity`	integer	❌	`2` · `3` · `4` — combined surface for containers placed side by side (requires `size=20ft` or `size=40ft`)

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

Resource	URL
Website	https://adopte-un-conteneur.fr
AI landing page	https://adopte-un-conteneur.fr/ai
OpenAPI spec	https://adopte-un-conteneur.fr/openapi.json
MCP manifest	https://adopte-un-conteneur.fr/mcp.json
AI discovery	https://adopte-un-conteneur.fr/.well-known/ai.json
Dimensions page	https://adopte-un-conteneur.fr/a-propos-des-containers/dimensions-tailles-volumes-surfaces-poids-des-conteneurs/