Contact Classifier

v1.0.0$0.003/resultContact Discovery

Contact title in, department and seniority out, plus a check on whether the person still holds the role at that company. Runs a deterministic title ladder with no API key needed. Bring your own LLM key only for the small share of titles the rules cannot place.

Install

bash
npx @mambalabsdev/mcp-contact-classifier

Use Cases

  • Who buys it. Bought by teams who are paying an LLM to classify job titles and would rather pay a rule table, and by anyone who needs a decision-maker filter that is auditable.
  • Clay enrichment column. Replace two AI columns with one deterministic call that returns department, seniority, and a decision-maker flag.

Features

  • 12 departments and 12 seniority levels
  • seniority_rank 1 to 12, filter with a comparison
  • classification_rule, the named rule that fired
  • 21 flat fields, snake_case, one row per contact
  • Deterministic first, no key and no network

Input

job_titlestringrequired

The only required field.

full_namestringoptional

Only used for verification.

company_domainstringoptional

Only used for verification.

verify_positionbooleanoptional

Adds about 3 seconds and 9 requests. Default: false.

use_llm_fallbackbooleanoptional

Needs LLM_API_KEY set as a secret env var. Default: false.

llm_providerstringoptional

openai, anthropic or google. Default: openai.

llm_modelstringoptional

Passed straight through. Default: gpt-4o-mini.

skipCachestringoptional

"true" classifies from scratch. Default: "false".

Output schema

json
{
  "job_title": "Chief Operating Officer",
  "full_name": "Jane Doe",
  "company_domain": "example.com",
  "department": "executive",
  "seniority": "c_level",
  "seniority_rank": 2,
  "is_decision_maker": true,
  "classification_method": "deterministic",
  "classification_rule": "c_suite_map:chief_operating_officer",
  "llm_used": false,
  "llm_status": "not_needed",
  "position_status": "verified_current",
  "position_evidence_url": "https://example.com/about/leadership",
  "peers_found_on_page": 7,
  "pages_attempted": 8,
  "pages_reached": 3,
  "fetch_status": "ok",
  "fetch_error": null,
  "run_date": "2026-08-10T10:19:37.363Z"
}

Pricing

$0.003per result

Pay-per-event billing on the Apify platform. You are charged only when the actor returns a result. No subscription, no seat license.

Free-tier Apify accounts include monthly free compute. Upgrade for higher concurrency and volume.

Available on

npm