Zum Inhalt springen

KI-Agenten

MCP-Server

Jeder Betrieb hat unter /mcp auf seiner Domain einen eigenen MCP-Server. Ein Assistent, bei dem ein Mensch diese Adresse einmal als Connector eingetragen hat, stellt Ausrüstung zusammen, nennt den gerechneten Preis und gibt einen kurzen Link auf die befüllte Kasse zurück.

https://skiverleih-talstation.example/mcp
Transport Streamable HTTP: JSON-RPC 2.0 über POST
Fassungen 2025-06-18, 2025-03-26, 2024-11-05
Zustand keiner: keine Sitzung, kein Ereignisstrom, jede Antwort ein JSON-Dokument
Anmeldung keine
Betrieb bestimmt der Host
Grenze 120 Anfragen in der Minute je Adresse
Aufrufe aus dem Browser erlaubt (Access-Control-Allow-Origin: *)

GET auf die Adresse ist 405: das wäre der Ereignisstrom, den ein Server ohne Zustand nicht anbietet.

Antwort405Method Not Allowed

Allow
OPTIONS, POST
{
"error": {
"code": "method_not_allowed",
"message": "GET wird hier nicht angenommen.",
"status": 405,
"hint": "Diesen Pfad mit OPTIONS oder POST aufrufen.",
"documentation_url": "https://skiverleih-talstation.example/api/"
}
}

Tragen Sie die Adresse in Ihrem Assistenten als entfernten MCP-Server ein. Mehr braucht es nicht: keine Zugangsdaten, kein Schlüssel.

Wer den Server von Hand ansprechen will, sendet JSON-RPC per POST. Der erste Aufruf handelt die Fassung aus:

Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": {
"name": "beispiel-client",
"version": "1.0.0"
}
}
}'

Antwort200OK

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"protocolVersion": "2025-06-18",
"capabilities": {
"tools": {
"listChanged": false
}
},
"serverInfo": {
"name": "skirent-talstation",
"title": "Skiverleih Talstation ski rental",
"version": "1.0.0"
},
"instructions": "Ski rental shop Skiverleih Talstation in Bergdorf. These tools put together rental equipment and return a checkout link for the person; you cannot book or pay. Flow: search_rental_catalog for the dates, search_accommodations for the hotel, quote_cart for the price, create_cart_link for the link. For skis and snowboards ask for height, weight and skier type (I, II, III): they set the binding. Delivery to the accommodation costs by zone. Prices depend on age: a model without a child or youth price (see price_bands) is charged at the next higher band, typically the adult price, so for children prefer models with a child price."
}
}

Eine Fassung, die der Server nicht kennt, beantwortet er mit der neuesten, die er kann. instructions gibt dem Assistenten den Ablauf mit.

Benachrichtigungen wie notifications/initialized haben keine Antwort. Der Server nimmt sie mit 202 an:

Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "notifications/initialized"
}'

Antwort202Accepted

Kein Rumpf.

Werkzeug Wofür Schreibt
get_shop_info Adresse, Kontakt, Zeiten, Saison, Leistungen nein
search_rental_catalog Kategorien und Modelle mit Preis für die Tage nein
search_accommodations Unterkünfte im Liefergebiet mit Liefergebühr nein
quote_cart verbindlicher Preis einer Auswahl nein
create_cart_link Link zur befüllten Kasse, 24 Stunden gültig legt einen Entwurf an

Der gedachte Ablauf: Katalog für die Tage lesen, Unterkunft suchen, Preis rechnen, Link erzeugen. Die Beschreibungen der Werkzeuge sind englisch, weil ein Assistent beim Verbinden nicht sagt, in welcher Sprache er später spricht. Beschriftungen und Beträge kommen in der Sprache, die ein Aufruf in language nennt, sonst in der des Betriebs.

tools/list liefert alle fünf mit ihrem Eingabeschema:

Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/list"
}'

Antwort200OK

[
{
"name": "get_shop_info",
"title": "Shop information",
"description": "Address, contact, opening hours, season and services of this ski rental shop, and how booking works. Call this first if you know nothing about the shop.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Shop information",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
}
}
]

