MCP 服务器

SesApp Access Sheets

fr.sesapp/fiches
通信 旅行与酒店 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Creates and manages shareable housing access sheets with guest instructions, maps, revocable links, webhooks, and location-gated Wi-Fi access.

create_fiche
Create an access sheet. Write the guest flip-book in `instructions` (Markdown; guest language, usually French). Cover (map/name/address/accessCode) is auto. Pages: --- . Photos: ![alt](https://...). Intents: [Add WiFi](sesapp:wifi) or [Ajouter le WiFi](sesapp:wifi) + wifiName/wifiPassword; [Add contact](sesapp:contact) or [Ajouter le contact](sesapp:contact) + phoneNumber. Never put wifiPassword in Markdown (150 m GPS). Optional `locale` fr|en for guest chrome. Playbook: GET /llms.txt. Requires Bearer. Beyond quota, retry with PAYMENT-SIGNATURE (0.50 USDC on Agent, 0.25 on Fleet).
输入模式
{'type': 'object', 'required': ['name', 'formattedAddress'], 'properties': {'lat': {'type': 'number', 'description': 'Cover map + WiFi geofence (150 m).'}, 'lon': {'type': 'number', 'description': 'Cover map + WiFi geofence (150 m).'}, 'name': {'type': 'string'}, 'locale': {'enum': ['fr', 'en'], 'type': 'string', 'description': 'Guest chrome language. Markdown stays as written. Omit to follow Accept-Language / ?lang=.'}, 'wifiName': {'type': 'string', 'description': 'SSID for sesapp:wifi. Hidden until 150 m if wifiPassword is set.'}, 'accessCode': {'type': 'string', 'description': 'Shown on the generated cover.'}, 'phoneNumber': {'type': 'string', 'description': 'Required for sesapp:contact. E.164 preferred.'}, 'instructions': {'type': 'string', 'description': 'Markdown flip-book shown to the guest (this field).\nCover (map, name, formattedAddress, accessCode) is generated — do not repeat it here.\nSplit pages with a line containing only --- .\nSupported: # ## ### headings, paragraphs, **bold**, *italic*, - / 1. lists, [label](https://...), ![alt](https://...).\nPhotos: https URLs (GCS via the host app, or your own CDN). Agents send URLs, no file upload.\nNever put wifiPassword in Markdown; it is unlocked only within 150 m via GPS.\nIntent hrefs: sesapp:wifi (needs wifiName + wifiPassword) and sesapp:contact (needs phoneNumber). Guest-facing labels: [Ajouter le WiFi] / [Ajouter le contact].\nIf you omit those links but set the fields, SesApp appends WiFi/contact pages.\nExample:\n# Bienvenue\nParking au fond à gauche.\n\n![Façade](https://example.com/facade.jpg)\n\n---\n\n## Arrivée\nSonnette à gauche.\n\n[Itinéraire](https://maps.google.com/?q=48.8566,2.3522)\n\n---\n\n[Ajouter le WiFi](sesapp:wifi)\n\n---\n\n[Ajouter le contact](sesapp:contact)'}, 'wifiPassword': {'type': 'string', 'description': 'Do not put in instructions. Unlocked within 150 m.'}, 'formattedAddress': {'type': 'string'}}}
delete_fiche
Delete an owned access sheet and its share links. Requires Bearer.
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}}}
delete_webhook
Delete a webhook endpoint. Fleet/Platform. Requires Bearer.
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}}}
geocode
Resolve a postal address to formattedAddress + lat/lon for create_fiche (cover map and 150 m WiFi geofence). Optional country ISO2. Requires Bearer.
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Address search, min 3 characters'}, 'country': {'type': 'string', 'description': 'Optional ISO 3166-1 alpha-2, e.g. fr'}}}
get_fiche
Get one owned access sheet by id (same fields as list_fiches). Requires Bearer.
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}}}
list_fiches
List access sheets owned by the authenticated agent. Requires Authorization: Bearer.
输入模式
{'type': 'object', 'properties': {}}
list_shares
List guest links for a fiche (token, url, expiresAt, viewCount, createdAt). Requires Bearer.
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}}}
list_webhooks
List webhook endpoints (secret is never returned). Fleet/Platform. Requires Bearer.
输入模式
{'type': 'object', 'properties': {}}
register_webhook
Fleet/Platform only. Register an HTTPS endpoint. Events: fiche.viewed, share.created, share.revoked, wifi.unlocked, quota.warning. HMAC SHA-256 in X-SesApp-Signature (t=unix,v1=hex of timestamp.body). Secret returned once. Max 5 endpoints. Requires Bearer.
输入模式
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'HTTPS URL (http://127.0.0.1 allowed in DEV)'}, 'events': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Subset of events. Default: all.'}}}
revoke_share
Revoke a guest share token. Optional delayDays (1–365) keeps the link until then (soft revoke). Requires Bearer.
输入模式
{'type': 'object', 'required': ['token'], 'properties': {'token': {'type': 'string'}, 'delayDays': {'type': 'number', 'description': 'If set, the link expires after N days instead of being deleted now.'}}}
share_fiche
Create a revocable guest link. Optional expiresAt (ISO). WiFi password is never in Markdown: guests unlock it within 150 m of lat/lon. Requires Bearer.
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'expiresAt': {'type': 'string', 'description': 'ISO datetime, optional. Omit for no expiry.'}}}
status
Current agent plan, expiry, fichesCount, maxFiches, overageUsdc. Requires Authorization: Bearer.
输入模式
{'type': 'object', 'properties': {}}
subscribe
Subscribe or renew. plan=agent (15 USDC, 20 sheets), fleet (79 USDC, 200), platform (250 USDC, fair-use). Send PAYMENT-SIGNATURE (x402 v2). Returns a Bearer JWT.
输入模式
{'type': 'object', 'properties': {'plan': {'enum': ['agent', 'fleet', 'platform'], 'type': 'string', 'description': 'SKU to purchase. Default agent.'}}}
update_fiche
Update an owned access sheet. Same fields as create_fiche. Typical: update instructions with photos/links. Requires Bearer.
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'lat': {'type': 'number', 'description': 'Cover map + WiFi geofence (150 m).'}, 'lon': {'type': 'number', 'description': 'Cover map + WiFi geofence (150 m).'}, 'name': {'type': 'string'}, 'locale': {'enum': ['fr', 'en'], 'type': 'string', 'description': 'Guest chrome language. Markdown stays as written. Omit to follow Accept-Language / ?lang=.'}, 'wifiName': {'type': 'string', 'description': 'SSID for sesapp:wifi. Hidden until 150 m if wifiPassword is set.'}, 'accessCode': {'type': 'string', 'description': 'Shown on the generated cover.'}, 'phoneNumber': {'type': 'string', 'description': 'Required for sesapp:contact. E.164 preferred.'}, 'instructions': {'type': 'string', 'description': 'Markdown flip-book shown to the guest (this field).\nCover (map, name, formattedAddress, accessCode) is generated — do not repeat it here.\nSplit pages with a line containing only --- .\nSupported: # ## ### headings, paragraphs, **bold**, *italic*, - / 1. lists, [label](https://...), ![alt](https://...).\nPhotos: https URLs (GCS via the host app, or your own CDN). Agents send URLs, no file upload.\nNever put wifiPassword in Markdown; it is unlocked only within 150 m via GPS.\nIntent hrefs: sesapp:wifi (needs wifiName + wifiPassword) and sesapp:contact (needs phoneNumber). Guest-facing labels: [Ajouter le WiFi] / [Ajouter le contact].\nIf you omit those links but set the fields, SesApp appends WiFi/contact pages.\nExample:\n# Bienvenue\nParking au fond à gauche.\n\n![Façade](https://example.com/facade.jpg)\n\n---\n\n## Arrivée\nSonnette à gauche.\n\n[Itinéraire](https://maps.google.com/?q=48.8566,2.3522)\n\n---\n\n[Ajouter le WiFi](sesapp:wifi)\n\n---\n\n[Ajouter le contact](sesapp:contact)'}, 'wifiPassword': {'type': 'string', 'description': 'Do not put in instructions. Unlocked within 150 m.'}, 'formattedAddress': {'type': 'string'}}}
update_webhook
Update url, events, or active. Fleet/Platform. Requires Bearer.
输入模式
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'active': {'type': 'boolean'}, 'events': {'type': 'array', 'items': {'type': 'string'}}}}
已添加
delete_webhook
2026年9月17日 12:39
已添加
update_webhook
2026年9月17日 12:39
已添加
list_webhooks
2026年9月17日 12:39
已添加
register_webhook
2026年9月17日 12:39
已添加
revoke_share
2026年9月17日 12:39
已添加
list_shares
2026年9月17日 12:39
已添加
share_fiche
2026年9月17日 12:39
已添加
delete_fiche
2026年9月17日 12:39
已添加
update_fiche
2026年9月17日 12:39
已添加
get_fiche
2026年9月17日 12:39
已添加
create_fiche
2026年9月17日 12:39
已添加
list_fiches
2026年9月17日 12:39
已添加
geocode
2026年9月17日 12:39
已添加
status
2026年9月17日 12:39
已添加
subscribe
2026年9月17日 12:39