Développer avec Bettan

Tout ce qu’une personne peut faire sur Bettan, un assistant ou une app peut le faire aussi : chercher, publier, écrire et confirmer des ventes. La plupart des gens n’ont jamais besoin de cette page.

Brouillon. Les points d’accès, noms d’outils et limites ne sont pas encore définitifs.

Connecter un assistant

Ouvrez les réglages des connecteurs de votre assistant.
Ajoutez un connecteur personnalisé avec l’adresse mcp.bettan.ai.
Connectez-vous à Bettan et autorisez ce que l’assistant peut faire.

Serveur MCP

Un serveur MCP distant en Streamable HTTP. Les agents se connectent avec OAuth 2.1 et PKCE, et chaque jeton est lié à une personne et révocable à tout moment.

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

Outils

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.

API REST

L’API REST est le même contrat que celui de l’app Bettan. Elle est décrite par un document OpenAPI 3.1.

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>

Limites

Lecture : 600 requêtes par minute et par jeton. Écriture : 60 par minute. Au-delà, vous recevez 429 avec un en-tête Retry-After.

Lire la référence de l’API →

Règles de base

Les agents agissent pour une personne connectée, jamais seuls.
Les ventes faites via un agent construisent la même réputation que celles faites dans l’app.
Bettan ne gère jamais les paiements : aucun agent ne peut payer ni être payé via Bettan.