io.github.IntelagentStudios/mcp-enrichment
Multi-source entity enrichment: company data, contacts, email verification, and phone validation
Open source Open in the app JSON README (API)
About
Multi-source entity enrichment: company data, contacts, email verification, and phone validation
Details
- Kind
- MCP servers
- Topic
- Communication
- Publisher
- intelagentstudios
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Last push
- 2026-06-28T23:54:21Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:01:58
- Updated
- 2026-08-29 03:01:58
- Origin id
io.github.IntelagentStudios/mcp-enrichment
README
# Opafex MCPs
Open-source [Model Context Protocol](https://modelcontextprotocol.io/) servers by [Opafex](https://opafex.com). 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`](./packages/enrichment) | Company, contact, email & phone enrichment via Clearbit, Hunter.io, Twilio | Available |
| [`@opafex/mcp-file-processor`](./packages/file-processor) | Document text extraction, keyword detection, chunking | Available |
| `@opafex/mcp-web-research` | Web search, page fetch, research synthesis | Planned |
| `@opafex/mcp-approval-queue` | Human-in-the-loop approval workflows | Planned |
| `@opafex/mcp-knowledge-grid` | Document indexing, semantic search, context composition | Planned |
## Quick Start
```bash
# 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:
```json
{
"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
```bash
npm install # Install all dependencies
npm run build # Build all packages
npm test # Run all tests
```
### Adding a New Server
1. Create `packages/<server-name>/` with `package.json`, `tsconfig.json`, and `src/`
2. Use `@opafex/mcp-shared` for the server bootstrap (`createMCPServer`)
3. Define tools in `tools.ts`, wire up in `index.ts`
4. Add tests in `__tests__/`
See [`packages/enrichment`](./packages/enrichment) as a reference implementation.
## Shared Utilities
[`@opafex/mcp-shared`](./packages/shared) provides:
- **`createMCPServer()`** — Reusable MCP server bootstrap with tool/resource registration and stdio transport
- **Validation helpers** — Email, domain, phone format validation
## License
MIT