## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.SIGN UP
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.LOG IN
Connect LangChain to Genderize MCP. Predict gender for a single first name, analyze gender breakdown for a list of names, and more using natural language, with authentication handled for you.
Genderize is an API that predicts a person's gender based on their first name. Get fast, statistically-backed gender info to power smart workflows and user experiences.
This guide walks you through connecting Genderize to LangChain using the Composio tool router. By the end, you'll have a working Genderize agent that can predict gender from first names through natural language commands.
This guide will help you understand how to give your LangChain agent real control over a Genderize account through Composio's Genderize MCP server.
Before we dive in, let's take a quick look at the key ideas and tools involved.
LangChain is a framework for developing applications powered by language models. It provides tools and abstractions for building agents that can reason, use tools, and maintain conversation context.
Key features include:
The Genderize MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Genderize account. It provides structured and secure access to gender prediction tools, so your agent can perform actions like analyzing names for gender, running batch predictions, and localizing results by country—all seamlessly on your behalf.
Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK
The tool router generates a secure MCP URL that your agents can access to perform actions.
The Composio SDK follows a three-phase workflow:
npm install @composio/langchain @langchain/core @langchain/openai @langchain/mcp-adapters dotenvInstall the required packages for LangChain with MCP support.
What's happening:
@composio/langchain provides Composio integration for LangChain@langchain/mcp-adapters enables MCP client connections@langchain/core is the core agent frameworkdotenv/config loads environment variablesCOMPOSIO_API_KEY=your_composio_api_key_here
COMPOSIO_USER_ID=your_composio_user_id_here
OPENAI_API_KEY=your_openai_api_key_hereCreate a .env file in your project root.
What's happening:
COMPOSIO_API_KEY authenticates your requests to Composio's APICOMPOSIO_USER_ID identifies the user for session managementOPENAI_API_KEY enables access to OpenAI's language modelsimport { Composio } from '@composio/core';
import { LangchainProvider } from '@composio/langchain';
import { MultiServerMCPClient } from "@langchain/mcp-adapters";
import { createAgent } from "langchain";
import * as readline from 'readline';
import 'dotenv/config';
dotenv.config();dotenv/config import loads environment variables from your .env fileconst composioApiKey = process.env.COMPOSIO_API_KEY;
const userId = process.env.COMPOSIO_USER_ID;
if (!composioApiKey) throw new Error('COMPOSIO_API_KEY is not set');
if (!userId) throw new Error('COMPOSIO_USER_ID is not set');
async function main() {
const composio = new Composio({
apiKey: composioApiKey as string,
provider: new LangchainProvider()
});COMPOSIO_API_KEY from environment variables and validating it existsCOMPOSIO_USER_ID is also set before proceedingconst session = await composio.create(
userId as string,
{
toolkits: ['genderize']
}
);
const url = session.mcp.url;create method takes the user ID and specifies which toolkits should be availablesession.mcp.url is the MCP server URL that your agent will useconst client = new MultiServerMCPClient({
"genderize-agent": {
transport: "http",
url: url,
headers: {
"x-api-key": process.env.COMPOSIO_API_KEY
}
}
});
const tools = await client.getTools();
const agent = createAgent({ model: "gpt-5", tools });MultiServerMCPClient that connects to our Genderize MCP server via HTTPgetTools() retrieves all available Genderize tools that the agent can uselet conversationHistory: any[] = [];
console.log("Chat started! Type 'exit' or 'quit' to end the conversation.\n");
console.log("Ask any Genderize related question or task to the agent.\n");
const rl = readline.createInterface({
input: process.stdin,
output: process.stdout,
prompt: 'You: '
});
rl.prompt();
rl.on('line', async (userInput: string) => {
const trimmedInput = userInput.trim();
if (['exit', 'quit', 'bye'].includes(trimmedInput.toLowerCase())) {
console.log("\nGoodbye!");
rl.close();
process.exit(0);
}
if (!trimmedInput) {
rl.prompt();
return;
}
conversationHistory.push({ role: "user", content: trimmedInput });
console.log("\nAgent is thinking...\n");
const response = await agent.invoke({ messages: conversationHistory });
conversationHistory = response.messages;
const finalResponse = response.messages[response.messages.length - 1]?.content;
console.log(`Agent: ${finalResponse}\n`);
rl.prompt();
});
rl.on('close', () => {
console.log('\n👋 Session ended.');
process.exit(0);
});conversationHistory list to maintain context across interactionsreadline interface is used to continuously accept user input from the command lineinvoke() method with the full conversation historymain().catch((err) => {
console.error('Fatal error:', err);
process.exit(1);
});main() function to start the applicationHere's the complete code to get you started with Genderize and LangChain:
import { Composio } from '@composio/core';
import { LangchainProvider } from '@composio/langchain';
import { MultiServerMCPClient } from "@langchain/mcp-adapters";
import { createAgent } from "langchain";
import * as readline from 'readline';
import 'dotenv/config';
const composioApiKey = process.env.COMPOSIO_API_KEY;
const userId = process.env.COMPOSIO_USER_ID;
if (!composioApiKey) throw new Error('COMPOSIO_API_KEY is not set');
if (!userId) throw new Error('COMPOSIO_USER_ID is not set');
async function main() {
const composio = new Composio({
apiKey: composioApiKey as string,
provider: new LangchainProvider()
});
const session = await composio.create(
userId as string,
{
toolkits: ['genderize']
}
);
const url = session.mcp.url;
const client = new MultiServerMCPClient({
"genderize-agent": {
transport: "http",
url: url,
headers: {
"x-api-key": process.env.COMPOSIO_API_KEY
}
}
});
const tools = await client.getTools();
const agent = createAgent({ model: "gpt-5", tools });
let conversationHistory: any[] = [];
console.log("Chat started! Type 'exit' or 'quit' to end the conversation.\n");
console.log("Ask any Genderize related question or task to the agent.\n");
const rl = readline.createInterface({
input: process.stdin,
output: process.stdout,
prompt: 'You: '
});
rl.prompt();
rl.on('line', async (userInput: string) => {
const trimmedInput = userInput.trim();
if (['exit', 'quit', 'bye'].includes(trimmedInput.toLowerCase())) {
console.log("\nGoodbye!");
rl.close();
process.exit(0);
}
if (!trimmedInput) {
rl.prompt();
return;
}
conversationHistory.push({ role: "user", content: trimmedInput });
console.log("\nAgent is thinking...\n");
const response = await agent.invoke({ messages: conversationHistory });
conversationHistory = response.messages;
const finalResponse = response.messages[response.messages.length - 1]?.content;
console.log(`Agent: ${finalResponse}\n`);
rl.prompt();
});
rl.on('close', () => {
console.log('\nSession ended.');
process.exit(0);
});
}
main().catch((err) => {
console.error('Fatal error:', err);
process.exit(1);
});You've successfully built a LangChain agent that can interact with Genderize through Composio's Tool Router.
Key features of this implementation:
Every Genderize action and event your agent gets out of the box.
Use Genderize MCP with Claude Code
Use Genderize MCP with Claude Cowork
Use Genderize MCP with OpenAI Agents SDK
Use Genderize MCP with Claude Agent SDK
Use Genderize MCP with Codex
Use Genderize MCP with OpenClaw
Use Genderize MCP with Hermes
Use Genderize MCP with Atomic Agent
Use Genderize MCP with Google ADK
Use Genderize MCP with Vercel AI SDK
Use Genderize MCP with Mastra AI
Use Genderize MCP with LlamaIndex
Use Genderize MCP with CrewAI
Use Genderize MCP with Pydantic AI
Use Genderize MCP with AutoGen
Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed.
Composio search is a unified web search toolkit spanning travel, e-commerce, news, financial markets, images, and more. It lets you and your apps tap into up-to-date web data from a single, easy-to-integrate service.
Perplexityai delivers natural, conversational AI models for generating human-like text. Instantly get context-aware, high-quality responses for chat, search, or complex workflows.
Browser tool is a virtual browser integration that lets AI agents interact with the web programmatically. It enables automated browsing, scraping, and action-taking from any AI workflow.
Managed auth, hosted MCP servers, and every Genderize tool your agent needs.Free to start.
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.Start building