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.
When you connect this connector to an agent, the agent doesn’t learn its tools by heart: it is told what they are, and uses them when they are needed. That is why an updated connector brings new tools along without the agent having to be rebuilt.
During a conversation the loop is always the same: the agent works out from your request which tool is needed and with which values, the gateway runs it and returns the result, and the agent tells you in plain words. You remain the one performing the operation: access happens with verified credentials, so the connector can tell what you are allowed to do from what someone else is allowed to do.
list-collectionsfindfind-one.
{
"tool": "find",
"parameters": {
"collection": "<string>"
}
}
27 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. 27 tools. You don’t call them yourself: the agent picks them based on what you ask. They are here so you can see what to expect and which details you will be asked for. The actual list may vary depending on how the connection is configured.
list-collections
Lista collezioni nel database
List collections in the database
{
"tool": "list-collections",
"parameters": {}
}
find
Query con filtri su collezione
Query a collection with filters
Gli serve:It needs: collectionstring
Puo’ usare:It may use: filter projection sort limit skip
{
"tool": "find",
"parameters": {
"collection": "<string>"
}
}
find-one
Trova singolo documento
Gli serve:It needs: collectionstring
Puo’ usare:It may use: filter projection
{
"tool": "find-one",
"parameters": {
"collection": "<string>"
}
}
count
Conta documenti in collezione
Gli serve:It needs: collectionstring
Puo’ usare:It may use: filter
{
"tool": "count",
"parameters": {
"collection": "<string>"
}
}
distinct
Valori unici per un campo
Unique values for a field
Gli serve:It needs: collectionstring fieldstring
Puo’ usare:It may use: filter
{
"tool": "distinct",
"parameters": {
"collection": "<string>",
"field": "<string>"
}
}
aggregate
Pipeline di aggregazione
Gli serve:It needs: collectionstring pipelinearray
{
"tool": "aggregate",
"parameters": {
"collection": "<string>",
"pipeline": "<array>"
}
}
collection-schema
Schema della collezione
Schema of the collection
Gli serve:It needs: collectionstring
Puo’ usare:It may use: sample_size
{
"tool": "collection-schema",
"parameters": {
"collection": "<string>"
}
}
collection-indexes
Indici della collezione
Indexes of the collection
Gli serve:It needs: collectionstring
{
"tool": "collection-indexes",
"parameters": {
"collection": "<string>"
}
}
db-stats
Statistiche del database
Database statistics
{
"tool": "db-stats",
"parameters": {}
}
insert-one
Inserisci singolo documento
Gli serve:It needs: collectionstring documentobject
{
"tool": "insert-one",
"parameters": {
"collection": "<string>",
"document": "<object>"
}
}
insert-many
Inserisci multipli documenti
Gli serve:It needs: collectionstring documentsarray
{
"tool": "insert-many",
"parameters": {
"collection": "<string>",
"documents": "<array>"
}
}
update-one
Aggiorna singolo documento
Gli serve:It needs: collectionstring filterobject updateobject
Puo’ usare:It may use: upsert
{
"tool": "update-one",
"parameters": {
"collection": "<string>",
"filter": "<object>",
"update": "<object>"
}
}
update-many
Aggiorna multipli documenti
Gli serve:It needs: collectionstring filterobject updateobject
{
"tool": "update-many",
"parameters": {
"collection": "<string>",
"filter": "<object>",
"update": "<object>"
}
}
replace-one
Sostituisci singolo documento
Gli serve:It needs: collectionstring filterobject replacementobject
Puo’ usare:It may use: upsert
{
"tool": "replace-one",
"parameters": {
"collection": "<string>",
"filter": "<object>",
"replacement": "<object>"
}
}
delete-one
Elimina singolo documento
Gli serve:It needs: collectionstring filterobject
{
"tool": "delete-one",
"parameters": {
"collection": "<string>",
"filter": "<object>"
}
}
delete-many
Elimina multipli documenti
Gli serve:It needs: collectionstring filterobject
{
"tool": "delete-many",
"parameters": {
"collection": "<string>",
"filter": "<object>"
}
}
bulk-write
Operazioni bulk atomiche
Gli serve:It needs: collectionstring operationsarray
Puo’ usare:It may use: ordered
{
"tool": "bulk-write",
"parameters": {
"collection": "<string>",
"operations": "<array>"
}
}
create-collection
Crea nuova collezione
Gli serve:It needs: collectionstring
Puo’ usare:It may use: options
{
"tool": "create-collection",
"parameters": {
"collection": "<string>"
}
}
drop-collection
Elimina collezione
Gli serve:It needs: collectionstring
{
"tool": "drop-collection",
"parameters": {
"collection": "<string>"
}
}
rename-collection
Rinomina collezione
Gli serve:It needs: old_namestring new_namestring
{
"tool": "rename-collection",
"parameters": {
"old_name": "<string>",
"new_name": "<string>"
}
}
create-index
Crea indice
Gli serve:It needs: collectionstring keysobject
Puo’ usare:It may use: options
{
"tool": "create-index",
"parameters": {
"collection": "<string>",
"keys": "<object>"
}
}
drop-index
Elimina indice
Gli serve:It needs: collectionstring indexstring
{
"tool": "drop-index",
"parameters": {
"collection": "<string>",
"index": "<string>"
}
}
get-prompt
CHIAMALO ALL'INIZIO: ottieni istruzioni dinamiche, struttura collezioni, indici, best practices e quando usare create-data-view
CALL IT FIRST: get dynamic instructions, collection structure, indexes, best practices and when to use create-data-view
{
"tool": "get-prompt",
"parameters": {}
}
set-prompt
Salva/aggiorna prompt personalizzato per documentare come usare il database
Save/update a custom prompt to document how to use the database
Gli serve:It needs: contentstring
{
"tool": "set-prompt",
"parameters": {
"content": "<string>"
}
}
describe-collection
Documenta una collezione (descrizione, campi, convenzioni) e dichiara opzionalmente `indexes` e `retention_days` (TTL su created_at). Idempotente: applica solo gli indici mancanti.
Documents a collection (description, fields, conventions) and optionally declares `indexes` and `retention_days` (TTL on created_at). Idempotent: it applies only the missing indexes.
Gli serve:It needs: collectionstring descriptionstring
Puo’ usare:It may use: fields conventions examples indexes retention_days
{
"tool": "describe-collection",
"parameters": {
"collection": "<string>",
"description": "<string>"
}
}
create-data-view
suggest-indexes
Elenco rilevato il 11/08/2026. List observed on Aug 11, 2026.