Quote MCP
Public, no sign-in. Checks availability by ZIP, submits a service request once you confirm, then returns the quote.
Endpointhttps://mcp.detritus.us/mcp
Order site services through your AI assistant.
Ask ChatGPT, Claude, Cursor or another assistant for a dumpster or porta-potty. Once you confirm the job details, it checks availability, submits the request, waits for the quote and hands you the link.
How it works
You confirm the job. The assistant does the legwork.
Nothing is submitted until you say so. Every answer about availability, price or status comes straight from Detritus.
Describe the job
Tell it what you need, where and when. It asks for anything missing: ZIP, delivery date, contact details.
Check availability
It looks up the dumpster sizes and products available at your ZIP and suggests a setup for you to accept or change.
Confirm and submit
After you confirm the summary, it submits one service request with every item for the job.
Get your quote link
It checks status until the quote is ready, then returns the quote URL. You review and pay there.
Connect
Pick the connection that fits.
New customers start with the Quote MCP. Existing customers can add account access to track orders and pay bills.
Account MCP
For existing customers. Track orders, pull bills and request payment links. Not a public directory listing.
Endpointhttps://mcp.detritus.us/account/mcp
Signed-in account connector
After you approve the connection on a Detritus page, it reads your own sites, services, quotes, invoices, and notifications, and can send a confirmed message to Detritus. You can disconnect it in the assistant's settings.
Endpointhttps://mcp.detritus.us/manage/mcp
REST API
For agents without MCP. No API key. Start from the OpenAPI spec and follow the four-call quote flow below.
Base URLhttps://detritus-api.onrender.com/
For developers
The REST quote flow, in four calls.
Use this if MCP is not configured. Set mcp: true on the request and poll for the quote.
| Step | Call | What to send and keep |
|---|---|---|
| 1 | GET /api/v1/service-availability?zip= | Read dumpsterSizes[].id and products[].id for the ZIP. |
| 2 | POST /api/v1/service-requests | mcp: true, contact details, full address, rentalType,deliveryDate (YYYY-MM-DD). Porta-potties:formType: "PPD" with products. Dumpsters:formType: "DRD" with dumpsterSize anddisposalMaterial. A job that needs both is still one request:formType: "PPD" plus dumpsterSize anddisposalMaterial. Keep data.serviceRequestId. |
| 3 | POST /api/v1/service-requests/{serviceRequestId}/quote-status | The phone or email from the request. While data.stopPolling is false, wait about 5 seconds and repeat. |
| 4 | POST /api/v1/service-requests/{serviceRequestId}/quote | The same phone or email. Share data.quoteUrl. |
Poll quote-status about every 5 seconds and stop after roughly 6 minutes. Order lookup and payment links are in the OpenAPI spec.
Ground rules
What the assistant will and won't do.
Nothing goes out without you
It submits a quote or service request only after you ask for one or confirm the details.
No guessed numbers
Availability, pricing and order status come from Detritus responses. If something is missing, it asks you.
You pay on the quote page
Card payment happens on the quote link unless you authorize the assistant to enter card details. Net terms: email accounting@detritus.us.
Ordering for a single job?
Our single-job brands have their own assistant guides.