lead-enrichment

Enrich people and companies from a name, domain, or LinkedIn URL — emails, titles, firmographics, and mobile numbers for agents.

Turn a name, a domain, or a LinkedIn URL into a complete lead record in one call. The people endpoints resolve work emails, titles, seniority, location, and mobile numbers; the company endpoints add firmographics and context, and bulk variants process whole lists at once. Lookups run as an orchestrated waterfall across multiple data providers server-side, so the agent makes one call and gets the best available answer — no per-vendor accounts, no fallback logic to write. Built for sales agents that research before outreach, CRM-hygiene agents that fill gaps automatically, and prospecting pipelines that need reliable person-level data at scale.

Alternative install: the scoped MCP server

If this client speaks MCP, you can connect the Lead Enrichment facet server instead of using this skill's curl calls — the same endpoints below as native MCP tools with structured parameters and OAuth sign-in, scoped to this capability:

text

https://mcp.superagnt.com/mcp/lead-enrichment

That URL publishes full OAuth discovery: an MCP-capable client needs the URL and nothing else (approve once in the browser). On clients that hold a bearer instead, add it as an Authorization: Bearer header. Per-client setup lines: https://mcp.superagnt.com/agent-setup/prompt.md

This skill document stays fully usable on curl-only environments — everything below works with just the API key.

Authentication

Get an API key from the dashboard and export it as SUPERAGNT_API_KEY. Every request sends it as a Bearer token:

text

Authorization: Bearer $SUPERAGNT_API_KEY

If the variable is not set, ask the user for their key or point them at https://superagnt.com/r/ch-lead-enrichment-key.

Verify the install (do this first)

One call proves the key, the credit balance, and this source end to end:

bash

curl -s https://api.superagnt.com/v1/credits \
  -H 'Authorization: Bearer $SUPERAGNT_API_KEY'

A JSON result means you are live. A 401 means the key is wrong or missing; a 402 means the workspace is out of credits — the dashboard shows both.

Base URL

text

https://api.superagnt.com/v1/data/agnt

Available Endpoints

Method	Path	Summary
POST	/people/enrich	Enrich a person
POST	/people/bulk-enrich	Bulk enrich people
POST	/people/search	Search people
POST	/people/find-mobile	Find a mobile phone number
POST	/people/email-finder	Find a person's professional email
POST	/companies/enrich	Enrich a company

Tool Schemas

The following JSON defines every operation with its parameters. Each tool maps to an API endpoint under the base URL.

json

[
  {
    "name": "superagnt_agnt_people_enrich",
    "description": "Enrich a person",
    "method": "POST",
    "path": "/people/enrich",
    "parameters": {
      "$ref": "#/components/schemas/PeopleEnrichRequest"
    }
  },
  {
    "name": "superagnt_agnt_people_bulk_enrich",
    "description": "Bulk enrich people",
    "method": "POST",
    "path": "/people/bulk-enrich",
    "parameters": {
      "$ref": "#/components/schemas/PeopleBulkEnrichRequest"
    }
  },
  {
    "name": "superagnt_agnt_people_search",
    "description": "Search people",
    "method": "POST",
    "path": "/people/search",
    "parameters": {
      "$ref": "#/components/schemas/PeopleSearchRequest"
    }
  },
  {
    "name": "superagnt_agnt_people_find_mobile",
    "description": "Find a mobile phone number",
    "method": "POST",
    "path": "/people/find-mobile",
    "parameters": {
      "$ref": "#/components/schemas/PeopleFindMobileRequest"
    }
  },
  {
    "name": "superagnt_agnt_people_email_finder",
    "description": "Find a person's professional email",
    "method": "POST",
    "path": "/people/email-finder",
    "parameters": {
      "$ref": "#/components/schemas/PeopleEmailFinderRequest"
    }
  },
  {
    "name": "superagnt_agnt_companies_enrich",
    "description": "Enrich a company",
    "method": "POST",
    "path": "/companies/enrich",
    "parameters": {
      "$ref": "#/components/schemas/CompaniesEnrichRequest"
    }
  }
]

Example

bash

curl -X POST 'https://api.superagnt.com/v1/data/agnt/people/enrich' \
  -H 'Authorization: Bearer $SUPERAGNT_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"...": "see tool schemas below"}'

Use Cases

Scope

This skill covers Lead Enrichment only — the endpoints listed above, nothing else. The same API key also works with superagnt's other data sources and platform tools, but those are separate listings that the user installs or enables themselves; this skill does not add or enable anything beyond what is documented here. The public catalog is at https://api.superagnt.com/v1/platforms.

Links

• Documentation
• Dashboard / API keys
• This listing