Gezeigt ist der Teil result.tools der Antwort. Liste zeigt 1 von 5 Einträgen.

Jede Antwort auf tools/call trägt das Ergebnis zweimal: als Text in content[0].text für Assistenten, die nur Text lesen, und als Objekt in structuredContent.

liestget_shop_info

Shop information

Address, contact, opening hours, season and services of this ski rental shop, and how booking works. Call this first if you know nothing about the shop.

Keine Eingaben

Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "get_shop_info",
"arguments": {}
}
}'

Antwort200OK

Antwort anzeigen 62 Zeilen
{
"jsonrpc": "2.0",
"id": 4,
"result": {
"content": [
{
"type": "text",
"text": "… dasselbe JSON als Zeichenkette …"
}
],
"structuredContent": {
"name": "Skiverleih Talstation",
"address": {
"street": "Liftstraße 1",
"zip": "5999",
"city": "Bergdorf",
"region": "Salzburg",
"country": "AT"
},
"phone": "+43 000 000000",
"email": "office@skiverleih-talstation.example",
"whatsapp": null,
"website": "https://skiverleih-talstation.example",
"opening_hours": [
{
"days": [
"Monday",
"Tuesday",
"Wednesday",
"Thursday",
"Friday",
"Saturday",
"Sunday"
],
"hours": [
{
"opens": "08:00",
"closes": "18:00"
}
]
}
],
"season": {
"from": "2026-11-28",
"to": "2027-04-18"
},
"currency": "EUR",
"languages": [
"de",
"en"
],
"services": [
"Ski, snowboard, boot and helmet rental, bookable online, delivered to the accommodation.",
"Ski service at the shop, not bookable online.",
"Ski courses of Skischule Bergdorf, bookable on the website."
],
"delivery": "Delivered to the accommodation on the first rental day and collected after the last one; no time slots. The fee depends on the delivery zone of the accommodation, see search_accommodations (0 means free).",
"how_to_book": "Use search_rental_catalog for the dates, search_accommodations for the hotel, quote_cart for the price, then create_cart_link. Give the person the link: they check the details, accept the terms and pay themselves. You cannot book or pay."
},
"isError": false
}
}

content[0].text trägt dasselbe JSON noch einmal als Zeichenkette und ist hier gekürzt.

liestsearch_rental_catalog

Rental catalog with prices

Categories and models with their price for the given days, per age band, plus deposit, damage waiver and age rules. Model codes from here go into gear. There is no stock limit: every listed model is available. Prices depend on the age band (child, youth, adult; limits in rules.age_bands). price_bands lists the bands a model has its own price for. A model without a child or youth price is not refused but charged at the next higher band, typically the adult price. For a child or teen, prefer a model with a price for their band.

Eingaben

ArgumentTypBedeutung
fromPflichtstringStichtag, zu dem die Preisliste gilt.JJJJ-MM-TT
daysPflichtintegerAnzahl der Kurstage.1 bis 60
languagestringKurssprache.Erlaubt: de, en, cs, sk, it, sv, nl
Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "search_rental_catalog",
"arguments": {
"from": "2026-12-27",
"days": 6,
"language": "de"
}
}
}'

Antwort200OK

