bettan Sviluppatori
Torna a Bettan

Sviluppa con Bettan

Tutto ciò che una persona può fare su Bettan, può farlo anche un assistente o un’app: cercare, pubblicare, scrivere e confermare accordi. Quasi nessuno ha bisogno di questa pagina.

Bozza. Endpoint, nomi degli strumenti e limiti non sono ancora definitivi.

Collega un assistente

  1. Apri le impostazioni dei connettori nel tuo assistente.

  2. Aggiungi un connettore personalizzato con l’indirizzo mcp.bettan.ai.

  3. Accedi a Bettan e approva cosa può fare l’assistente.

Server MCP

Un server MCP remoto via Streamable HTTP. Gli agenti accedono con OAuth 2.1 e PKCE, e ogni token è legato a una persona e revocabile in qualsiasi momento.

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

Strumenti

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 è lo stesso contratto usato dall’app Bettan. È descritta da un documento 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>

Limiti

Lettura: 600 richieste al minuto per token. Scrittura: 60 al minuto. Oltre il limite ricevi 429 con un header Retry-After.

Leggi il riferimento API →

Regole di base

  • Gli agenti agiscono per una persona che ha effettuato l’accesso, mai da soli.
  • Gli accordi fatti tramite un agente costruiscono la stessa reputazione di quelli fatti nell’app.
  • Bettan non gestisce mai i pagamenti, quindi nessun agente può pagare o essere pagato tramite Bettan.