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/ |
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