Antwort anzeigen 106 Zeilen
{
"jsonrpc": "2.0",
"id": 5,
"result": {
"content": [
{
"type": "text",
"text": "… dasselbe JSON als Zeichenkette …"
}
],
"structuredContent": {
"from": "2026-12-27",
"days": 6,
"currency": "EUR",
"categories": [
{
"code": "ski",
"label": "Ski",
"kind": "ski",
"required_for_a_set": true,
"only_with": null,
"models": [
{
"code": "ski-comfort",
"label": "Comfort",
"tier": "comfort",
"price": {
"adult": "€ 114,00",
"youth": "€ 52,00",
"child": "€ 39,00"
},
"price_bands": [
"child",
"youth",
"adult"
]
},
{
"code": "ski-prime",
"label": "Prime",
"tier": "prime",
"price": {
"adult": "€ 144,00"
},
"price_bands": [
"adult"
]
}
]
},
{
"code": "snowboard",
"label": "Snowboard",
"kind": "snowboard",
"required_for_a_set": true,
"only_with": null,
"models": [
{
"code": "snowboard-comfort",
"label": "Comfort",
"tier": "comfort",
"price": {
"adult": "€ 114,00",
"youth": "€ 52,00"
},
"price_bands": [
"youth",
"adult"
]
},
{
"code": "snowboard-prime",
"label": "Prime",
"tier": "prime",
"price": {
"adult": "€ 144,00"
},
"price_bands": [
"adult"
]
}
]
}
],
"rules": {
"age_bands": "child up to 6, youth up to 14, adult above",
"age_mode": "exact",
"age_groups": {
"child": "0 to 6",
"youth": "7 to 14",
"adult": "15 to 49",
"senior": "50 and older"
},
"band_fallback": "A model without a price for the person’s band is charged at the next higher band (child, then youth, then adult). A child on a model whose price_bands is [\"adult\"] pays the adult price.",
"deposit_per_set": null,
"damage_waiver_percent": 10,
"late_return_fee": "€ 5,00",
"poles_free_with": "ski",
"helmet_free_up_to_age": 12,
"family_package": "If 2 adults rent skis or a snowboard, equipment for children up to 10 is free.",
"vat_percent_included": 20
}
},
"isError": false
}
}

content[0].text trägt dasselbe JSON noch einmal als Zeichenkette und ist hier gekürzt. result.structuredContent.categories zeigt 2 von 9 Einträgen. result.structuredContent.categories[].models zeigt 2 von 3 Einträgen.

Die Codes der Modelle sind die Werte für gear in den beiden folgenden Werkzeugen. price_bands nennt die Altersbänder, für die ein Modell einen eigenen Preis hat. Ein Kind auf einem Modell ohne Kinderpreis zahlt den Preis des nächsthöheren Bandes.

Einen Bestand gibt es nicht: jedes gelistete Modell lässt sich buchen.

liestsearch_accommodations

Accommodations in the delivery area

Hotels, guesthouses and apartments the shop delivers to, with the delivery fee of their zone. Search by name; without a query the most frequent ones. The entry with is_shop is pickup at the shop. Only accommodations from this list can be delivered to.

Eingaben

ArgumentTypBedeutung
querystringName or part of it, e.g. "Alpina".max. 80 Zeichen
limitinteger1 bis 20
languagestringKurssprache.Erlaubt: de, en, cs, sk, it, sv, nl
Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 6,
"method": "tools/call",
"params": {
"name": "search_accommodations",
"arguments": {
"query": "Alpenhof"
}
}
}'

Antwort200OK

{
"jsonrpc": "2.0",
"id": 6,
"result": {
"content": [
{
"type": "text",
"text": "… dasselbe JSON als Zeichenkette …"
}
],
"structuredContent": {
"accommodations": [
{
"id": 2,
"name": "Hotel Alpenhof",
"address": "Dorfstraße 12, 5999 Bergdorf",
"district": "Oberdorf",
"is_shop": false,
"delivery": {
"zone": null,
"zone_label": null,
"fee": "included"
}
},
{
"id": 1,
"name": "Kein Hotel, Abholung im Shop",
"address": "Liftstraße 1, 5999 Bergdorf",
"district": null,
"is_shop": true,
"delivery": null
}
],
"note": "Use the id as accommodation_id. If the hotel is not listed, the person chooses pickup at the shop."
},
"isError": false
}
}

content[0].text trägt dasselbe JSON noch einmal als Zeichenkette und ist hier gekürzt.

Geliefert wird nur in Unterkünfte aus dieser Liste. Der Eintrag mit is_shop steht für die Abholung im Shop.

liestquote_cart

Price of a cart

Calculates the binding price of a selection on the server, including delivery by zone, damage waiver, family package and deposit. Changes nothing. Use it to tell the person what they will pay before creating the link. Each equipment line carries age_band, the band it was priced at. A child or teen on a model without a price for their band is charged at the next higher band, typically the adult price; notes then say so.

