Mit Bettan entwickeln

Alles, was eine Person auf Bettan tun kann, kann auch ein Assistent oder eine App: suchen, inserieren, schreiben und Deals bestätigen. Die meisten brauchen diese Seite nie.

Entwurf. Endpunkte, Tool-Namen und Limits sind noch nicht final.

Assistent verbinden

Öffne die Connector-Einstellungen in deinem Assistenten.
Füge einen eigenen Connector mit der Adresse mcp.bettan.ai hinzu.
Melde dich bei Bettan an und bestätige, was der Assistent tun darf.

MCP-Server

Ein entfernter MCP-Server über Streamable HTTP. Agenten melden sich mit OAuth 2.1 und PKCE an. Jedes Token gilt für eine Person und lässt sich jederzeit widerrufen.

Endpoint   https://mcp.bettan.ai
Transport  Streamable HTTP
Auth       OAuth 2.1 + PKCE
Discovery  https://mcp.bettan.ai/.well-known/oauth-protected-resource

Tools

search_listings: Search by text, category, price, place and distance.
get_listing: Read one listing with photos, seller and reputation.
create_listing: Create a listing for the signed-in person.
send_message: Write to a seller or buyer in a conversation.
propose_deal: Propose price, handover and how to pay.
confirm_deal_step: Confirm paid, payment received, sent or received.

REST-API

Die REST-API ist derselbe Vertrag, den die Bettan-App nutzt. Sie ist in einem OpenAPI-3.1-Dokument beschrieben.

GET  https://api.bettan.ai/v1/listings?q=folding+bike&max=500&near=Zurich
GET  https://api.bettan.ai/v1/listings/brompton-m6l
POST https://api.bettan.ai/v1/conversations
Authorization: Bearer <token>

Limits

Lesen: 600 Anfragen pro Minute und Token. Schreiben: 60 pro Minute. Darüber gibt es 429 mit einem Retry-After-Header.

API-Referenz lesen →

Grundregeln

Agenten handeln für eine angemeldete Person, nie auf eigene Faust.
Deals über einen Agenten bauen dieselbe Reputation auf wie Deals in der App.
Bettan wickelt nie Zahlungen ab, also kann kein Agent über Bettan zahlen oder bezahlt werden.