Stripe — pagamenti e abbonamenti

stripe

Come funziona

Quando colleghi questo connettore a un agente, l’agente non impara gli strumenti a memoria: se li fa dire, e li usa quando servono. Per questo un connettore aggiornato porta strumenti nuovi senza che l’agente vada rifatto.

Durante una conversazione il giro e’ sempre lo stesso: l’agente capisce dalla tua richiesta quale strumento serve e con quali valori usarlo, il gateway lo esegue e restituisce il risultato, e l’agente te lo racconta a parole. Chi compie l’operazione resti tu: l’accesso avviene con credenziali verificate, cosi’ il connettore puo’ distinguere cosa e’ permesso a te da cosa e’ permesso a un altro.

Il giro completo, con questo connettore

  1. Chiedi all’agente qualcosa che ha bisogno di Stripe — pagamenti e abbonamenti — per esempio una delle richieste qui sopra.
  2. L’agente si fa dare l’elenco degli strumenti e vi trova, fra gli altri, account-summaryrevenue-summarylist-payments.
  3. Sceglie quello adatto e lo esegue, riempiendo i valori con quello che gli hai detto (o chiedendoteli, se gli mancano):
    {
      "tool": "account-summary",
      "parameters": {}
    }
  4. Il gateway esegue lo strumento e restituisce il risultato: l’agente non te lo mostra grezzo, te lo racconta — e se serve incatena piu’ strumenti di fila per arrivare a quello che hai chiesto.

Gli strumenti di questo connettore

13 strumenti. Non li chiami tu: li sceglie l’agente in base a quello che gli chiedi. Servono a farti capire cosa puoi aspettarti e quali informazioni ti verranno chieste. L’elenco effettivo puo’ variare con la configurazione del collegamento.

account-summary

Stato del conto Stripe: nome attivita, valuta, se e un account di prova o reale, saldo disponibile e importi in arrivo. Da usare come prima verifica.

La chiamata che parte
{
  "tool": "account-summary",
  "parameters": {}
}
revenue-summary

Quanto ha incassato l attivita in un periodo, con confronto sul periodo precedente e numero di pagamenti. Preferiscilo a list-payments quando la domanda e "quanto ho incassato".

Puo’ usare: periodo

La chiamata che parte
{
  "tool": "revenue-summary",
  "parameters": {
    "periodo": "<string>"
  }
}
list-payments

Elenco dei pagamenti ricevuti, dal piu recente. Filtri per stato e periodo. Restituisce importi gia convertiti in unita di valuta (non centesimi).

Puo’ usare: stato da a cliente limite

La chiamata che parte
{
  "tool": "list-payments",
  "parameters": {
    "stato": "<string>",
    "da": "<string>",
    "a": "<string>"
  }
}
list-customers

Elenco dei clienti registrati su Stripe, oppure ricerca per email.

Puo’ usare: email limite

La chiamata che parte
{
  "tool": "list-customers",
  "parameters": {
    "email": "<string>",
    "limite": "<integer>"
  }
}
list-subscriptions

Abbonamenti dell account, con piano, importo ricorrente e data del prossimo rinnovo.

Puo’ usare: stato limite

La chiamata che parte
{
  "tool": "list-subscriptions",
  "parameters": {
    "stato": "<string>",
    "limite": "<integer>"
  }
}
subscriptions-renewing

Abbonamenti che si rinnovano (o scadono) entro un certo numero di giorni: serve per avvisare i clienti o prevedere gli incassi.

Puo’ usare: giorni

La chiamata che parte
{
  "tool": "subscriptions-renewing",
  "parameters": {
    "giorni": "<integer>"
  }
}
list-invoices

Fatture emesse. Con stato "non_pagate" restituisce gli insoluti da recuperare, con importo e da quanti giorni sono scaduti.

Puo’ usare: stato limite

La chiamata che parte
{
  "tool": "list-invoices",
  "parameters": {
    "stato": "<string>",
    "limite": "<integer>"
  }
}
list-disputes

Contestazioni e storni aperti dai clienti: importo, motivo e scadenza per rispondere.

Puo’ usare: limite

La chiamata che parte
{
  "tool": "list-disputes",
  "parameters": {
    "limite": "<integer>"
  }
}
list-payouts

Versamenti di Stripe verso il conto bancario: importo, stato e data prevista di arrivo.

Puo’ usare: limite

La chiamata che parte
{
  "tool": "list-payouts",
  "parameters": {
    "limite": "<integer>"
  }
}
list-catalog

Prodotti e prezzi configurati su Stripe: serve per sapere cosa si puo vendere e con quale prezzo (l id del prezzo si usa per creare abbonamenti e link di pagamento).

Puo’ usare: limite

La chiamata che parte
{
  "tool": "list-catalog",
  "parameters": {
    "limite": "<integer>"
  }
}
mrr-summary

Fotografia degli abbonamenti: ricavo ricorrente mensile, quanti abbonati attivi e in prova, quanti insoluti e quanti hanno disdetto.

La chiamata che parte
{
  "tool": "mrr-summary",
  "parameters": {}
}
access-summary

Chi ha accesso a QUESTO agente: utenti conosciuti, quanti hanno un accesso valido, come sono distribuiti per stato e quale quota di prova e attiva.

La chiamata che parte
{
  "tool": "access-summary",
  "parameters": {}
}
setup-status

Diagnosi della configurazione: dice se la chiave funziona, se il webhook e collegato davvero su Stripe, se il prezzo da vendere esiste e cosa manca per poter incassare. Chiamalo PRIMA di promettere al titolare che puo vendere, e ogni volta che un pagamento non si trasforma in accesso.

La chiamata che parte
{
  "tool": "setup-status",
  "parameters": {}
}

Elenco rilevato il 11/08/2026.

Guida all'uso del connettore MCP «Stripe — pagamenti e abbonamenti» su AIsuru. Tutti i connettori.