Ρύθμισέ το σε ένα λεπτό

Αντίγραψε το API token σου από τις ρυθμίσεις του λογαριασμού σου.
Διάλεξε το εργαλείο σου παρακάτω και επικόλλησε το απόσπασμα, αντικαθιστώντας το δείγμα token με το δικό σου.
Επανεκκίνησε το εργαλείο AI σου και ρώτησέ το κάτι σαν: «Ποιο είναι το πιθανό γένος του ονόματος Andrea στην Ιταλία;»

Τρέξε αυτή τη μία εντολή στο terminal — αυτή είναι όλη η ρύθμιση.

claude mcp add --transport http --header "Authorization: Bearer YOUR_API_TOKEN" gender-api https://mcp.gender-api.com

Πρόσθεσε --scope user για να είναι το Gender-API διαθέσιμο σε όλα τα projects σου και όχι μόνο στο τρέχον.

Το Claude Desktop συνδέεται μέσω μιας μικρής γέφυρας npm που κατεβαίνει αυτόματα. Πρόσθεσε αυτό στο αρχείο ρυθμίσεών σου — δεν χρειάζεται χειροκίνητη εγκατάσταση.

{
  "mcpServers": {
    "gender-api": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.gender-api.com",
        "--header",
        "Authorization:Bearer YOUR_API_TOKEN"
      ]
    }
  }
}

Θέση του αρχείου ρυθμίσεων:

macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json

Γράψε Authorization:Bearer χωρίς κενό μετά την άνω κάτω τελεία — έτσι το περιμένει η γέφυρα.

Πρόσθεσε αυτό στο ~/.cursor/mcp.json για όλα τα projects, ή στο .cursor/mcp.json μέσα σε ένα μόνο project.

{
  "mcpServers": {
    "gender-api": {
      "url": "https://mcp.gender-api.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Πρόσθεσε αυτό στο .vscode/mcp.json του project σου, ή στο mcp.json σε επίπεδο χρήστη για να το ενεργοποιήσεις παντού.

{
  "servers": {
    "gender-api": {
      "type": "http",
      "url": "https://mcp.gender-api.com",
      "requestInit": {
        "headers": {
          "Authorization": "Bearer YOUR_API_TOKEN"
        }
      }
    }
  }
}

Το VS Code χρησιμοποιεί servers αντί για mcpServers και περιμένει τα headers μέσα στο requestInit. Η ίδια δομή δουλεύει σε Visual Studio και σε IDE της JetBrains.

Κάθε client που υποστηρίζει απομακρυσμένο MCP χρειάζεται μόνο αυτές τις τρεις τιμές:

Endpoint:  https://mcp.gender-api.com
Transport: streamable-http
Header:    Authorization: Bearer YOUR_API_TOKEN

Αν ο client σου υποστηρίζει μόνο τοπικούς MCP servers, χρησιμοποίησε τη γέφυρα npx mcp-remote που φαίνεται στην καρτέλα Claude Desktop — δουλεύει με κάθε client που μιλάει μόνο stdio.

Χρησιμοποιήστε το Gender-API απευθείας μέσα σε εργαλεία AI

Ο MCP Server μας επιτρέπει στα εργαλεία AI συμβατά με το MCP να καλούν απευθείας το Gender-API. Αυτό σημαίνει ότι ο βοηθός σας μπορεί να εμπλουτίσει προ නම්ωντα, πλήρη ονόματα, ονόματα από διευθύνσεις email και δεδομένα χώρας προέλευσης μέσω δομημένων κλήσεων εργαλείων, αντί για οδηγίες μόνο μέσω prompt.

Δεν υπάρχει τίποτα να εγκαταστήσεις και τίποτα να φιλοξενήσεις: στρέψε το εργαλείο σου στο https://mcp.gender-api.com και κάνε έλεγχο ταυτότητας με το ίδιο Gender-API token που χρησιμοποιείς ήδη για το API.

Τι μπορούν να κάνουν οι πελάτες μαζί του

Χρήση ζωντανών δεδομένων από το Gender-API: Το εργαλείο AI σας μπορεί να αναζητά ζωντανά αποτελέσματα από το Gender-API αντί να επινοεί μορφές αιτημάτων ή απαντήσεων.
Επαναχρησιμοποίηση του υπάρχοντος token σας: Ο διακομιστής MCP λειτουργεί με το ίδιο bearer token του Gender-API που χρησιμοποιείτε ήδη για το API.
Σύνδεση συμβατών πελατών (clients) MCP: Μπορείτε να το χρησιμοποιήσετε στο Claude, το Cursor ή στα δικά σας εσωτερικά εργαλεία και agents συμβατά με MCP που υποστηρίζουν hosted MCP URLs.
Διατηρήστε την τιμολόγηση απλή: Η κανονική χρήση credits του Gender-API εξακολουθεί να ισχύει, επομένως δεν υπάρχει δεύτερο σύστημα τιμολόγησης προς μάθηση.

Υποστηριζόμενα εργαλεία

Συμπεριλαμβανόμενα εργαλεία MCP

query_first_name – Αναζήτηση πιθανού φύλου με βάση το όνομα.
query_full_name – Αναζήτηση πιθανού φύλου με βάση το πλήρες όνομα.
query_email – Εξαγωγή και εμπλουτισμός ονόματος από μια διεύθυνση email.
get_country_of_origin – Λήψη πιθανών χωρών προέλευσης.
get_statistics – Έλεγχος των υπολοίπων credits και των στατιστικών του λογαριασμού.

Hosted transport

Χρησιμοποίησε το φιλοξενούμενο endpoint Streamable HTTP στο https://mcp.gender-api.com και κάνε έλεγχο ταυτότητας με το υπάρχον Gender-API bearer token σου.

Πραγματικές περιπτώσεις χρήσης MCP

Εμπλουτισμός leads εντός AI copilots

Αφήστε το Claude, το Cursor ή έναν εσωτερικό πωλητή (sales agent) να εξετάσει μια λίστα leads, να καλέσει το Gender-API μέσω MCP και να προσθέσει πιθανά ονόματα, φύλο και context χώρας προέλευσης πριν την προσέγγιση.

Εξατομίκευση CRM και υποστήριξης

Ο βοηθός υποστήριξής σας μπορεί να ελέγχει εισερχόμενες διευθύνσεις email, να εξα extracts πιθανά ονόματα με το `query_email` και να δημιουργεί πιο φυσικές, εξατομικευμένες προτάσεις απαντήσεων για τους πράκτορες.

Πράκτορες καθαρισμού και έρευνας σε υπολογιστικά φύλλα

Πράκτορες καθαρισμού δεδομένων με υποστήριξη MCP μπορούν να αναθεωρήσουν αρχεία CSV ή υπολογιστικά φύλλα, να τυποποιήσουν τις στήλες με τα ονόματα και να εμπλουτίσουν τις γραμμές με αποτελέσματα από το Gender-API χωρίς να χρειάζεται ειδικός κώδικας API σε κάθε ροή εργασίας.

Αυτοματοποίηση και τμηματοποίηση marketing

Χρησιμοποιήστε το MCP σε βοηθούς δημιουργίας καμπανιών για να δημιουργήσετε προσφωνήσεις, να εμπλουτίσετε τα δεδομένα επικοινωνίας και να ελέγξετε τα διαθέσιμα credits πριν ξεκινήσετε μια ροή εργασίας εξατομίκευσης.

Φτιάχνεις τον δικό σου MCP client;

Σύνδεση με το επίσημο MCP SDK

Αν γράφεις τον δικό σου agent αντί να χρησιμοποιήσεις ένα έτοιμο εργαλείο, σύνδεσε απευθείας το transport Streamable HTTP:

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',
    },
  },
});

