Für KI-Agenten und Entwickler
Baumaschinen mieten, direkt aus Ihrem KI-Agenten.
TMRS bietet einen öffentlichen MCP-Server und eine REST-API. Ihr Agent liest den Maschinenkatalog registrierter Vermieter, klärt den Mietbedarf, berechnet echte Mietpreise und führt bis zum schriftlichen Angebot als PDF.
- Ohne Anmeldung, ohne API-Schlüssel
- MCP (Streamable HTTP) und REST mit OpenAPI 3.1
- Preise mit Transport, Versicherung und MwSt.
- Mietangebot als PDF mit Mietbedingungen
01Überblick
Was Ihr Agent mit TMRS kann
Vier Schritte führen vom ersten Satz des Nutzers zum Angebot. Jeder Schritt steht als MCP-Werkzeug und als HTTP-Endpunkt bereit.
Katalog lesen
Aktuell anfragbare Maschinen mit ID, technischen Daten und Lieferoptionen, seitenweise abrufbar.
list_rental_catalogGET /api/v1/catalogBedarf klären
Auch ein unvollständiger Bedarf ist erlaubt. Die Antwort nennt fehlende Angaben mit fertigen Rückfragen auf Deutsch und Englisch.
get_quote_requirementsPOST /api/v1/quote-requirementsPreis berechnen
Echter Mietpreis für Maschine, Zeitraum und Baustelle, inklusive Transport, Versicherung, MwSt. und Selbstbeteiligung. Ohne Kontaktdaten.
search_rental_offersPOST /api/v1/offers/searchAngebot und PDF
Der Nutzer bestätigt den Bedarf auf einer TMRS-Seite oder Ihr Server stellt das Angebot aus. Das PDF enthält die Mietbedingungen des Vermieters.
issue_rental_quoteget_quote_documentPOST /api/v1/quotes
02Schnellstart
MCP-Server verbinden
Für Agenten ohne eigene HTTP-Werkzeuge, etwa in Chat-Assistenten oder Entwicklungsumgebungen. Der Server ist zustandslos und braucht keine Authentifizierung.
Server-URL
Tragen Sie diese URL in Ihrem MCP-Client als Remote-Server ein (Transport: Streamable HTTP).
Server-URL https://www.themachinerentalscam.com/mcpKonfiguration
Beispiel für Clients, die eine
.mcp.jsonlesen. Andere Clients fragen dieselbe URL ab.Konfiguration { "mcpServers": { "tmrs": { "type": "http", "url": "https://www.themachinerentalscam.com/mcp" } } }Verbindung prüfen
Dieser Aufruf listet die fünf Werkzeuge. Er ist nur lesend.
Verbindung prüfen curl -X POST https://www.themachinerentalscam.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Unterstützte Protokollversionen: 2025-06-18, 2025-03-26, 2024-11-05. Maschinenlesbar beschrieben in Server-Card und AI-Katalog.
03Werkzeuge
Fünf Werkzeuge, alle nur lesend
Kein Werkzeug des MCP-Servers legt ein Angebot an, löst eine Buchung aus oder versendet eine E-Mail.
| Werkzeug | Zweck | HTTP-Gegenstück |
|---|---|---|
list_rental_catalognur lesend | Liest die anfragbaren Maschinen mit equipmentId, technischen Daten und Lieferoptionen. Weitere Seiten über nextCursor. | GET /api/v1/catalog |
get_quote_requirementsnur lesend | Prüft einen Bedarf und liefert fehlende, ungültige oder nicht unterstützte Angaben mit Rückfragen. | POST /api/v1/quote-requirements |
search_rental_offersnur lesend | Berechnet den Preis für einen vollständigen Bedarf. Kontaktdaten sind nicht nötig. | POST /api/v1/offers/search |
issue_rental_quotenur lesend | Gibt einen Bestätigungslink zurück. Dort prüft der Nutzer den Preis, ergänzt seine Kontaktdaten und fordert das PDF-Angebot selbst an. | humanConfirmationUrl |
get_quote_documentnur lesend | Liest Status und PDF-Link eines bereits ausgestellten Angebots. Dafür braucht es das accessToken dieses Angebots. | GET /api/v1/quotes/{id} |
04REST
HTTP-API
Für Agenten und Server, die selbst HTTP-Anfragen senden. Alle Anfragen und Antworten sind JSON.
| Methode | Pfad | Zweck |
|---|---|---|
| GET | /api/v1 | Übersicht aller Endpunkte |
| GET | /api/v1/catalog | Maschinenkatalog, seitenweise mit cursor |
| POST | /api/v1/quote-requirements | Bedarf prüfen, Rückfragen erhalten |
| POST · GET | /api/v1/offers/search | Preis berechnen, auch per GET mit Query-Parametern |
| POST | /api/v1/quotes | Angebot ausstellen. Erzeugt ein echtes Angebot und kann den Vermieter benachrichtigen. |
| GET | /api/v1/quotes/{id} | Angebotsstatus und frischer PDF-Link, mit Bearer-Token |
| GET | /api/v1/quotes/{id}/document | Vollständiges PDF über den zurückgegebenen document.href |
curl "https://www.themachinerentalscam.com/api/v1/catalog?locale=de"curl -X POST https://www.themachinerentalscam.com/api/v1/quote-requirements \
-H "Content-Type: application/json" \
-d '{"locale":"de","jobsiteAddress":"Musterstraße 1, 10115 Berlin"}'{
"state": "needs_input",
"missingFields": [
{
"path": "equipmentId",
"code": "required",
"question": {
"de": "Welche konkrete Maschine aus dem Katalog wird benötigt?",
"en": "Which specific machine from the catalog is required?"
}
},
{
"path": "startDate",
"code": "required",
"unit": "YYYY-MM-DD",
"question": {
"de": "Wann beginnt die Miete (JJJJ-MM-TT)?",
"en": "When does the rental start (YYYY-MM-DD)?"
}
}
],
"invalidFields": [],
"unsupportedFields": []
}curl -G https://www.themachinerentalscam.com/api/v1/offers/search \
--data-urlencode "equipmentId=<equipmentId>" \
--data-urlencode "startDate=2027-06-14" \
--data-urlencode "endDate=2027-06-16" \
--data-urlencode "jobsiteAddress=Musterstraße 1, 10115 Berlin" \
--data-urlencode "deliveryType=delivery"Senden Sie diesen Aufruf erst, wenn der Nutzer Maschine, Zeitraum, Adresse, Kontaktdaten und Preis bestätigt hat. Verwenden Sie für dieselbe Absicht immer denselben Idempotency-Key, auch nach einer Zeitüberschreitung.
POST /api/v1/quotes
Content-Type: application/json
Idempotency-Key: <stable-key-for-this-intent>
{
"locale": "de",
"equipmentId": "<equipmentId>",
"startDate": "2027-06-14",
"endDate": "2027-06-16",
"jobsiteAddress": "Musterstraße 1, 10115 Berlin",
"deliveryType": "delivery",
"contact": {
"name": "<Name>",
"email": "name@example.com",
"phone": "<+49…>"
}
}GET /api/v1/quotes/<quote.id>
Authorization: Bearer <accessToken>
→ document.href: GET <document.href> (application/pdf)Vollständige Beschreibung aller Felder: OpenAPI 3.1 · API-Katalog (RFC 9727) · llms.txt
05Ablauf
Vom ersten Satz zum Angebot
Katalog lesen
Nutzen Sie nur IDs aus dem aktuellen Katalog. Erfinden Sie keine Maschinen.
Rückfragen stellen
Senden Sie, was der Nutzer gesagt hat. Stellen Sie die zurückgegebenen Fragen und behalten Sie alle gültigen Antworten.
Preis zeigen
Zeigen Sie Maschine, Zeitraum, Adresse, Lieferart und alle Preise. Kaution und Selbstbeteiligung sind getrennt von den Mietkosten.
Bestätigen lassen
Geben Sie dem Nutzer den Bestätigungslink oder stellen Sie das Angebot nach seiner ausdrücklichen Zustimmung per HTTP aus.
PDF abrufen
Mit quote.id und accessToken lesen Sie den Status und laden das PDF über den zurückgegebenen Link.
06Antworten
Zustände einer Antwort
Jede Antwort enthält ein Feld state. Richten Sie den nächsten Schritt danach aus.
needs_input- Angaben fehlen oder sind ungültig. Stellen Sie die zurückgegebenen Rückfragen.
ready_to_quote- Der Bedarf ist vollständig. Die Verfügbarkeit wird erst beim Ausstellen verbindlich geprüft.
quote_issued- Das Angebot ist ausgestellt. Beachten Sie die zurückgegebene Gültigkeit.
processing- Wird noch verarbeitet. Mit quote.id dieses Angebot abfragen, sonst denselben Aufruf mit demselben Idempotency-Key nach Retry-After wiederholen.
unavailable- Keine passende verfügbare Maschine. Das Feld reason nennt den Grund.
manual_quote_required- Dieser Bedarf wird nicht automatisch angeboten. Versprechen Sie dem Nutzer kein Angebot.
07Grenzen
Was geht, was nicht
Ohne Anmeldung möglich
- Katalog lesen, Bedarf prüfen und Preise berechnen, per MCP und per HTTP
- Bestätigungslink für den Nutzer erzeugen
- Angebot per HTTP ausstellen, Server zu Server und mit Idempotency-Key
- Angebot und PDF mit dem zugehörigen accessToken lesen
Über die API nicht möglich
- Ein Angebot annehmen, eine Maschine buchen oder bezahlen
- Angebote aus fremden Browser-Websites ausstellen oder lesen (cross_origin_not_allowed)
- Kontaktdaten in URLs übergeben
- Automatische Angebote für nicht unterstützte Konfigurationen. Unterstützt sind derzeit ausgewählte Maschinen in Berlin und Brandenburg, alles andere antwortet mit manual_quote_required.
Rate-Limits
Feste Zeitfenster je IP-Adresse. Ein erreichtes Limit antwortet mit HTTP 429, dem Header Retry-After in Sekunden und einem stabilen code.
| Gilt für | Grenze |
|---|---|
| Alle Aufrufe ohne Anmeldung, auch über MCP | 60 pro Minute, 600 pro Stunde |
| Angebote ausstellen, je IP | 5 pro Stunde, 15 pro Tag |
| Angebote ausstellen, je Sitzung | 6 pro Stunde |
| Angebote ausstellen, je Vermieter | 20 pro Stunde, 60 pro Tag |
| Neue Sitzungen, je IP | 6 pro Stunde |
HTTP-Anfragen nutzen Content-Type application/json und sind höchstens 32 KiB groß.
08Datenschutz
Datenschutz und Sicherheit
- Katalog, Rückfragen und Preissuche brauchen keine personenbezogenen Daten.
- Kontaktdaten des Nutzers sind erst zum Ausstellen eines Angebots nötig. Sie stehen im Angebot, damit der Vermieter den Mieter erreichen kann.
- Kontaktdaten gehören nie in eine URL. Die Preissuche per GET lehnt sie ab, und der Bestätigungslink enthält keine.
- accessToken und PDF-Links sind geheim und laufen ab. Geben Sie sie nur an den Nutzer weiter und speichern Sie sie nicht in Logs. Angebote und PDFs werden nicht indexiert.
Mehr dazu in der Datenschutzerklärung.
09Kontakt
Fragen zur Integration?
Schreiben Sie an support@themachinerentalscam.com. Bitte prüfen Sie bei unserer Antwort auch Ihren Spam-Ordner und markieren Sie uns als vertrauenswürdigen Absender.
Sie suchen eine Maschine, keinen API-Zugang?
Beschreiben Sie Ihre Baustelle einmal. Passende Vermieter antworten mit einem Angebot als PDF.