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
Eckdaten
Abschnitt betitelt „Eckdaten“| 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/" }}Verbindung
Abschnitt betitelt „Verbindung“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:
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" } } }'const res = await fetch("https://skiverleih-talstation.example/mcp", { method: "POST", headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json", }, body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "initialize", params: { protocolVersion: "2025-06-18", capabilities: {}, clientInfo: { name: "beispiel-client", version: "1.0.0" }, }, }),});
const data = await res.json();if (data.error) throw new Error(data.error.message);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/mcp", headers={"Accept": "application/json, text/event-stream"}, json={ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "beispiel-client", "version": "1.0.0"}, }, }, timeout=10,)data = res.json()if "error" in data: raise RuntimeError(data["error"]["message"])print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Accept: application/json, text/event-stream', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'jsonrpc' => '2.0', 'id' => 1, 'method' => 'initialize', 'params' => [ 'protocolVersion' => '2025-06-18', 'capabilities' => new stdClass(), 'clientInfo' => ['name' => 'beispiel-client', 'version' => '1.0.0'], ], ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if (isset($data['error'])) { throw new RuntimeException($data['error']['message']);}print_r($data);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:
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" }'const res = await fetch("https://skiverleih-talstation.example/mcp", { method: "POST", headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json", }, body: JSON.stringify({ jsonrpc: "2.0", method: "notifications/initialized" }),});
console.log(res.status);import requests
res = requests.post( "https://skiverleih-talstation.example/mcp", headers={"Accept": "application/json, text/event-stream"}, json={"jsonrpc": "2.0", "method": "notifications/initialized"}, timeout=10,)print(res.status_code)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Accept: application/json, text/event-stream', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode(['jsonrpc' => '2.0', 'method' => 'notifications/initialized']),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
echo $status;Antwort202Accepted
Kein Rumpf.
Werkzeuge
Abschnitt betitelt „Werkzeuge“| 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:
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" }'const res = await fetch("https://skiverleih-talstation.example/mcp", { method: "POST", headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json", }, body: JSON.stringify({ jsonrpc: "2.0", id: 3, method: "tools/list" }),});
const data = await res.json();if (data.error) throw new Error(data.error.message);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/mcp", headers={"Accept": "application/json, text/event-stream"}, json={"jsonrpc": "2.0", "id": 3, "method": "tools/list"}, timeout=10,)data = res.json()if "error" in data: raise RuntimeError(data["error"]["message"])print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Accept: application/json, text/event-stream', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode(['jsonrpc' => '2.0', 'id' => 3, 'method' => 'tools/list']),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if (isset($data['error'])) { throw new RuntimeException($data['error']['message']);}print_r($data);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.
get_shop_info
Abschnitt betitelt „get_shop_info“liestget_shop_info
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
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": {} } }'const res = await fetch("https://skiverleih-talstation.example/mcp", { method: "POST", headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json", }, body: JSON.stringify({ jsonrpc: "2.0", id: 4, method: "tools/call", params: { name: "get_shop_info", arguments: {}, }, }),});
const data = await res.json();if (data.error) throw new Error(data.error.message);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/mcp", headers={"Accept": "application/json, text/event-stream"}, json={ "jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": { "name": "get_shop_info", "arguments": {}, }, }, timeout=10,)data = res.json()if "error" in data: raise RuntimeError(data["error"]["message"])print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Accept: application/json, text/event-stream', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'jsonrpc' => '2.0', 'id' => 4, 'method' => 'tools/call', 'params' => [ 'name' => 'get_shop_info', 'arguments' => new stdClass(), ], ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if (isset($data['error'])) { throw new RuntimeException($data['error']['message']);}print_r($data);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.
search_rental_catalog
Abschnitt betitelt „search_rental_catalog“liestsearch_rental_catalog
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
| Argument | Typ | Bedeutung |
|---|---|---|
fromPflicht | string | Stichtag, zu dem die Preisliste gilt.JJJJ-MM-TT |
daysPflicht | integer | Anzahl der Kurstage.1 bis 60 |
language | string | Kurssprache.Erlaubt: de, en, cs, sk, it, sv, nl |
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" } } }'const res = await fetch("https://skiverleih-talstation.example/mcp", { method: "POST", headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json", }, body: JSON.stringify({ jsonrpc: "2.0", id: 5, method: "tools/call", params: { name: "search_rental_catalog", arguments: { from: "2026-12-27", days: 6, language: "de" }, }, }),});
const data = await res.json();if (data.error) throw new Error(data.error.message);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/mcp", headers={"Accept": "application/json, text/event-stream"}, json={ "jsonrpc": "2.0", "id": 5, "method": "tools/call", "params": { "name": "search_rental_catalog", "arguments": {"from": "2026-12-27", "days": 6, "language": "de"}, }, }, timeout=10,)data = res.json()if "error" in data: raise RuntimeError(data["error"]["message"])print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Accept: application/json, text/event-stream', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'jsonrpc' => '2.0', 'id' => 5, 'method' => 'tools/call', 'params' => [ 'name' => 'search_rental_catalog', 'arguments' => ['from' => '2026-12-27', 'days' => 6, 'language' => 'de'], ], ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if (isset($data['error'])) { throw new RuntimeException($data['error']['message']);}print_r($data);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.
search_accommodations
Abschnitt betitelt „search_accommodations“liestsearch_accommodations
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
| Argument | Typ | Bedeutung |
|---|---|---|
query | string | Name or part of it, e.g. "Alpina".max. 80 Zeichen |
limit | integer | 1 bis 20 |
language | string | Kurssprache.Erlaubt: de, en, cs, sk, it, sv, nl |
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" } } }'const res = await fetch("https://skiverleih-talstation.example/mcp", { method: "POST", headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json", }, body: JSON.stringify({ jsonrpc: "2.0", id: 6, method: "tools/call", params: { name: "search_accommodations", arguments: { query: "Alpenhof" }, }, }),});
const data = await res.json();if (data.error) throw new Error(data.error.message);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/mcp", headers={"Accept": "application/json, text/event-stream"}, json={ "jsonrpc": "2.0", "id": 6, "method": "tools/call", "params": { "name": "search_accommodations", "arguments": {"query": "Alpenhof"}, }, }, timeout=10,)data = res.json()if "error" in data: raise RuntimeError(data["error"]["message"])print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Accept: application/json, text/event-stream', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'jsonrpc' => '2.0', 'id' => 6, 'method' => 'tools/call', 'params' => [ 'name' => 'search_accommodations', 'arguments' => ['query' => 'Alpenhof'], ], ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if (isset($data['error'])) { throw new RuntimeException($data['error']['message']);}print_r($data);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.
quote_cart
Abschnitt betitelt „quote_cart“liestquote_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
| Argument | Typ | Bedeutung |
|---|---|---|
fromPflicht | string | Stichtag, zu dem die Preisliste gilt.JJJJ-MM-TT |
daysPflicht | integer | Anzahl der Kurstage.1 bis 60 |
personsPflicht | object[] | Anzahl der Personen mit Leihausrüstung.mind. 1 · max. 20 Einträge |
persons[].name | string | Name der Unterkunft.max. 60 Zeichen |
persons[].age | integer | Age in years; sets the price band (child, youth, adult) and free helmets for children.1 bis 110 |
persons[].age_group | string | Instead 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_cm | integer | Height in cm. Needed for ski and snowboard bindings (ISO 11088).60 bis 230 |
persons[].weight_kg | number | Weight in kg. Needed for ski and snowboard bindings.10 bis 250 |
persons[].skier_type | string | ISO 11088 skier type: I cautious, II average, III aggressive. Needed for ski bindings.Erlaubt: I, II, III |
persons[].shoe_size | string | EU shoe size, needed when renting boots.max. 10 Zeichen |
persons[].gearPflicht | string[] | 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_id | integer | Id from search_accommodations. The delivery fee depends on its zone. Omit to let the person choose at checkout.ab 1 |
pickup_at_shop | boolean | No delivery; the person picks the equipment up at the shop. |
damage_waiver | boolean | Optional damage waiver as a percentage of the rental price. Default: included. |
late_return | boolean | Return 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). |
language | string | Kurssprache.Erlaubt: de, en, cs, sk, it, sv, nl |
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" } } }'const res = await fetch("https://skiverleih-talstation.example/mcp", { method: "POST", headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json", }, body: JSON.stringify({ 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", }, }, }),});
const data = await res.json();if (data.error) throw new Error(data.error.message);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/mcp", headers={"Accept": "application/json, text/event-stream"}, json={ "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", }, }, }, timeout=10,)data = res.json()if "error" in data: raise RuntimeError(data["error"]["message"])print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Accept: application/json, text/event-stream', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ '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', ], ], ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if (isset($data['error'])) { throw new RuntimeException($data['error']['message']);}print_r($data);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.
create_cart_link
Abschnitt betitelt „create_cart_link“schreibtcreate_cart_link
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
| Argument | Typ | Bedeutung |
|---|---|---|
fromPflicht | string | Stichtag, zu dem die Preisliste gilt.JJJJ-MM-TT |
daysPflicht | integer | Anzahl der Kurstage.1 bis 60 |
personsPflicht | object[] | Anzahl der Personen mit Leihausrüstung.mind. 1 · max. 20 Einträge |
persons[].name | string | Name der Unterkunft.max. 60 Zeichen |
persons[].age | integer | Age in years; sets the price band (child, youth, adult) and free helmets for children.1 bis 110 |
persons[].age_group | string | Instead 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_cm | integer | Height in cm. Needed for ski and snowboard bindings (ISO 11088).60 bis 230 |
persons[].weight_kg | number | Weight in kg. Needed for ski and snowboard bindings.10 bis 250 |
persons[].skier_type | string | ISO 11088 skier type: I cautious, II average, III aggressive. Needed for ski bindings.Erlaubt: I, II, III |
persons[].shoe_size | string | EU shoe size, needed when renting boots.max. 10 Zeichen |
persons[].gearPflicht | string[] | 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_id | integer | Id from search_accommodations. The delivery fee depends on its zone. Omit to let the person choose at checkout.ab 1 |
pickup_at_shop | boolean | No delivery; the person picks the equipment up at the shop. |
damage_waiver | boolean | Optional damage waiver as a percentage of the rental price. Default: included. |
late_return | boolean | Return 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). |
language | string | Kurssprache.Erlaubt: de, en, cs, sk, it, sv, nl |
customer | object | Kontaktdaten der buchenden Person. null nach dem Löschlauf. |
customer.first_name | string | max. 60 Zeichen |
customer.last_name | string | max. 60 Zeichen |
customer.email | string | E-Mail-Adresse. An sie geht die Bestätigung.max. 160 Zeichen |
customer.phone | string | Telefonnummer.max. 40 Zeichen |
customer.country | string | Land der Wohnadresse, ISO 3166-1 alpha-2.max. 60 Zeichen |
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" } } } }'const res = await fetch("https://skiverleih-talstation.example/mcp", { method: "POST", headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json", }, body: JSON.stringify({ 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", }, }, }, }),});
const data = await res.json();if (data.error) throw new Error(data.error.message);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/mcp", headers={"Accept": "application/json, text/event-stream"}, json={ "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", }, }, }, }, timeout=10,)data = res.json()if "error" in data: raise RuntimeError(data["error"]["message"])print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Accept: application/json, text/event-stream', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ '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', ], ], ], ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if (isset($data['error'])) { throw new RuntimeException($data['error']['message']);}print_r($data);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:
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" ] } ] } } }'const res = await fetch("https://skiverleih-talstation.example/mcp", { method: "POST", headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json", }, body: JSON.stringify({ 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"], }, ], }, }, }),});
const data = await res.json();if (data.error) throw new Error(data.error.message);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/mcp", headers={"Accept": "application/json, text/event-stream"}, json={ "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"], }, ], }, }, }, timeout=10,)data = res.json()if "error" in data: raise RuntimeError(data["error"]["message"])print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Accept: application/json, text/event-stream', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ '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'], ], ], ], ], ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if (isset($data['error'])) { throw new RuntimeException($data['error']['message']);}print_r($data);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. |
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": {} } }'const res = await fetch("https://skiverleih-talstation.example/mcp", { method: "POST", headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json", }, body: JSON.stringify({ jsonrpc: "2.0", id: 12, method: "tools/call", params: { name: "book_and_pay", arguments: {}, }, }),});
const data = await res.json();if (data.error) throw new Error(data.error.message);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/mcp", headers={"Accept": "application/json, text/event-stream"}, json={ "jsonrpc": "2.0", "id": 12, "method": "tools/call", "params": { "name": "book_and_pay", "arguments": {}, }, }, timeout=10,)data = res.json()if "error" in data: raise RuntimeError(data["error"]["message"])print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Accept: application/json, text/event-stream', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ 'jsonrpc' => '2.0', 'id' => 12, 'method' => 'tools/call', 'params' => [ 'name' => 'book_and_pay', 'arguments' => new stdClass(), ], ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if (isset($data['error'])) { throw new RuntimeException($data['error']['message']);}print_r($data);Antwort200OK
{ "jsonrpc": "2.0", "id": 12, "error": { "code": -32602, "message": "Unknown tool: book_and_pay" }}Stapelanfragen
Abschnitt betitelt „Stapelanfragen“Ein Array von Nachrichten bekommt ein Array von Antworten zurück, ohne Einträge für Benachrichtigungen.
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" } ]'const res = await fetch("https://skiverleih-talstation.example/mcp", { method: "POST", headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json", }, body: JSON.stringify([ { jsonrpc: "2.0", id: 1, method: "ping" }, { jsonrpc: "2.0", method: "notifications/initialized" }, { jsonrpc: "2.0", id: 2, method: "tools/list" }, ]),});
const data = await res.json();if (data.error) throw new Error(data.error.message);console.log(data);import requests
res = requests.post( "https://skiverleih-talstation.example/mcp", headers={"Accept": "application/json, text/event-stream"}, json=[ {"jsonrpc": "2.0", "id": 1, "method": "ping"}, {"jsonrpc": "2.0", "method": "notifications/initialized"}, {"jsonrpc": "2.0", "id": 2, "method": "tools/list"}, ], timeout=10,)data = res.json()if "error" in data: raise RuntimeError(data["error"]["message"])print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Accept: application/json, text/event-stream', 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode([ ['jsonrpc' => '2.0', 'id' => 1, 'method' => 'ping'], ['jsonrpc' => '2.0', 'method' => 'notifications/initialized'], ['jsonrpc' => '2.0', 'id' => 2, 'method' => 'tools/list'], ]),]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if (isset($data['error'])) { throw new RuntimeException($data['error']['message']);}print_r($data);Server-Karte
Abschnitt betitelt „Server-Karte“Vor dem Verbinden beschreibt sich der Server unter /mcp/server-card: Name, Fassung, Adresse, unterstützte Fassungen des Protokolls und die Namen der Werkzeuge.
curl "https://skiverleih-talstation.example/mcp/server-card"const res = await fetch("https://skiverleih-talstation.example/mcp/server-card");
const data = await res.json();if (!res.ok) throw new Error(`${data.error.code}: ${data.error.hint}`);console.log(data);import requests
res = requests.get( "https://skiverleih-talstation.example/mcp/server-card", timeout=10,)data = res.json()if not res.ok: raise RuntimeError(f"{data['error']['code']}: {data['error']['hint']}")print(data)<?php
$ch = curl_init('https://skiverleih-talstation.example/mcp/server-card');curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10,]);$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$data = json_decode($body, true);if ($status >= 400) { throw new RuntimeException($data['error']['code'] . ': ' . $data['error']['hint']);}print_r($data);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.
Einschränkungen
Abschnitt betitelt „Einschränkungen“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.