Adopte un Conteneur - Container Delivery & Dimensions
Delivery cost calculator and container dimensions for France. Real HT/TTC prices.
Open source Repository Open in the app JSON README (API)
About
Delivery cost calculator and container dimensions for France. Real HT/TTC prices.
Details
- Kind
- MCP servers
- Topic
- Cloud & DevOps
- Publisher
- adopteunconteneur
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.2.0
- Last push
- 2026-05-09T17:27:07Z
- Repository state
- ativo
- Added
- 2026-08-29 03:02:23
- Updated
- 2026-08-29 03:02:23
- Origin id
io.github.adopteunconteneur/delivery-calculator
README
# Adopte un Conteneur — MCP Server
> Two AI tools for maritime container logistics in France, available via Model Context Protocol (MCP).
[](https://registry.modelcontextprotocol.io)
## 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:**
```json
{
"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:**
```json
{
"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):**
```json
{
"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:**
```json
{
"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:**
```bash
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:**
```bash
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:**
```bash
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:**
```bash
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](https://adopte-un-conteneur.fr)
- 📧 Contact: contact@adopte-un-conteneur.fr
- 📞 Tel: 07 80 90 19 89
- 💬 WhatsApp: [wa.me/33780901989](https://wa.me/33780901989)
## License
MIT