io.github.IntelagentStudios/mcp-enrichment

Official

by Opafex · TypeScript

Multi-source entity enrichment: company data, contacts, email verification, and phone validation

Enrich entities with company data, contacts, email verification, and phone validation.

Topics

ai-toolsclaude-codecontact-enrichmentenrichmentmcpmcp-servermodel-context-protocolopen-sourceopensourceclaudecursor

README.md2 KBView on GitHub

Intelagent MCPs

Open-source Model Context Protocol servers by Intelagent. Each server is a standalone npm package usable with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.

Servers

Package	Description	Status
`@intelagent/mcp-enrichment`	Company, contact, email & phone enrichment via Clearbit, Hunter.io, Twilio	Available
`@intelagent/mcp-file-processor`	Document text extraction, keyword detection, chunking	Available
`@intelagent/mcp-web-research`	Web search, page fetch, research synthesis	Planned
`@intelagent/mcp-approval-queue`	Human-in-the-loop approval workflows	Planned
`@intelagent/mcp-knowledge-grid`	Document indexing, semantic search, context composition	Planned

Quick Start

bash

# Clone and install
git clone https://github.com/IntelagentStudios/Intelagent-MCPs.git
cd Intelagent-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/Intelagent-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

Create packages/<server-name>/ with package.json, tsconfig.json, and src/
Use @intelagent/mcp-shared for the server bootstrap (createMCPServer)
Define tools in tools.ts, wire up in index.ts
Add tests in __tests__/

See packages/enrichment as a reference implementation.

Shared Utilities

@intelagent/mcp-shared provides:

createMCPServer() — Reusable MCP server bootstrap with tool/resource registration and stdio transport
Validation helpers — Email, domain, phone format validation

License

MIT

Install

Configuration

Environment variables

CLEARBIT_API_KEYsecret

Clearbit API key for company and contact enrichment

HUNTER_API_KEYsecret

Hunter.io API key for email discovery and verification

APOLLO_API_KEYsecret

Apollo.io API key for contact and company data

TWILIO_ACCOUNT_SIDsecret

Twilio Account SID for phone validation

TWILIO_AUTH_TOKENsecret

Twilio Auth Token for phone validation

ENRICHMENT_CACHE_TTL

Cache TTL in seconds for enrichment results (default: 86400)

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-enrichment": {
      "command": "npx",
      "args": [
        "-y",
        "@intelagent/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": "<YOUR_ENRICHMENT_CACHE_TTL>"
      }
    }
  }
}