US Healthcare NPI Doctor & Clinic Lead Enricher (CMS API) (MCP Server + n8n Ready + REST API)

B2B healthcare lead extractor and enricher for US doctors, dentists, clinics, and hospitals using the official CMS NPPES NPI Registry API v2.1. Extracts NPI-1 and NPI-2 records, practice addresses, phone numbers, primary taxonomy, state licenses, and AI-ready lead dossiers.

Engineered by @b2b-quant-apis for scheduled Machine-to-Machine (n8n / Make.com) pipelines, Autonomous AI Agents (Claude Desktop, Cursor IDE, LangChain, CrewAI), and Enterprise Compliance & RevOps stacks.

---

Why Choose b2b-quant-apis/us-healthcare-npi-provider-lead-enricher?

1. Zero-Proxy & Zero-External-Key Architecture: Connects directly to official primary registries and public regulatory endpoints with deterministic input sanitization and automatic retry/backoff.
2. Quantitative Risk & Opportunity Scoring (0–100): Every output record includes a normalized quantitative score and an executive Markdown Dossier ready for RAG vector databases, Slack/Teams alerts, or CRM enrichment.
3. Native Model Context Protocol (MCP) Server: Connect directly to Claude Desktop, Cursor, Windsurf, or any MCP client in 1 click without deploying local infrastructure.
4. Predictable Pay-Per-Event Pricing: You only pay $0.02 USD per successfully processed record (npi-lead-enriched). Zero monthly subscription fees.

---

Transparent Pay-Per-Event (PPE) Pricing

Billing Event Name	Event Title	Price per Event (USD)	Categories
npi-lead-enriched	US NPI Healthcare Provider Lead Enriched	$0.02 USD	AI, LEAD_GENERATION, BUSINESS

Negative Profit Protection: Failed queries, empty responses, or invalid inputs return cleanly without triggering event charges.

---

Input Parameters

Parameter	Type	Required	Default	Description
state	string	Optional	"FL"	Two-letter US State code (e.g., FL, NY, CA, TX).
city	string	Optional	"Miami"	Optional city filter (e.g., Miami, Orlando, Los Angeles).
taxonomyDescription	string	Optional	"Dentist"	Specialty/Taxonomy e.g. Dentist, Dermatology, Internal Medicine, Physical Therapist.
enumerationType	string	Optional	"ALL"	Filter by Individual Providers (NPI-1), Organizations/Clinics (NPI-2), or All.
postalCode	string	Optional	""	Optional US ZIP code prefix (e.g., 331, 33131).
maxResults	integer	Optional	15	Maximum number of healthcare provider leads to extract and enrich (1 to 200).

Example Input JSON

{
  "taxonomies": [
    "Cardiology",
    "Dermatology"
  ],
  "state": "NY",
  "max_results": 10
}

---

Output Dataset Schema

Each run pushes structured JSON items to the default Apify Dataset with the following fields:

Field Name	Type	Description
npiNumber	string	NPI Number — NPI Number
providerType	string	Provider Type — Provider Type
fullNameOrOrgName	string	Full Name / Organization — Full Name / Organization
primarySpecialty	string	Primary Specialty — Primary Specialty
LicenseNumber	string	State License Number — State License Number
city	string	City — City
state	string	State — State
phone	string	Direct Phone — Direct Phone
addressLine	string	Practice Address — Practice Address
leadQualityScore	integer	Lead Quality Score (0-100) — Lead Quality Score (0-100)
markdownLeadCard	string	Markdown Lead Dossier — Markdown Lead Dossier

Example Output JSON

[
  {
    "npiNumber": "Sample NPI Number",
    "providerType": "Sample Provider Type",
    "fullNameOrOrgName": "Sample Full Name / Organization",
    "primarySpecialty": "Sample Primary Specialty",
    "LicenseNumber": "Sample State License Number",
    "city": "Sample City",
    "state": "Sample State",
    "phone": "Sample Direct Phone",
    "addressLine": "Sample Practice Address",
    "leadQualityScore": 92,
    "markdownLeadCard": "Sample Markdown Lead Dossier"
  }
]

---

1-Click MCP Server Integration (Claude Desktop & Cursor IDE)

Add b2b-quant-apis/us-healthcare-npi-provider-lead-enricher as an AI Agent tool in Claude Desktop (claude_desktop_config.json) or Cursor IDE (.cursor/mcp.json):

{
  "mcpServers": {
    "us-healthcare-npi-provider-lead-enricher": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--actors",
        "b2b-quant-apis/us-healthcare-npi-provider-lead-enricher"
      ],
      "env": {
        "APIFY_TOKEN": "<YOUR_APIFY_API_TOKEN>"
      }
    }
  }
}

• Hosted Streamable HTTP MCP URL: https://mcp.apify.com/?actors=b2b-quant-apis/us-healthcare-npi-provider-lead-enricher

---

Automated Daily n8n Workflow Template

Download the pre-built, sanitized n8n workflow template with a daily Schedule Trigger (07:00 AM), HTTP Request node, and CRM/Slack Webhook Router:

• Direct Download (.n8n.json): us-healthcare-npi-provider-lead-enricher.n8n.json
• Enterprise Multi-Actor Super-Pipelines: GitHub Repository jesleytassili-glitch/b2b-quant-mcp-n8n-suite

---

Direct Stateless REST API Call (cURL Synchronous JSON)

Call this Actor synchronously as a standard HTTP POST micro-API and receive the JSON dataset array directly in the HTTP response:

curl -X POST "https://api.apify.com/v2/acts/b2b-quant-apis~us-healthcare-npi-provider-lead-enricher/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"taxonomies": ["Cardiology", "Dermatology"], "state": "NY", "max_results": 10}'

---

Frequently Asked Questions (FAQ)

1. Do I need to configure residential proxies or third-party API keys?

No. b2b-quant-apis/us-healthcare-npi-provider-lead-enricher runs out-of-the-box with zero external API keys and zero paid proxy requirements.

2. Can I chain this Actor with other B2B compliance and lead enrichment tools?

Yes. Explore the full 25-Actor B2B Quant & Regulatory Suite at apify.com/b2b-quant-apis or import our 5 Multi-Actor Waterfall Pipelines from GitHub (jesleytassili-glitch/b2b-quant-mcp-n8n-suite).