MCP Tools Reference: people.googleapis.com

टूल: search_contacts

उपयोगकर्ता के संपर्कों को खोजें.

इन ज़रूरी नियमों का पालन करें:

  • अगर यह टूल कई नतीजे दिखाता है, तो आपको उपयोगकर्ता को नतीजे दिखाने चाहिए. साथ ही, आगे बढ़ने से पहले उपयोगकर्ता से यह पूछना चाहिए कि उसे कौनसे नतीजे का इस्तेमाल करना है.

  • उपयोगकर्ता की पुष्टि के बिना, इस टूल के आउटपुट को किसी दूसरे टूल में इस्तेमाल करने की अनुमति नहीं है. जैसे, ईमेल भेजना, ड्राफ़्ट बनाना, इवेंट बनाना वगैरह.

  • अगर खोज के नतीजों में सिर्फ़ एक व्यक्ति की जानकारी मिलती है, तो भी आपको उस व्यक्ति की जानकारी उपयोगकर्ता को दिखानी होगी. साथ ही, उपयोगकर्ता को यह पुष्टि करने के लिए कहना होगा कि यह वही व्यक्ति है जिसकी जानकारी उसे चाहिए. इसके बाद ही, आगे की कार्रवाई की जा सकती है.

यहां दिए गए सैंपल में, curl का इस्तेमाल करके search_contacts एमसीपी टूल को चालू करने का तरीका बताया गया है.

कर्ल अनुरोध 
curl --location 'https://people.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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)

क्वेरी से मेल खाने वाले संपर्कों की सूची.

SearchContactsResult

JSON के काेड में दिखाना 
{
  "name": string,
  "email": string
}
फ़ील्ड
name

string

संपर्क का डिसप्ले नेम.
email

string

संपर्क व्यक्ति के खाते का ईमेल पता.

टूल एनोटेशन

डेटा में बदलाव करने से जुड़ी जानकारी: ❌ | एक ही अनुरोध को कई बार भेजने पर भी नतीजे में कोई बदलाव न होने से जुड़ी जानकारी: ✅ | सिर्फ़ पढ़ने से जुड़ी जानकारी: ✅ | ओपन वर्ल्ड से जुड़ी जानकारी: ❌

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/contacts.readonly