Eingaben

ArgumentTypBedeutung
fromPflichtstringStichtag, zu dem die Preisliste gilt.JJJJ-MM-TT
daysPflichtintegerAnzahl der Kurstage.1 bis 60
personsPflichtobject[]Anzahl der Personen mit Leihausrüstung.mind. 1 · max. 20 Einträge
persons[].namestringName der Unterkunft.max. 60 Zeichen
persons[].ageintegerAge in years; sets the price band (child, youth, adult) and free helmets for children.1 bis 110
persons[].age_groupstringInstead of age, where the shop asks for a group (rules.age_mode "group"); the years of each group are in rules.age_groups. Ignored when age is given.Erlaubt: child, youth, adult, senior
persons[].height_cmintegerHeight in cm. Needed for ski and snowboard bindings (ISO 11088).60 bis 230
persons[].weight_kgnumberWeight in kg. Needed for ski and snowboard bindings.10 bis 250
persons[].skier_typestringISO 11088 skier type: I cautious, II average, III aggressive. Needed for ski bindings.Erlaubt: I, II, III
persons[].shoe_sizestringEU shoe size, needed when renting boots.max. 10 Zeichen
persons[].gearPflichtstring[]Model codes from search_rental_catalog, one per category, e.g. ["ski-comfort","skiboots-comfort","helmet","poles"]. A category code stands for its first model; "poles" are ski poles, free with skis.mind. 1 · max. 10 Einträge
accommodation_idintegerId from search_accommodations. The delivery fee depends on its zone. Omit to let the person choose at checkout.ab 1
pickup_at_shopbooleanNo delivery; the person picks the equipment up at the shop.
damage_waiverbooleanOptional damage waiver as a percentage of the rental price. Default: included.
late_returnbooleanReturn the next morning instead of the evening of the last day, for a fee. Ignored when the shop does not offer it (rules.late_return_fee is null).
languagestringKurssprache.Erlaubt: de, en, cs, sk, it, sv, nl
Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 7,
"method": "tools/call",
"params": {
"name": "quote_cart",
"arguments": {
"from": "2026-12-27",
"days": 6,
"persons": [
{
"name": "Martin",
"age": 41,
"height_cm": 182,
"weight_kg": 84,
"skier_type": "II",
"shoe_size": "44",
"gear": [
"ski-comfort",
"skiboots-comfort",
"poles"
]
},
{
"name": "Julia",
"age": 38,
"height_cm": 168,
"weight_kg": 62,
"skier_type": "II",
"shoe_size": "38.5",
"gear": [
"ski-comfort",
"skiboots-comfort",
"poles"
]
},
{
"name": "Leon",
"age": 11,
"height_cm": 146,
"weight_kg": 38,
"skier_type": "I",
"shoe_size": "36",
"gear": [
"ski-comfort",
"skiboots-comfort",
"helmet"
]
}
],
"accommodation_id": 2,
"damage_waiver": false,
"language": "de"
}
}
}'

Antwort200OK

Antwort anzeigen 100 Zeilen
{
"jsonrpc": "2.0",
"id": 7,
"result": {
"content": [
{
"type": "text",
"text": "… dasselbe JSON als Zeichenkette …"
}
],
"structuredContent": {
"price": {
"currency": "EUR",
"persons": [
{
"title": "Martin",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amount": "€ 114,00",
"age_band": "adult"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amount": "€ 45,00",
"age_band": "adult"
},
{
"label": "Skistöcke",
"detail": "inklusive",
"amount": "€ 0,00",
"age_band": "adult"
}
],
"subtotal": "€ 159,00"
},
{
"title": "Julia",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amount": "€ 114,00",
"age_band": "adult"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amount": "€ 45,00",
"age_band": "adult"
},
{
"label": "Skistöcke",
"detail": "inklusive",
"amount": "€ 0,00",
"age_band": "adult"
}
],
"subtotal": "€ 159,00"
},
{
"title": "Leon",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amount": "€ 52,00",
"age_band": "youth"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amount": "€ 20,00",
"age_band": "youth"
},
{
"label": "Helm",
"detail": "6 Tage · Kinder bis 12 gratis",
"amount": "€ 0,00",
"age_band": "youth"
}
],
"subtotal": "€ 72,00"
}
],
"discounts": [],
"delivery": null,
"total": "€ 390,00",
"deposit": "€ 0,00",
"deposit_note": "The deposit is refunded in full after the return.",
"payable_now": "€ 390,00",
"payable_cents": 39000
},
"notes": []
},
"isError": false
}
}

