استخدم Gender-API مباشرة داخل أدوات الذكاء الاصطناعي

يتيح لنا MCP Server لأدوات الذكاء الاصطناعي المتوافقة مع MCP استدعاء Gender-API مباشرة. هذا يعني أن مساعدك يمكنه إثراء الأسماء الأولى، والأسماء الكاملة، والأسماء المستخرجة من البريد الإلكتروني، وبيانات بلد المنشأ من خلال استدعاءات أدوات منظمة بدلاً من التعليمات القائمة على الأوامر فقط.

The easiest setup is the hosted Streamable HTTP endpoint at https://mcp.gender-api.com.

يتصل العملاء مباشرة بنقطة نهاية MCP المستضافة ويتم المصادقة باستخدام نفس رمز Gender-API bearer الذي يستخدمونه بالفعل للـ API.

ما يمكن للعملاء القيام به باستخدامه

استخدم بيانات Gender-API المباشرة: يمكن لأداتك المدعومة بالذكاء الاصطناعي الاستعلام عن نتائج Gender-API المباشرة بدلاً من اختراع تنسيقات طلبات أو ردود.
أعد استخدام الرمز المميز (token) الحالي الخاص بك: يعمل خادم MCP بنفس الرمز المميز (bearer token) الخاص بـ Gender-API الذي تستخدمه بالفعل للواجهة البرمجية (API).
قم بتوصيل العملاء المتوافقين مع MCP: يمكنك استخدامه في Claude أو Cursor أو أدواتك وعوامل التشغيل الداخلية الخاصة بك المتوافقة مع MCP والتي تدعم روابط MCP المستضافة.
حافظ على بساطة الفواتير: لا يزال استهلاك رصيد Gender-API العادي سارياً، لذا لا يوجد نظام فواتير ثانٍ لتتعلمه.

الأدوات المدعومة

أدوات MCP المضمنة

query_first_name – الاستعلام عن الجنس المحتمل من خلال الاسم الأول.
query_full_name – الاستعلام عن الجنس المحتمل من خلال الاسم الكامل.
query_email – استخراج وإثراء الاسم من عنوان البريد الإلكتروني.
get_country_of_origin – الحصول على بلدان الأصل المحتملة.
get_statistics – التحقق من الرصيد المتبقي وإحصائيات الحساب.

النقل المستضاف

Use the hosted Streamable HTTP endpoint at https://mcp.gender-api.com and authenticate with your existing Gender-API bearer token.

حالات استخدام MCP في العالم الحقيقي

إثراء بيانات العملاء المحتملين داخل المساعد الذكي (AI copilots)

اسمح لـ Claude أو Cursor أو وكيل مبيعات داخلي بمراجعة قائمة العملاء المحتملين، واستدعاء Gender-API عبر MCP، وإضافة الاسم الأول والجنس وسياق بلد المنشأ المحتمل قبل التواصل.

تخصيص إدارة علاقات العملاء والدعم

يمكن لمساعد الدعم الخاص بك فحص عناوين البريد الإلكتروني الواردة، واستخراج الأسماء الأولى المحتملة باستخدام `query_email` ، وإنشاء مسودات ردود مخصصة وأكثر طبيعية للوكلاء.

وكلاء تنظيف وجداول البيانات والبحث

يمكن لوكلاء تنظيف البيانات المدعومين بـ MCP مراجعة ملفات CSV أو جداول البيانات، وتوحيد أعمدة الاسم الأول، وإثراء الصفوف بنتائج Gender-API دون الحاجة إلى كتابة كود API مخصص في كل سير عمل.

أتمتة التسويق وتجزئة الجمهور

استخدم MCP في مساعدي بناء الحملات لإنشاء التحيات، وإثراء بيانات الاتصال، والتحقق من الرصيد المتبقي قبل إطلاق سير عمل التخصيص.

كيف يمكن للعملاء استخدامه في أدواتهم الخاصة

1. استخدم نقطة نهاية MCP المستضافة

إذا كانت منصة الذكاء الاصطناعي الخاصة بك تدعم بروتوكول MCP عن بعد، فقم بتوجيهها مباشرة إلى نقطة النهاية المستضافة أدناه وقم بالمصادقة باستخدام رمز Gender-API bearer المعتاد الخاص بك.

https://mcp.gender-api.com

2. قم بالمصادقة باستخدام رمز API العادي الخاص بك

يستخدم Hosted MCP نفس رمز (token) الخاص بـ Gender-API الذي تستخدمه بالفعل للواجهة البرمجية. أرسله كرمز حامل (bearer token) في ترويسات الطلب.

Authorization: Bearer your-api-token

3. استدعِ أدوات Gender-API المرفقة

بعد تهيئة جلسة MCP المستضافة، يمكن لعميلك استدعاء أدوات Gender-API المدمجة لإجراء عمليات الإثراء الفوري والتحقق من الحسابات.

query_first_name
query_full_name
query_email
get_country_of_origin
get_statistics

هذا يحافظ على بساطة عملية الإعداد: نقطة نهاية مستضافة واحدة، ورمز حامل (bearer token) واحد، ومجموعة أدوات واحدة لجميع عملاء MCP المدعومين.

إعدادات العميل التجريبية

مثال SDK للإنتاج

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const transport = new StreamableHTTPClientTransport(new URL('https://mcp.gender-api.com'), {
  requestInit: {
    headers: {
      Authorization: 'Bearer your-api-token',
    },
  },
});

نمط تكوين عميل MCP للإنتاج

{
  "mcpServers": {
    "gender-api": {
      "transport": "streamable-http",
      "url": "https://mcp.gender-api.com",
      "headers": {
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}

تختلف أسماء الحقول الدقيقة حسب العميل، ولكن كل إعداد مستضاف يحتاج إلى نفس رابط MCP وheader bearer token.

الأسئلة الشائعة

01

هل يستخدم هذا رصيد Gender-API العادي الخاص بي؟

نعم. يعد خادم MCP طبقة تكامل رقيقة فوق نقاط نهاية Gender-API الحالية، لذا فإن أذونات الرمز المميز العادية واستهلاك الرصيد لا يزالان ساريين.

02

هل يمكنني استخدامه في أداة MCP الداخلية الخاصة بي؟

Yes. If your tool supports hosted MCP, connect it to https://mcp.gender-api.com and send your Gender-API bearer token.

خادم MCP مستضاف