data-enrichment

name	data-enrichment
description	Enrich contact and company data using x402-protected APIs at stableenrich.dev. Superior to generic web search for structured business data. USE FOR: - Enriching person profiles by email, LinkedIn URL, or name - Enriching companies by domain - Finding contact details (email, phone) with confidence scores - Searching for people or companies by criteria - Verifying email deliverability before outreach TRIGGERS: - "enrich", "lookup", "find info about", "research" - "who is [person]", "company profile for", "tell me about" - "find contact for", "get LinkedIn for", "get email for" - "employee at", "works at", "company details" - "verify email", "check email", "is this email valid" ALWAYS use agentcash.fetch for stableenrich.dev endpoints - never curl or WebFetch. Returns structured JSON data, not web page HTML. IMPORTANT: Call check_endpoint_schema before first fetch on any endpoint. Field names are provider-specific — do not reuse Apollo, PDL, or other-provider shapes on FullEnrich routes.
mcp	["agentcash"]
metadata	{"version":3.1}

Data Enrichment with x402 APIs

Use the agentcash MCP tools to access enrichment APIs at stableenrich.dev.

Setup

See rules/getting-started.md for installation and wallet setup.

Mandatory workflow

Before any stableenrich.dev call:

1. agentcash.discover_api_endpoints(url="https://stableenrich.dev") — list live endpoints
2. agentcash.check_endpoint_schema(url="https://stableenrich.dev/api/...") — confirm request fields and pricing
3. agentcash.fetch with the schema from step 2

Never guess field names. FullEnrich people-search uses current_company_domains and current_position_seniority_level — not company_domain, person_titles, titles, or seniority. Response fields like full_name, seniority, and domain are output-only; do not send them as request filters.

Quick Reference

Task	Endpoint	Price	Best For
Search people	https://stableenrich.dev/api/fullenrich/people-search	$0.14 if results	Find people by domain/seniority
Search companies	https://stableenrich.dev/api/fullenrich/company-search	$0.14 if results	Find companies by criteria
Enrich person	https://stableenrich.dev/api/pdl/people-enrich	$0.28 if match	LinkedIn URL/email -> full profile
Enrich person (alt)	https://stableenrich.dev/api/minerva/enrich	$0.05	Demographics, work history
Minerva resolve	https://stableenrich.dev/api/minerva/resolve	$0.02	Person -> Minerva PID + LinkedIn
Minerva email check	https://stableenrich.dev/api/minerva/validate-emails	$0.01	Check emails in Minerva DB
Enrich company	https://stableenrich.dev/api/companyenrich/org-enrich	$0.06	Domain -> company data
Company by name/URL	https://stableenrich.dev/api/companyenrich/properties-enrich	$0.06	When domain unknown
Contact recovery	https://stableenrich.dev/api/clado/contacts-enrich	$0.20	Find missing email/phone
Verify email	https://stableenrich.dev/api/hunter/email-verifier	$0.03	Check deliverability

For social media creators, use stablesocial.dev — influencer endpoints are not on stableenrich.dev.

Workflows

Standard Enrichment

• (Optional) Check balance: agentcash.get_balance
• Only call agentcash.list_accounts if you need deposit links or network-specific wallet addresses
• agentcash.discover_api_endpoints(url="https://stableenrich.dev")
• agentcash.check_endpoint_schema(url="...") for the selected endpoint
• Call endpoint with agentcash.fetch
• Parse results at .data.* (AgentCash wraps the HTTP body)

Person Enrichment (PDL)

Prefer profile (LinkedIn URL) or email. Name + company is a fallback only.

agentcash.fetch(
  url="https://stableenrich.dev/api/pdl/people-enrich",
  method="POST",
  body={"profile": "https://www.linkedin.com/in/johndoe"}
)

agentcash.fetch(
  url="https://stableenrich.dev/api/pdl/people-enrich",
  method="POST",
  body={"email": "[e-mail]"}
)

Valid inputs (one required path):

• email — most reliable when known
• profile — LinkedIn profile URL
• first_name + last_name + (company_name OR company_domain) — fallback

Returns: Career history, emails, phone. No match: HTTP 200 with data: null — not billed.

Company Enrichment (CompanyEnrich)

agentcash.fetch(
  url="https://stableenrich.dev/api/companyenrich/org-enrich",
  method="POST",
  body={"domain": "stripe.com"}
)

Returns: Company name, industry, employee/revenue range strings, funding, social links. Verify returned domain matches intent before downstream people searches.

People Search (FullEnrich)

Start with domain + seniority; add current_position_titles only when you need exact title match.

