Enrich Layer MCP Server

Enrich Layer MCP Server

An MCP (Model Context Protocol) server that provides 25 tools for enriching company, person, contact, school, and job data via the Enrich Layer API.

Use it with any MCP-compatible client: Claude Desktop, Claude Code, Cursor, VS Code, and more.

Quick Start

npx -y @enrichlayer/mcp-server

Set your API key as an environment variable:

export ENRICH_LAYER_API_KEY=your_api_key_here

Get your API key at enrichlayer.com/dashboard.

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "enrich-layer": {
      "command": "npx",
      "args": ["-y", "@enrichlayer/mcp-server"],
      "env": {
        "ENRICH_LAYER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop (MCPB Extension)

Download the .mcpb file from Releases and open it in Claude Desktop. You'll be prompted to enter your API key during setup.

Claude Code

claude mcp add enrich-layer -- npx -y @enrichlayer/mcp-server

Then set the env var ENRICH_LAYER_API_KEY in your shell.

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "enrich-layer": {
      "command": "npx",
      "args": ["-y", "@enrichlayer/mcp-server"],
      "env": {
        "ENRICH_LAYER_API_KEY": "your_api_key_here"
      }
    }
  }
}

VS Code

Add to your VS Code MCP settings (.vscode/mcp.json):

{
  "servers": {
    "enrich-layer": {
      "command": "npx",
      "args": ["-y", "@enrichlayer/mcp-server"],
      "env": {
        "ENRICH_LAYER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Remote HTTP Server

For remote deployments, the server also supports Streamable HTTP transport:

npm run start:http

This starts an Express server on port 3000 (configurable via PORT env var) with a /mcp endpoint for JSON-RPC and a /health endpoint for health checks.

Usage Examples

1. Look up a company

"Look up the company profile for Stripe"

This calls enrich_company_lookup with company_name: "Stripe" to find the company's professional network URL and profile data.

2. Find a work email by role

"Find the work email for the CTO of Notion"

This chains two tools: first enrich_role_lookup with company_name: "Notion", role: "cto" to find the person, then enrich_work_email with their profile URL to get the email address.

3. Check your credit balance

"How many credits do I have left?"

This calls enrich_credit_balance to show your remaining API credits. Costs 0 credits.

Available Tools (25)

Company (7 tools)

| Tool | Description | Credits | |------|-------------|---------| | enrich_company_profile | Get structured company data from URL | 1 | | enrich_company_lookup | Look up company by name or domain | 2 | | enrich_company_id_lookup | Look up company by numeric ID | 0 | | enrich_company_picture | Get company profile picture URL | 0 | | enrich_employee_list | List employees of a company | 3/employee | | enrich_employee_count | Get employee count | 1 | | enrich_employee_search | Search employees by keyword | 10 |

Person (4 tools)

| Tool | Description | Credits | |------|-------------|---------| | enrich_person_profile | Get structured person data from URL | 1 | | enrich_person_lookup | Look up person by name + company | 2 | | enrich_person_picture | Get person profile picture URL | 0 | | enrich_role_lookup | Find person by role at company | 3 |

Contact (6 tools)

| Tool | Description | Credits | |------|-------------|---------| | enrich_reverse_email | Find profile by email | 3 | | enrich_reverse_phone | Find profile by phone number | 3 | | enrich_work_email | Get work email from profile | 3 | | enrich_personal_contact | Get personal phone numbers | 1/contact | | enrich_personal_email | Get personal email addresses | 1/email | | enrich_disposable_email | Check if email is disposable | 0 |

School (2 tools)

| Tool | Description | Credits | |------|-------------|---------| | enrich_school_profile | Get structured school data | 1 | | enrich_student_list | List students of a school | 3/student |

Job (3 tools)

| Tool | Description | Credits | |------|-------------|---------| | enrich_job_profile | Get structured job posting data | 2 | | enrich_job_search | Search job postings | 2 | | enrich_job_count | Count matching job postings | 2 |

Search (2 tools)

| Tool | Description | Credits | |------|-------------|---------| | enrich_company_search | Search companies by criteria | 3/URL | | enrich_person_search | Search people by criteria | 3/URL |

Meta (1 tool)

| Tool | Description | Credits | |------|-------------|---------| | enrich_credit_balance | Check your credit balance | 0 |

Privacy Policy

Enrich Layer collects only the data you explicitly pass as tool parameters (URLs, names, emails). No conversation data, chat history, or personal data is collected or stored. All requests go directly to the Enrich Layer API over HTTPS.

For the full privacy policy, see enrichlayer.com/privacy.

Development

# Install dependencies
npm install

# Build
npm run build

# Run stdio server (for MCP clients)
npm start

# Run HTTP server (for remote deployments)
npm run start:http

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node build/index.js

API surface conformance

Tool schemas follow the published Enrich Layer OpenAPI spec — the single source of truth for the API surface: <https://enrichlayer.com/docs/api/v2/openapi.yaml>

A copy of the spec is vendored at spec/enrichlayer-api.yaml, and CI runs npm run check:spec on every pull request. A tool fails the check when:

• its endpoint is not in the spec;
• it exposes a parameter the spec does not document for that endpoint;
• a parameter's required/optional flag disagrees with the spec;
• it omits a parameter the spec marks required.

Optional spec parameters a tool does not expose are reported as warnings — tools may deliberately expose a curated subset. The check matches parameter names and required-ness only; it does not validate enum values or types, because the spec does not encode those for query parameters.

When the API changes:

npm run update-spec    # refresh spec/enrichlayer-api.yaml from the published URL
npm run build
npm run check:spec     # see which tools drifted, fix their schemas

The conformance logic lives in scripts/conformance-core.mjs and is unit-tested (npm test, Node's built-in test runner).

License

MIT