content[0].text trägt dasselbe JSON noch einmal als Zeichenkette und ist hier gekürzt.

Der Preis ist verbindlich: es ist dieselbe Rechnung, mit der auch die Kasse rechnet. Jede Zeile trägt in age_band das Band, nach dem sie gerechnet wurde.

Ohne damage_waiver rechnet der Server die Haftungsreduktion mit ein. Im Beispiel ist sie abgewählt.

notes nennt, was der Assistent dem Menschen sagen sollte, bevor der an der Kasse staunt: fehlende Körperdaten, unbekannte Codes, ein Kind, das den Erwachsenenpreis zahlt.

schreibtcreate_cart_link

Checkout link for the person

Prepares the cart and returns a short link to the prefilled checkout, valid for 24 hours. Nothing is booked or paid: the person opens the link, checks sizes and dates, accepts the terms and pays. Give the person the url.

Eingaben

ArgumentTypBedeutung
fromPflichtstringStichtag, zu dem die Preisliste gilt.JJJJ-MM-TT
daysPflichtintegerAnzahl der Kurstage.1 bis 60
personsPflichtobject[]Anzahl der Personen mit Leihausrüstung.mind. 1 · max. 20 Einträge
persons[].namestringName der Unterkunft.max. 60 Zeichen
persons[].ageintegerAge in years; sets the price band (child, youth, adult) and free helmets for children.1 bis 110
persons[].age_groupstringInstead of age, where the shop asks for a group (rules.age_mode "group"); the years of each group are in rules.age_groups. Ignored when age is given.Erlaubt: child, youth, adult, senior
persons[].height_cmintegerHeight in cm. Needed for ski and snowboard bindings (ISO 11088).60 bis 230
persons[].weight_kgnumberWeight in kg. Needed for ski and snowboard bindings.10 bis 250
persons[].skier_typestringISO 11088 skier type: I cautious, II average, III aggressive. Needed for ski bindings.Erlaubt: I, II, III
persons[].shoe_sizestringEU shoe size, needed when renting boots.max. 10 Zeichen
persons[].gearPflichtstring[]Model codes from search_rental_catalog, one per category, e.g. ["ski-comfort","skiboots-comfort","helmet","poles"]. A category code stands for its first model; "poles" are ski poles, free with skis.mind. 1 · max. 10 Einträge
accommodation_idintegerId from search_accommodations. The delivery fee depends on its zone. Omit to let the person choose at checkout.ab 1
pickup_at_shopbooleanNo delivery; the person picks the equipment up at the shop.
damage_waiverbooleanOptional damage waiver as a percentage of the rental price. Default: included.
late_returnbooleanReturn the next morning instead of the evening of the last day, for a fee. Ignored when the shop does not offer it (rules.late_return_fee is null).
languagestringKurssprache.Erlaubt: de, en, cs, sk, it, sv, nl
customerobjectKontaktdaten der buchenden Person. null nach dem Löschlauf.
customer.first_namestringmax. 60 Zeichen
customer.last_namestringmax. 60 Zeichen
customer.emailstringE-Mail-Adresse. An sie geht die Bestätigung.max. 160 Zeichen
customer.phonestringTelefonnummer.max. 40 Zeichen
customer.countrystringLand der Wohnadresse, ISO 3166-1 alpha-2.max. 60 Zeichen
Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 9,
"method": "tools/call",
"params": {
"name": "create_cart_link",
"arguments": {
"from": "2026-12-27",
"days": 6,
"persons": [
{
"name": "Martin",
"age": 41,
"height_cm": 182,
"weight_kg": 84,
"skier_type": "II",
"shoe_size": "44",
"gear": [
"ski-comfort",
"skiboots-comfort",
"poles"
]
},
{
"name": "Julia",
"age": 38,
"height_cm": 168,
"weight_kg": 62,
"skier_type": "II",
"shoe_size": "38.5",
"gear": [
"ski-comfort",
"skiboots-comfort",
"poles"
]
},
{
"name": "Leon",
"age": 11,
"height_cm": 146,
"weight_kg": 38,
"skier_type": "I",
"shoe_size": "36",
"gear": [
"ski-comfort",
"skiboots-comfort",
"helmet"
]
}
],
"accommodation_id": 2,
"damage_waiver": false,
"language": "de",
"customer": {
"first_name": "Martin",
"last_name": "Berger",
"email": "martin.berger@example.org",
"phone": "+49 000 0000002",
"country": "de"
}
}
}
}'

