ホスト型MCPサーバー
AIツール内でGender-APIを直接使用する
当社の MCP Server を使用すると、MCP互換のAIツールがGender-APIを直接呼び出すことができます。つまり、アシスタントはプロンプトのみの指示ではなく、構造化されたツール呼び出しを通じて、名前、フルネーム、メールアドレスから派生した名前、および原国データをエンリッチできます。
The easiest setup is the hosted Streamable HTTP endpoint at https://mcp.gender-api.com.
お客様はホスト型MCPエンドポイントに直接接続し、APIですでに使用しているものと同じGender-APIベアラートークンで認証します。
お客様ができること
- リアルタイムのGender-APIデータを使用する: お客様のAIツールは、リクエスト形式やレスポンスを捏造する代わりに、リアルタイムのGender-APIの結果を照会できます。
- 既存のトークンを再利用する: MCPサーバーは、既存のAPIで使用しているものと同じGender-APIベアラートークンで動作します。
- MCP互換クライアントを接続する: Claude、Cursor、またはホストされたMCP URLをサポートする独自の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コパイロット内でのリード拡充
Claude、Cursor、または内部のセールスエージェントにリードリストを確認させ、MCP経由でGender-APIを呼び出し、アウトリーチの前に推定される名前、性別、および出身国のコンテキストを追加させることができます。
CRMとサポートのパーソナライゼーション
お客様のサポートアシスタントは、受信したメールアドレスを検査し、`query_email` を使用して可能性の高い名前を抽出して、エージェントがより自然でパーソナライズされた返信の下書きを作成できるようにします。
スプレッドシートのクリーンアップおよびリサーチエージェント
MCP対応のデータクリーニングエージェントは、CSVファイルやスプレッドシートを確認し、名(first-name)の列を標準化し、各ワークフローにカスタムAPIコードを記述することなく、Gender-APIの結果を使用して行のデータを拡充できます。
マーケティングオートメーションとセグメンテーション
パーソナライゼーション・ワークフローを開始する前に、キャンペーン構築アシスタントでMCPを使用して、挨拶文の生成、連絡先データの拡充、および残りのクレジットの確認を行ってください。
お客様が自身のツールでどのように利用できるか
1. ホストされたMCPエンドポイントを使用する
お使いのAIプラットフォームがリモートMCPをサポートしている場合は、以下に記載されているホストされたエンドポイントを直接指定し、通常のGender-APIベアラートークンを使用して認証してください。
https://mcp.gender-api.com
2. 通常のAPIトークンで認証してください
ホストされたMCPは、すでにAPIで使用しているものと同じGender-APIトークンを使用します。リクエストヘッダーにベアラートークンとして送信してください。
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
これにより、オンボーディングはシンプルに保たれます。1つのホスト済みエンドポイント、1つのベアラートークン、そしてすべてのサポートされているMCPクライアント向けの1つのツールセットだけで済みます。
クライアント設定の例
本番用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 URLとベアラートークンヘッダーが必要です。
よくある質問
これは通常のGender-APIクレジットを使用しますか?
はい。MCPサーバーは既存のGender-APIエンドポイント上の軽量な統合レイヤーであるため、通常のトークン権限とクレジットの使用状況が引き続き適用されます。
自身の内部MCPツールで使用できますか?
Yes. If your tool supports hosted MCP, connect it to https://mcp.gender-api.com and send your Gender-API bearer token.