MCP Tools Reference: people.googleapis.com

Outil : search_contacts

Recherchez les contacts de l'utilisateur.

RÈGLES IMPORTANTES À SUIVRE :

  • Si cet outil renvoie plusieurs résultats, vous devez les présenter à l'utilisateur et lui demander de préciser celui à utiliser avant de continuer.

  • Il vous est strictement interdit de transmettre la sortie de cet outil à un autre outil (par exemple, pour envoyer un e-mail, créer un brouillon, créer un événement, etc.) sans la confirmation explicite de l'utilisateur.

  • Même si un seul résultat de personne est trouvé, vous devez présenter les informations de la personne trouvée à l'utilisateur et l'inviter à vérifier qu'il s'agit bien de la personne recherchée avant de poursuivre.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP search_contacts.

Requête curl 
curl --location 'https://people.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_contacts",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Message de requête pour SearchContacts.

SearchContactsMcpRequest

Représentation JSON 
{
  "query": string,
  "maxResults": integer
}
Champs
query

string

Chaîne de requête à rechercher.
maxResults

integer

Nombre maximal de résultats. La valeur par défaut est 10 et la valeur maximale autorisée est 30.

Schéma de sortie

Message de réponse pour SearchContacts.

SearchContactsMcpResponse

Représentation JSON 
{
  "results": [
    {
      object (SearchContactsResult)
    }
  ]
}
Champs
results[]

object (SearchContactsResult)

Liste des contacts correspondant à la requête.

SearchContactsResult

Représentation JSON 
{
  "name": string,
  "email": string
}
Champs
name

string

Nom à afficher du contact.
email

string

Adresse e-mail du compte du contact.

Annotations d'outils

Indication destructive : ❌ | Indication idempotente : ✅ | Indication en lecture seule : ✅ | Indication Open World : ❌