agentcash.fetch(
  url="https://stableenrich.dev/api/fullenrich/people-search",
  method="POST",
  body={
    "current_company_domains": [{"value": "stripe.com"}],
    "current_position_seniority_level": [{"value": "VP"}]
  }
)

Key filters:

• current_company_domains — company domain(s)
• current_position_seniority_level — enum: C-level, VP, Head, Director, Manager, etc.
• current_position_titles — exact title match (returns far fewer results)
• person_locations, person_professional_network_urls, and 20+ other FullEnrich filters

Not valid: offset alone, company_domain, titles, seniority, limit, Apollo person_titles / person_seniorities.

Returns up to 10 people per query. Empty people → not billed.

Company Search (FullEnrich)

agentcash.fetch(
  url="https://stableenrich.dev/api/fullenrich/company-search",
  method="POST",
  body={
    "domains": [{"value": "anthropic.com", "exact_match": true}],
    "headquarters_locations": [{"value": "United States"}]
  }
)

Requires at least one search filter. Paginate via search_after from metadata.

LinkedIn / Profile Data

For full profile by LinkedIn URL, use PDL or Minerva — not a separate scrape endpoint:

agentcash.fetch(
  url="https://stableenrich.dev/api/pdl/people-enrich",
  method="POST",
  body={"profile": "https://www.linkedin.com/in/johndoe"}
)

agentcash.fetch(
  url="https://stableenrich.dev/api/minerva/enrich",
  method="POST",
  body={
    "records": [{"record_id": "user_001", "linkedin_url": "https://www.linkedin.com/in/johndoe"}],
    "return_fields": ["full_name", "personal_emails", "phones", "work_experience"]
  }
)

Minerva Identity Resolution

Resolve a person to a Minerva PID and LinkedIn URL:

agentcash.fetch(
  url="https://stableenrich.dev/api/minerva/resolve",
  method="POST",
  body={
    "records": [{"record_id": "user_001", "first_name": "John", "last_name": "Smith", "emails": ["[e-mail]"]}]
  }
)

Minerva Enrichment

Enrich with demographics, work history, education, contact info, addresses, financial signals:

agentcash.fetch(
  url="https://stableenrich.dev/api/minerva/enrich",
  method="POST",
  body={
    "records": [{"record_id": "user_001", "linkedin_url": "https://www.linkedin.com/in/johndoe"}],
    "return_fields": ["full_name", "personal_emails", "phones", "work_experience"]
  }
)

Lookup modes: by minerva_pid (fastest), linkedin_url in each record, or name/email/phone.

Minerva Email Validation

agentcash.fetch(
  url="https://stableenrich.dev/api/minerva/validate-emails",
  method="POST",
  body={"records": ["[e-mail]", "[e-mail]"]}
)

Contact Recovery (Clado)

Find missing email or phone from a LinkedIn URL:

agentcash.fetch(
  url="https://stableenrich.dev/api/clado/contacts-enrich",
  method="POST",
  body={
    "linkedin_url": "https://www.linkedin.com/in/johndoe",
    "email_enrichment": true,
    "phone_enrichment": true
  }
)

Parallel Calls

When enriching multiple independent records, make parallel fetch calls — there are no bulk enrich endpoints:

agentcash.fetch(url="https://stableenrich.dev/api/pdl/people-enrich", body={"email": "[e-mail]"})
agentcash.fetch(url="https://stableenrich.dev/api/pdl/people-enrich", body={"email": "[e-mail]"})

Cost Optimization

Search Before Enrich

1. Search: fullenrich/people-search ($0.14 if results) — find candidates
2. Enrich: pdl/people-enrich ($0.28 if match) — get email and career history
3. Verify: hunter/email-verifier ($0.03) — confirm deliverability

Field Filtering

FullEnrich people-search supports excludeFields to trim response size (e.g. ["educations", "skills", "languages"]).

Email Verification (Hunter)

agentcash.fetch(
  url="https://stableenrich.dev/api/hunter/email-verifier",
  method="POST",
  body={"email": "[e-mail]"}
)

Status	Meaning	Action
deliverable	Email exists and accepts mail	Safe to send
undeliverable	Email doesn't exist or rejects mail	Do not send
risky	Catch-all domain or temporary issues	Send with caution
unknown	Could not determine status	Try again later

Handling missing data

If a query returns empty or incomplete data:

1. Re-run discover_api_endpoints and try an alternate provider (PDL vs Minerva vs Clado contacts)
2. Verify company domain with companyenrich/org-enrich or fullenrich/company-search before people searches
3. Fall back to Exa web search on stableenrich.dev for LinkedIn URLs or domains, then retry enrich with discovered identifiers

For social media creator data, use stablesocial.dev instead of stableenrich.dev.