Zum Inhalt springen

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.

  1. Katalog lesen

    Aktuell anfragbare Maschinen mit ID, technischen Daten und Lieferoptionen, seitenweise abrufbar.

    list_rental_catalogGET /api/v1/catalog

  2. Bedarf 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-requirements

  3. Preis berechnen

    Echter Mietpreis für Maschine, Zeitraum und Baustelle, inklusive Transport, Versicherung, MwSt. und Selbstbeteiligung. Ohne Kontaktdaten.

    search_rental_offersPOST /api/v1/offers/search

  4. Angebot 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.

  1. Server-URL

    Tragen Sie diese URL in Ihrem MCP-Client als Remote-Server ein (Transport: Streamable HTTP).

    Server-URL
    https://www.themachinerentalscam.com/mcp
  2. Konfiguration

    Beispiel für Clients, die eine .mcp.json lesen. Andere Clients fragen dieselbe URL ab.

    Konfiguration
    {
      "mcpServers": {
        "tmrs": {
          "type": "http",
          "url": "https://www.themachinerentalscam.com/mcp"
        }
      }
    }
  3. 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.

WerkzeugZweckHTTP-Gegenstück
list_rental_catalognur lesendLiest die anfragbaren Maschinen mit equipmentId, technischen Daten und Lieferoptionen. Weitere Seiten über nextCursor.GET /api/v1/catalog
get_quote_requirementsnur lesendPrüft einen Bedarf und liefert fehlende, ungültige oder nicht unterstützte Angaben mit Rückfragen.POST /api/v1/quote-requirements
search_rental_offersnur lesendBerechnet den Preis für einen vollständigen Bedarf. Kontaktdaten sind nicht nötig.POST /api/v1/offers/search
issue_rental_quotenur lesendGibt 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 lesendLiest 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.

MethodePfadZweck
GET/api/v1Übersicht aller Endpunkte
GET/api/v1/catalogMaschinenkatalog, seitenweise mit cursor
POST/api/v1/quote-requirementsBedarf prüfen, Rückfragen erhalten
POST · GET/api/v1/offers/searchPreis berechnen, auch per GET mit Query-Parametern
POST/api/v1/quotesAngebot 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}/documentVollständiges PDF über den zurückgegebenen document.href
Katalog abrufen
curl "https://www.themachinerentalscam.com/api/v1/catalog?locale=de"
Unvollständigen Bedarf prüfen
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"}'
Antwort (gekürzt)
{
  "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": []
}
Preis per GET berechnen
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.

Angebot ausstellen
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…>"
  }
}
Angebot und PDF-Link lesen
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

  1. Katalog lesen

    Nutzen Sie nur IDs aus dem aktuellen Katalog. Erfinden Sie keine Maschinen.

  2. Rückfragen stellen

    Senden Sie, was der Nutzer gesagt hat. Stellen Sie die zurückgegebenen Fragen und behalten Sie alle gültigen Antworten.

  3. Preis zeigen

    Zeigen Sie Maschine, Zeitraum, Adresse, Lieferart und alle Preise. Kaution und Selbstbeteiligung sind getrennt von den Mietkosten.

  4. Bestätigen lassen

    Geben Sie dem Nutzer den Bestätigungslink oder stellen Sie das Angebot nach seiner ausdrücklichen Zustimmung per HTTP aus.

  5. 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ürGrenze
Alle Aufrufe ohne Anmeldung, auch über MCP60 pro Minute, 600 pro Stunde
Angebote ausstellen, je IP5 pro Stunde, 15 pro Tag
Angebote ausstellen, je Sitzung6 pro Stunde
Angebote ausstellen, je Vermieter20 pro Stunde, 60 pro Tag
Neue Sitzungen, je IP6 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.

TMRS für KI-Agenten: MCP-Server und Mietangebots-API