# Enrich

```json
{
  "name": "Enrich",
  "slug": "enrich",
  "url": "https://composio.dev/toolkits/enrich",
  "markdown_url": "https://composio.dev/toolkits/enrich.md",
  "logo_url": "https://logos.composio.dev/api/enrich",
  "categories": [
    "sales & customer support"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-08-21T05:28:22.564Z"
}
```

![Enrich logo](https://logos.composio.dev/api/enrich)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Enrich MCP or direct API to validate emails, discover contacts, enrich profiles, and research leads through natural language.

## Summary

Enrich is an organization-scoped API platform for email validation, contact discovery, profile enrichment, lead research, and credit management.
It helps teams turn sparse lead data into usable, verified prospect intelligence.

## Categories

- sales & customer support

## Toolkit Details

- Tools: 14

## Images

- Logo: https://logos.composio.dev/api/enrich

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Enrich.
  - Setup:
    - Configure Api Key credentials for Enrich.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Validate prospect emails before sales outreach
- Enrich leads from company domain lists
- Find contacts for target accounts

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `ENRICH_BATCH_FIND_WORK_EMAILS` | Batch Find Work Emails | Submit 1-100 people for asynchronous work-email finding, reserve up to 10 credits per case-insensitively unique lead, poll the batch to completed or failed, fetch all results, and settle or refund no-result reservations before returning. |
| `ENRICH_BATCH_LOOKUP_PEOPLE_BY_EMAIL` | Batch Lookup People by Email | Submit 1-100 emails for asynchronous professional-profile lookup, reserve up to 10 credits per case-insensitively unique email, poll the batch to completed or failed, fetch all found profiles, and settle or refund no-match reservations before returning. |
| `ENRICH_BATCH_VALIDATE_EMAILS` | Batch Validate Emails | Submit 1-100 emails as one asynchronous Enrich validation batch, reserving up to 1 credit per case-insensitively unique email. This call creates the job once, polls it to completed or failed, then fetches every result to settle charges and refund unused reservations before returning. |
| `ENRICH_COUNT_LEADS` | Count Leads | Count leads matching Enrich Lead Finder filters without returning lead records. The count field is capped at 500,000; use searched_total_result for the wider searched population when present. |
| `ENRICH_FIND_COMPANY_EMPLOYEES` | Find Company Employees | Find employees at a company from its LinkedIn URL, optionally filtering by geography and role. Returns one page at a time with at most 100 profiles. Enrich documents a cost of 1 credit per returned profile and no charge when no profiles are returned. |
| `ENRICH_FIND_WORK_EMAIL` | Find Work Email | Find a person's professional email from their first name, last name, and company domain. A successful match is documented to cost 10 credits; no-result calls are refunded. |
| `ENRICH_GET_CREDIT_BALANCE` | Get Credit Balance | Return the connected organization's current Enrich credit balance and the time it was measured. Use this before credit-metered enrichment calls when cost or available balance matters. |
| `ENRICH_GET_LEAD_FILTER_OPTIONS` | Get Lead Filter Options | Return Enrich's current Lead Finder option catalog, keyed by filter name, for constructing count and search filters. |
| `ENRICH_LIST_CREDIT_TRANSACTIONS` | List Credit Transactions | Return one page of credit top-ups and charges for the connected organization, optionally filtered by transaction type. |
| `ENRICH_LOOKUP_PERSON_BY_EMAIL` | Lookup Person by Email | Look up a professional profile from one email address. A found profile is documented to cost 10 credits; no-profile calls are refunded and results may be cached for seven days. |
| `ENRICH_RESUME_BATCH` | Resume Existing Batch | Recover an existing validation, work-email, or people-lookup batch after a timeout or interrupted call. This read-only recovery never submits a batch: it polls the selected fixed status endpoint to completed or failed, then fetches exactly one requested results page to settle reservations. Use the returned pagination metadata to recover additional pages without truncation. |
| `ENRICH_SEARCH_COMPANY_ICP` | Search Company ICP | Run Enrich's ranked cascade search for ideal-customer-profile employees at one company. Enrich documents a cost of 1 credit per returned profile and no charge for zero results; use a modest max_results or check the credit balance first. |
| `ENRICH_SEARCH_LEADS` | Search Leads | Return one page of leads matching Lead Finder filters. Free-tier results may mask names and consume a separate free-query allowance; the response reports the remaining allowance and applicable page and result limits. |
| `ENRICH_VALIDATE_EMAIL` | Validate Email | Check one email address for deliverability and return Enrich's result, confidence, provider, catch-all signal, and credit usage. The endpoint is documented to cost 1 credit, although unsuccessful or inconclusive checks may consume zero credits. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```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');
```

#### Path 1, Step 3: Execute Enrich Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Enrich actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Validate sarah@acme.com and enrich the contact profile with company details'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Validate sarah@acme.com and enrich the contact profile with company details'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK for Python or TypeScript
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Initialize Client and Create Tool Router Session

Import and initialize the Composio client, then create a Tool Router session for Enrich
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```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}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent (Anthropic Claude or Mastra)
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Enrich tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Find contacts for acme.com and enrich each profile with available role and company data')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```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: 'Find contacts for acme.com and enrich each profile with available role and company data'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Enrich Integration

