TrueList MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with TrueList MCP or direct API to validate email addresses, run batch validation jobs, monitor job status, and retrieve validation history through natural language.

TrueList logoTrueList
Api Key

TrueList is an email validation service for checking addresses, batch jobs, and validation history. Use it to keep lists clean, reduce bounces, and protect sender reputation.

8 Tools

Try TrueList now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
TrueList
Try asking
TOOLS

Supported Tools

Every TrueList action and event your agent gets out of the box.

Create Batch

Create an asynchronous TrueList batch email-validation job from tabular rows.

Delete Batch

Permanently delete one completed TrueList batch and its validation results.

Estimate Batch

Estimate email count, duplicates, and processing time for tabular batch data without creating a batch or consuming batch-validation credits.

Get Account

Return the connected TrueList user identity, account name, and payment plan without exposing API tokens or other account users.

Get Batch

Get one TrueList batch-validation job by UUID, including progress counts and completed result download URLs.

List Batches

List all batch-validation jobs in the connected TrueList account, including their current processing state, progress counts, and available result download URLs.

List Validation History

Return one page of previously validated email results, optionally filtered by batch, address, state, or sub-state.

Validate Email

Validate one email address synchronously, consume validation capacity, and add the result to TrueList validation history.

SETUP GUIDE

Connect TrueList MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for TrueList
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Validate jane.doe@example.com with TrueList and tell me whether it is deliverable'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect TrueList API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute TrueList Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Validate jane.doe@example.com with TrueList and tell me whether it is deliverable'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute TrueList actions with your Agent

Why Use Composio?

AI Native TrueList Integration

  • Supports both TrueList MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable email validation workflows
  • Rich coverage for validating addresses, managing batch jobs, and reading validation history

Managed Auth

  • Bring your own TrueList API key and let Composio store it securely
  • Central place to manage, scope, and revoke TrueList access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Clear schemas help agents validate single emails, launch batches, and check job results without guesswork
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access TrueList
  • Scoped, least privilege access to TrueList validation resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, TrueList requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with TrueList.It takes 30 seconds.

Managed auth, hosted MCP servers, and every TrueList tool your agent needs.Free to start.

Start building