io.github.Opafex/mcp-enrichment
Multi-source entity enrichment: company data, contacts, email verification, and phone validation
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
@opafex/mcp-enrichmentclaude mcp add mcp-enrichment -e 'CLEARBIT_API_KEY=<your clearbit_api_key>' -e 'HUNTER_API_KEY=<your hunter_api_key>' -e 'APOLLO_API_KEY=<your apollo_api_key>' -e 'TWILIO_ACCOUNT_SID=<your twilio_account_sid>' -e 'TWILIO_AUTH_TOKEN=<your twilio_auth_token>' -e 'ENRICHMENT_CACHE_TTL=<ENRICHMENT_CACHE_TTL>' -- npx -y @opafex/mcp-enrichment@0.1.1
{
"mcpServers": {
"mcp-enrichment": {
"command": "npx",
"args": [
"-y",
"@opafex/mcp-enrichment@0.1.1"
],
"env": {
"CLEARBIT_API_KEY": "<your clearbit_api_key>",
"HUNTER_API_KEY": "<your hunter_api_key>",
"APOLLO_API_KEY": "<your apollo_api_key>",
"TWILIO_ACCOUNT_SID": "<your twilio_account_sid>",
"TWILIO_AUTH_TOKEN": "<your twilio_auth_token>",
"ENRICHMENT_CACHE_TTL": "<ENRICHMENT_CACHE_TTL>"
}
}
}
}
Environment variables
CLEARBIT_API_KEYsecret Clearbit API key for company and contact enrichmentHUNTER_API_KEYsecret Hunter.io API key for email discovery and verificationAPOLLO_API_KEYsecret Apollo.io API key for contact and company dataTWILIO_ACCOUNT_SIDsecret Twilio Account SID for phone validationTWILIO_AUTH_TOKENsecret Twilio Auth Token for phone validationENRICHMENT_CACHE_TTLCache TTL in seconds for enrichment results (default: 86400)
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Opafex MCPs
Open-source Model Context Protocol servers by Opafex. Each server is a standalone npm package usable with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.
Servers
| Package | Description | Status |
|---|---|---|
@opafex/mcp-enrichment | Company, contact, email & phone enrichment via Clearbit, Hunter.io, Twilio | Available |
@opafex/mcp-file-processor | Document text extraction, keyword detection, chunking | Available |
@opafex/mcp-web-research | Web search (Brave API), SSRF-guarded page fetch, research synthesis | Available |
@opafex/mcp-approval-queue | Human-in-the-loop approval gate — the agent asks, only a person approves (elicitation or CLI) | Available |
@opafex/knowledge-grid | Layered context for agents (a library, in its own repo) | Available |
Quick Start
# Clone and install
git clone https://github.com/opafex/opafex-mcps.git
cd opafex-mcps
npm install
npm run build
# Run the enrichment server (mock mode — no API keys needed)
node packages/enrichment/dist/index.js
Add to Claude Code
Create or edit .mcp.json in your project root:
{
"mcpServers": {
"enrichment": {
"command": "node",
"args": ["/path/to/opafex-mcps/packages/enrichment/dist/index.js"],
"env": {
"CLEARBIT_API_KEY": "sk-...",
"HUNTER_API_KEY": "...",
"TWILIO_ACCOUNT_SID": "...",
"TWILIO_AUTH_TOKEN": "..."
}
}
}
}
All servers work in mock mode when API keys are omitted — great for development and testing.
Development
npm install # Install all dependencies
npm run build # Build all packages
npm test # Run all tests
Adding a New Server
- Create
packages/<server-name>/withpackage.json,tsconfig.json, andsrc/ - Use
@opafex/mcp-sharedfor the server bootstrap (createMCPServer) - Define tools in
tools.ts, wire up inindex.ts - Add tests in
__tests__/
See packages/enrichment as a reference implementation.
Shared Utilities
@opafex/mcp-shared provides:
createMCPServer()/buildMCPServer()— Reusable MCP server bootstrap with tool/resource registration and stdio transportToolContext.elicit— ask the user a question through the client's UI (MCP elicitation), out of the model's reach- Validation helpers — Email, domain, phone format validation
License
MIT
Frequently asked questions
What is io.github.Opafex/mcp-enrichment?
Multi-source entity enrichment: company data, contacts, email verification, and phone validation
How do I install io.github.Opafex/mcp-enrichment?
It runs on your machine. In Claude Code: claude mcp add mcp-enrichment -e 'CLEARBIT_API_KEY=<your clearbit_api_key>' -e 'HUNTER_API_KEY=<your hunter_api_key>' -e 'APOLLO_API_KEY=<your apollo_api_key>' -e 'TWILIO_ACCOUNT_SID=<your twilio_account_sid>' -e 'TWILIO_AUTH_TOKEN=<your twilio_auth_token>' -e 'ENRICHMENT_CACHE_TTL=<ENRICHMENT_CACHE_TTL>' -- npx -y @opafex/mcp-enrichment@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.Opafex/mcp-enrichment need an API key?
Yes. It expects CLEARBIT_API_KEY, HUNTER_API_KEY, APOLLO_API_KEY, TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, which you set in its configuration.
Is io.github.Opafex/mcp-enrichment open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.Opafex/mcp-enrichment?
It is published by opafex. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.