Antwort200OK

Antwort anzeigen 103 Zeilen
{
"jsonrpc": "2.0",
"id": 9,
"result": {
"content": [
{
"type": "text",
"text": "… dasselbe JSON als Zeichenkette …"
}
],
"structuredContent": {
"url": "https://skiverleih-talstation.example/kasse?draft=nF7eJidsAc7PwMpz9nuhwA",
"expires_at": "2026-11-15T18:02:53.818Z",
"price": {
"currency": "EUR",
"persons": [
{
"title": "Martin",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amount": "€ 114,00",
"age_band": "adult"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amount": "€ 45,00",
"age_band": "adult"
},
{
"label": "Skistöcke",
"detail": "inklusive",
"amount": "€ 0,00",
"age_band": "adult"
}
],
"subtotal": "€ 159,00"
},
{
"title": "Julia",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amount": "€ 114,00",
"age_band": "adult"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amount": "€ 45,00",
"age_band": "adult"
},
{
"label": "Skistöcke",
"detail": "inklusive",
"amount": "€ 0,00",
"age_band": "adult"
}
],
"subtotal": "€ 159,00"
},
{
"title": "Leon",
"lines": [
{
"label": "Ski Comfort",
"detail": "6 Tage",
"amount": "€ 52,00",
"age_band": "youth"
},
{
"label": "Skischuhe Comfort",
"detail": "6 Tage",
"amount": "€ 20,00",
"age_band": "youth"
},
{
"label": "Helm",
"detail": "6 Tage · Kinder bis 12 gratis",
"amount": "€ 0,00",
"age_band": "youth"
}
],
"subtotal": "€ 72,00"
}
],
"discounts": [],
"delivery": null,
"total": "€ 390,00",
"deposit": "€ 0,00",
"deposit_note": "The deposit is refunded in full after the return.",
"payable_now": "€ 390,00",
"payable_cents": 39000
},
"notes": [],
"next_step": "Give the person this url. They check the details, accept the terms and pay at checkout. Delivery is to the chosen accommodation on the first rental day."
},
"isError": false
}
}

content[0].text trägt dasselbe JSON noch einmal als Zeichenkette und ist hier gekürzt.

Das Werkzeug legt einen Entwurf an und gibt dessen Link zurück. Gebucht oder bezahlt ist damit nichts: der Mensch öffnet den Link, prüft Größen und Daten, stimmt den Bedingungen zu und zahlt.

Je Adresse gehen 30 Entwürfe in der Stunde, gezählt gemeinsam mit POST /api/agent/drafts.

Was ein Werkzeug nicht tun kann, kommt als gewöhnliches Ergebnis mit isError: true und einem Satz, mit dem der Assistent weiterarbeiten kann:

Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 10,
"method": "tools/call",
"params": {
"name": "quote_cart",
"arguments": {
"from": "2026-12-27",
"days": 6,
"persons": [
{
"name": "Martin",
"age": 41,
"gear": [
"raketenski"
]
}
]
}
}
}'

