MCP Tools Reference: people.googleapis.com

Инструмент: search_contacts

Поиск по контактам пользователя.

ВАЖНЫЕ ПРАВИЛА, КОТОРЫЕ НЕОБХОДИМО СОБЛЮДАТЬ:

  • Если инструмент выдает несколько результатов, следует отобразить их пользователю и попросить его уточнить, какой результат использовать, прежде чем продолжить.

  • Категорически запрещается передавать результаты работы этого инструмента в другой инструмент (например, для отправки электронного письма, создания черновика, создания события и т. д.) без явного подтверждения пользователя.

  • Даже если найден только один человек, необходимо отобразить его данные и предложить пользователю подтвердить, что это именно тот человек, которого вы искали, прежде чем переходить к дальнейшим действиям.

В следующем примере показано, как использовать curl для вызова инструмента search_contacts MCP.

Запрос 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
}'

Схема ввода

Запрос сообщения для SearchContacts.

SearchContactsMcpRequest

JSON-представление 
{
  "query": string,
  "maxResults": integer
}
Поля
query

string

Строка запроса для поиска.

maxResults

integer

Максимальное количество результатов. Значение по умолчанию — 10, максимально допустимое значение — 30.

Схема вывода

Ответное сообщение для SearchContacts.

SearchContactsMcpResponse

JSON-представление 
{
  "results": [
    {
      object (SearchContactsResult)
    }
  ]
}
Поля
results[]

object ( SearchContactsResult )

Список контактов, соответствующих запросу.

Результаты поиска контактов

JSON-представление 
{
  "name": string,
  "email": string
}
Поля
name

string

Отображаемое имя контакта.

email

string

Адрес электронной почты контактного лица.

Аннотации инструментов

Подсказка о разрушительном эффекте: ❌ | Подсказка об идемпотентности: ✅ | Подсказка только для чтения: ✅ | Подсказка об открытом мире: ❌