Estimate credits with
preview_cost before expensive composite work, and use check_credit_balance or get_account_analytics before large bulk jobs.Cost And Safety Model
| Pattern | What to expect |
|---|---|
| Single lookups | Charged only when the underlying LeadMagic product returns data, unless noted otherwise |
| Email validation | 0.25 credits per validation |
| Jobs | 1 credit per job returned; job company autocomplete is 1 credit per request |
| Bulk jobs | Charged asynchronously per processed row and product |
| Free tools | Credit checks, credit estimates, analytics reads, most job filter lists, and many no-result outcomes |
| Composite tools | Chain multiple lookups; estimate cost with preview_cost before large runs |
Contact Tools
| Tool | Use it for | Key inputs | Cost behavior |
|---|---|---|---|
validate_work_email | Email deliverability before outreach | email | 0.25 credits per validation |
find_work_email | Work email discovery from person + company | first_name, last_name, company_domain or company_name | 1 credit per lookup |
find_mobile_number | Direct mobile lookup | profile_url, work_email, or personal_email | 5 credits when found, free if no match |
linkedin_profile_to_work_email | Profile URL to work email | profile_url, optional name/company hints | 1 credit per lookup |
email_to_b2b_profile | Email to LinkedIn/B2B profile URL | work_email or personal_email | 10 credits when found, free if no match |
search_profile | Full professional profile | profile_url | 2 credits when found, free if no match |
find_personal_email | Personal email fallback | profile_url | 2 credits when found, free if no match |
detect_job_change | Employment-change detection | profile_url or work_email, plus company hint when needed | 1 credit per check |
Validate alex.rivera@example.com before I send outreach.
Find the work email for Alex Rivera at example.com.
Get the mobile number for this LinkedIn profile.
Has alex.rivera@example.com moved jobs?
Company And Account Tools
| Tool | Use it for | Key inputs | Cost behavior |
|---|---|---|---|
enrich_company | Single-company firmographics | company_domain, company_name, or profile_url | 1 credit per match |
research_account | Concise company brief with funding context | company_domain or company_name | 2 credits per account |
find_company_funding | Funding rounds, investors, last round, and revenue context | company_domain or company_name | 4 credits when data exists |
list_company_competitors | Competitors and similar companies | company_domain, company_url, or company_name | 5 credits when found |
get_company_technographics | Technology stack and vendor signals | company_name, optional company_domain | 1 credit when signals exist |
find_people_by_role | One role or title at a company | company_name, optional job_title, location | 1 credit per match |
find_company_employees | Broad employee discovery | company_domain or company_name, optional location, limit | 1 credit per employee returned |
Give me firmographics for example.com.
Who competes with Example Robotics?
What technology stack does Example Robotics use?
Find the VP Sales at Example Robotics.
List 25 employees at example.com.
Composite Tools
Composite tools chain multiple LeadMagic calls server-side so the assistant can produce a richer answer in one step.| Tool | What it chains | Best for | Cost controls |
|---|---|---|---|
find_decision_makers | Role search, work email discovery, and validation | Finding executives or buying committee members | titles max 5, include_email_discovery, include_validation, validate_limit |
account_intel | Company research, competitors, technographics, and jobs | Account prep and GTM research | include_* flags, jobs_limit, jobs_per_page |
enrich_contact | Validation, profile lookup, personal email, mobile, and job change | Full contact dossier | include_* flags, auto_resolve_profile |
Find and validate the CEO, CRO, and Head of RevOps at Example Robotics.
Give me account intel on Example Robotics, but limit jobs to 5.
Enrich alex.rivera@example.com but skip mobile lookup.
Jobs Tools
| Tool | Use it for | Inputs | Cost |
|---|---|---|---|
find_jobs | Search open jobs and hiring intent | company_name, company_website, job_title, job_description, experience_level, has_remote, location, city_name, country_id, posted_within, page, per_page | 1 credit per returned job |
search_jobs | Advanced Jobs Search with v3 warehouse filters | titles, company_domains, countries, occupation_level*, tags, vector, include_facets, mode, limit | 1 credit per returned job signal |
resolve_job_search_filters | Resolve companies, tags, titles, occupation taxonomy, and countries before search | company_domains, tags, occupation_level*, titles, countries | 1 credit per request |
search_job_companies | Autocomplete job company filters | q, domain, limit | 1 credit per request |
search_job_tags | Autocomplete jobs tags/tools/skills | q, tag_type, limit | Free |
search_job_titles | Autocomplete normalized job titles | q, limit | Free |
search_job_occupation_taxonomy | Autocomplete occupation taxonomy levels | q, level, limit | Free |
search_job_locations | Autocomplete countries, regions, states, and cities | q, type, limit | Free |
get_job_search_catalogs | Fetch job filter catalogs | none | Free |
get_job_search_stats | Fetch jobs warehouse freshness and dimension counts | none | Free |
list_job_countries | Resolve supported country filters | none | Free |
list_job_types | See supported job type filters | none | Free |
list_job_company_types | See company type filters | none | Free |
list_job_industries | See supported industry filters | none | Free |
list_job_regions | See supported region filters | none | Free |
Find senior remote engineering jobs at Example Robotics posted in the last 30 days.
Search jobs for DevOps engineers in the US using occupation taxonomy and tags.
Resolve job search filters for Example Robotics, Kubernetes, and DevOps.
Which countries can I use as job filters?
Show job industries supported by LeadMagic.
Bulk Tools
Use bulk tools for lists, uploaded files, and multi-row work. The assistant should not loop single-record tools across a CSV.| Tool | Use it for |
|---|---|
create_bulk_upload_session | Open the LeadMagic upload widget for CSV/JSON/JSONL files |
process_attached_csv | Route an attached file into the upload widget with the right enrichment |
resolve_bulk_upload_mapping | Widget-internal column mapping helper |
submit_company_firmographics_bulk | Company firmographics bulk jobs with domain/name mapping |
submit_detected_bulk_job | Bulk jobs after enrichment type and columns are detected |
submit_bulk_job | Generic bulk submit with explicit endpoint, product, and input mapping |
list_bulk_jobs | List recent jobs with optional status/product filters |
get_bulk_job_status | Check queue position, throttling/backoff, progress, completion, and links |
get_bulk_job_rows | Read paginated result rows |
get_bulk_job_errors | Read failed rows and error messages |
get_bulk_job_logs | Read recent worker logs |
get_bulk_job_events | Read worker event history |
| Enrichment | Typical columns |
|---|---|
company_firmographics | domain, company, name, website |
company_technographics | company, domain |
company_competitors | company, domain, linkedin_url |
company_jobs | company, domain |
company_funding | company, domain |
email_validation | email, work_email, business_email |
work_email_finder | first_name, last_name, domain, company |
linkedin_to_email | profile_url, linkedin_url |
mobile_finder | email, work_email, profile_url, linkedin_url |
job_change | email, profile_url, domain, company |
employee_finder | company, domain |
Open the upload widget so I can enrich a company list.
This CSV has first name, last name, and domain columns. Find work emails in bulk.
Check the status of bulk job job_123.
Show failed rows for that bulk job.
Account Tools
| Tool | Use it for | Cost |
|---|---|---|
check_credit_balance | Current credit balance | Free |
get_account_analytics | Credit balance, rate-limit headroom, concurrency, calls, credits used, average cost, and top tools for today/week/month | Free |
preview_cost | Credit estimate for any MCP tool, including composite workflows | Free |
How many credits do I have left?
Show usage today and rate-limit headroom.
Estimate the cost of account_intel for 10 jobs before running it.
Resources
| Resource | URI | Type | Description |
|---|---|---|---|
| LeadMagic API Documentation | leadmagic://docs | text/markdown | Credit costs, rate limits, best practices, and API reference context |
Prompts
The server provides built-in prompts for common workflows.| Prompt | Use it for | Arguments |
|---|---|---|
account_research | Research a single company and summarize GTM signals | company_domain, company_name |
contact_lookup | Find or validate a work email, with bulk-file guidance when needed | first_name, last_name, company_domain, company_name, email |
Recommended Tool Selection
| User asks for | Prefer |
|---|---|
| One email validation | validate_work_email |
| One work email | find_work_email or linkedin_profile_to_work_email |
| One full contact dossier | enrich_contact |
| Executives at an account | find_decision_makers |
| One company profile | enrich_company |
| Full account prep | account_intel |
| A CSV or list | process_attached_csv, create_bulk_upload_session, or submit_detected_bulk_job |
| Job postings | find_jobs |
| Credit usage or limits | get_account_analytics |
| Cost estimate | preview_cost |