Συχνές Ερωτήσεις

01

Χρησιμοποιεί αυτό τα κανονικά μου credits του Gender-API;

Ναι. Ο διακομιστής MCP είναι ένα λεπτό στρώμα ολοκλήρωσης πάνω στα υπάρχοντα endpoints του Gender-API, επομένως ισχύουν οι κανονικές άδειες token και η χρήση credits.

02

Μπορώ να το χρησιμοποιήσω στο δικό μου εσωτερικό εργαλείο MCP;

Ναι. Αν το εργαλείο σου υποστηρίζει φιλοξενούμενο MCP, σύνδεσέ το στο https://mcp.gender-api.com και στείλε το Gender-API bearer token σου.

03

Χρειάζεται να εγκαταστήσω κάτι;

Όχι. Τον MCP server τον φιλοξενούμε εμείς, οπότε δεν υπάρχει τίποτα να κατεβάσεις ή να κρατάς σε λειτουργία. Οι clients που υποστηρίζουν μόνο τοπικούς MCP servers χρησιμοποιούν τη γέφυρα npx mcp-remote, που κατεβαίνει μόνη της στην πρώτη εκκίνηση.

04

Το εργαλείο AI μου δεν δείχνει τα εργαλεία Gender-API. Τι κάνω τώρα;

Επανεκκίνησε το εργαλείο αφού αλλάξεις τις ρυθμίσεις του και έλεγξε ξανά ότι αντικατέστησες το δείγμα token με το πραγματικό API token σου. Αν η σύνδεση απορρίπτεται, το token σου είναι άκυρο ή έχει μείνει χωρίς credits — και τα δύο εμφανίζονται ως σφάλμα ελέγχου ταυτότητας.

Φιλοξενούμενος MCP Server