Model Context Protocol (MCP) Server
BinProof provides automated Model Context Protocol interfaces for roll-off dumpster and skip hire dispatch AI agents.
Discovery & Transport Endpoints
- Discovery Manifest:
GET /.well-known/mcp.json - JSON-RPC 2.0 Endpoint:
POST /api/mcp - Documentation Page:
GET /mcp - Agent Context:
GET /llms.txt
Available Tools & inputSchema Definitions
list_stops
List open dumpster drop/swap/haul stops for today
inputSchema (JSON Schema):
{
"type": "object",
"properties": {
"today": {
"type": "string",
"description": "Date formatted YYYY-MM-DD (defaults to today)"
}
}
}calculate_dumpster_quote
Calculate dumpster rental and haul quote based on yard size, days, and tonnage
inputSchema (JSON Schema):
{
"type": "object",
"properties": {
"yards": {
"type": "integer",
"description": "Dumpster capacity in cubic yards (10, 20, 30, 40)"
},
"days": {
"type": "integer",
"description": "Rental period in days (default 7)"
},
"tonnage": {
"type": "number",
"description": "Estimated debris weight in tons"
}
},
"required": [
"yards"
]
}JSON-RPC 2.0 Sample Request
curl -X POST https://binproof.com/api/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "calculate_dumpster_quote",
"arguments": {
"yards": 20,
"days": 7,
"tonnage": 2.5
}
}
}'JSON-RPC 2.0 Sample Response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"structuredContent": {
"yards": 20,
"days": 7,
"tonnage": 2.5,
"base_fee": 395.0,
"extra_days_fee": 0.0,
"overage_tonnage_fee": 25.0,
"total_quote": 420.0,
"currency": "USD"
},
"content": [
{
"type": "text",
"text": "Dumpster Quote: 20 yards, 7 days, 2.5 tons. Total: $420.00"
}
],
"isError": false
}
}