Antwort200OK

{
"jsonrpc": "2.0",
"id": 10,
"result": {
"content": [
{
"type": "text",
"text": "Nothing could be put into the cart. Martin: \"raketenski\" is not in the catalog; use codes from search_rental_catalog. Martin: nothing bookable left, the person was dropped. No person has bookable equipment."
}
],
"isError": true
}
}

Passen die Argumente nicht zum Schema, nennt der Satz das Feld:

Antwort200OK

{
"jsonrpc": "2.0",
"id": 11,
"result": {
"content": [
{
"type": "text",
"text": "Invalid arguments. from: Invalid string: must match pattern /^\\d{4}-\\d{2}-\\d{2}$/; persons: Too small: expected array to have >=1 items"
}
],
"isError": true
}
}

Fehler im Protokoll sind JSON-RPC-Fehler:

Code Wann
-32700 Der Rumpf ist kein JSON.
-32600 Keine gültige Anfrage, oder eine Fassung im Kopf MCP-Protocol-Version, die der Server nicht kennt.
-32601 Die Methode gibt es nicht.
-32602 params.name fehlt, oder das Werkzeug gibt es nicht.
Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 12,
"method": "tools/call",
"params": {
"name": "book_and_pay",
"arguments": {}
}
}'

Antwort200OK

{
"jsonrpc": "2.0",
"id": 12,
"error": {
"code": -32602,
"message": "Unknown tool: book_and_pay"
}
}

Ein Array von Nachrichten bekommt ein Array von Antworten zurück, ohne Einträge für Benachrichtigungen.

Terminal-Fenster
curl -X POST "https://skiverleih-talstation.example/mcp" \
-H "Accept: application/json, text/event-stream" \
-H "Content-Type: application/json" \
-d '[
{
"jsonrpc": "2.0",
"id": 1,
"method": "ping"
},
{
"jsonrpc": "2.0",
"method": "notifications/initialized"
},
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list"
}
]'

Vor dem Verbinden beschreibt sich der Server unter /mcp/server-card: Name, Fassung, Adresse, unterstützte Fassungen des Protokolls und die Namen der Werkzeuge.

Terminal-Fenster
curl "https://skiverleih-talstation.example/mcp/server-card"

Antwort200OK

Content-Type
application/mcp-server-card+json; charset=utf-8
ETag
"88c47b2ffc0b117d03b80f558deb2a28"
Cache-Control
public, max-age=3600
Antwort anzeigen 49 Zeilen
{
"$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
"name": "example.skiverleih-talstation/ski-rental",
"version": "1.0.0",
"title": "Skiverleih Talstation",
"description": "Ski rental Skiverleih Talstation in Bergdorf: prices, delivery and a prefilled checkout link.",
"websiteUrl": "https://skiverleih-talstation.example",
"remotes": [
{
"type": "streamable-http",
"url": "https://skiverleih-talstation.example/mcp",
"supportedProtocolVersions": [
"2025-06-18",
"2025-03-26",
"2024-11-05"
]
}
],
"_meta": {
"at.sumware/tools": [
{
"name": "get_shop_info",
"title": "Shop information",
"readOnly": true
},
{
"name": "search_rental_catalog",
"title": "Rental catalog with prices",
"readOnly": true
},
{
"name": "search_accommodations",
"title": "Accommodations in the delivery area",
"readOnly": true
},
{
"name": "quote_cart",
"title": "Price of a cart",
"readOnly": true
},
{
"name": "create_cart_link",
"title": "Checkout link for the person",
"readOnly": false
}
],
"at.sumware/documentation": "https://skiverleih-talstation.example/llms.txt"
}
}

Die Antwort trägt einen ETag; mit If-None-Match kommt 304 ohne Rumpf. Gefunden wird die Karte über /.well-known/ai-catalog.json auf derselben Domain.

Buchen, zahlen, zustimmen, ein Gastkonto lesen. Kein Werkzeug schreibt außer create_cart_link, und das legt nur einen Entwurf an, der nach 24 Stunden verschwindet.