- Supports both Enrich MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable email validation, contact discovery, and enrichment workflows
- Rich coverage for querying lead data, researching prospects, checking credits, and enriching profiles without custom glue code

### 2. Managed Auth

- Securely store Enrich API keys instead of hard-coding them in agent code
- Central place to manage, scope, and revoke Enrich access across users and environments
- Use auth_configs.create() and connected_accounts.link() to connect Enrich accounts cleanly for each user

### 3. Agent Optimized Design

- Tools are tuned for AI agents, so lead enrichment and email validation calls are easier for models to choose and execute
- Comprehensive execution logs show what lead data was queried, when it ran, and on whose behalf
- Cleaner schemas mean fewer brittle prompts and fewer failed enrichment runs

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Enrich
- Scoped, least privilege access for prospect research, profile enrichment, and credit usage
- Full audit trail of agent actions to support review, debugging, and compliance

## Use Enrich with any AI Agent Framework

Choose a framework you want to connect Enrich with:

None listed.

## Related Toolkits

- [Aeroleads](https://composio.dev/toolkits/aeroleads) - Aeroleads is a B2B lead generation platform for finding business emails and phone numbers. Grow your sales pipeline faster with powerful prospecting tools.
- [Autobound](https://composio.dev/toolkits/autobound) - Autobound is an AI-powered sales engagement platform that crafts hyper-personalized outreach and insights. It helps sales teams boost response rates and close more deals through tailored content and recommendations.
- [Better proposals](https://composio.dev/toolkits/better_proposals) - Better Proposals is a web-based tool for crafting and sending professional proposals. It helps teams impress clients and close deals faster with slick, easy-to-use templates.
- [Bidsketch](https://composio.dev/toolkits/bidsketch) - Bidsketch is a proposal software that helps businesses create professional proposals quickly and efficiently. It streamlines the proposal process, saving time while boosting client win rates.
- [Bolna](https://composio.dev/toolkits/bolna) - Bolna is an AI platform for building conversational voice agents. It helps businesses automate support and streamline interactions through natural, voice-powered conversations.
- [Botdog](https://composio.dev/toolkits/botdog) - Botdog is a LinkedIn outreach platform for managing campaigns, leads, messages, analytics, and sending accounts. It helps sales teams run outbound workflows and track performance from one place.
- [BotPenguin](https://composio.dev/toolkits/botpenguin) - BotPenguin is an AI chatbot platform for customer messaging, contacts, and conversations. It helps teams manage bot-led support and lead engagement across channels.
- [Botsonic](https://composio.dev/toolkits/botsonic) - Botsonic is a no-code AI chatbot builder for easily creating and deploying chatbots to your website. It empowers businesses to offer conversational experiences without writing code.
- [Botstar](https://composio.dev/toolkits/botstar) - BotStar is a comprehensive chatbot platform for designing, developing, and training chatbots visually on Messenger and websites. It helps businesses automate conversations and customer interactions without coding.
- [Callerapi](https://composio.dev/toolkits/callerapi) - CallerAPI is a white-label caller identification platform for branded caller ID and fraud prevention. It helps businesses boost customer trust while stopping spam, fraud, and robocalls.
- [Callingly](https://composio.dev/toolkits/callingly) - Callingly is a lead response management platform that automates immediate call and text follow-ups with new leads. It helps sales teams boost response speed and close more deals by connecting seamlessly with CRMs and lead sources.
- [Callpage](https://composio.dev/toolkits/callpage) - Callpage is a lead capture platform that lets businesses instantly connect with website visitors via callback. It boosts lead generation and increases your sales conversion rates.
- [Charla](https://composio.dev/toolkits/charla) - Charla is a live chat and AI customer-support platform for property teams. It helps manage guest conversations, property contacts, and support knowledge.
- [Chatforma](https://composio.dev/toolkits/chatforma) - Chatforma is a chatbot automation platform for building and managing bots. It helps teams run dialogs, segments, broadcasts, forms, and user updates from one place.
- [Clearout](https://composio.dev/toolkits/clearout) - Clearout is an AI-powered service for verifying, finding, and enriching email addresses. It boosts deliverability and helps you discover high-quality leads effortlessly.
- [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time.
- [Convolo ai](https://composio.dev/toolkits/convolo_ai) - Convolo ai is an AI-powered communications platform for sales teams. It accelerates lead response and improves conversion rates by automating calls and integrating workflows.
- [Crisp](https://composio.dev/toolkits/crisp) - Crisp is a customer messaging platform for live chat, contacts, helpdesk, and campaigns. It helps support teams manage customer conversations from one shared workspace.
- [Delighted](https://composio.dev/toolkits/delighted) - Delighted is a customer feedback platform based on the Net Promoter System®. It helps you quickly gather, track, and act on customer sentiment.
- [Docsbot ai](https://composio.dev/toolkits/docsbot_ai) - Docsbot ai is a platform that lets you build custom AI chatbots trained on your documentation. It automates customer support and content generation, saving time and improving response quality.

## Frequently Asked Questions

### Do I need my own developer credentials to use Enrich with Composio?

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

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

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

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)