# How to integrate LeadMagic MCP with Hermes

```json
{
  "title": "How to integrate LeadMagic MCP with Hermes",
  "toolkit": "LeadMagic",
  "toolkit_slug": "leadmagic",
  "framework": "Hermes",
  "framework_slug": "hermes-agent",
  "url": "https://composio.dev/toolkits/leadmagic/framework/hermes-agent",
  "markdown_url": "https://composio.dev/toolkits/leadmagic/framework/hermes-agent.md",
  "updated_at": "2026-09-12T05:35:50.590Z"
}
```

## Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.
This guide explains the easiest and most robust way to connect your LeadMagic account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

## Also integrate LeadMagic with

- [ChatGPT Work](https://composio.dev/toolkits/leadmagic/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/leadmagic/framework/claude-cowork)

## TL;DR

### What is Composio Connect?
Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:
- Search and load tools from relevant toolkits on-demand, reducing context usage.
- Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
- Manage app authentication end-to-end with zero manual overhead.

## Connect LeadMagic to Hermes

### Integrating LeadMagic with Hermes
### Using Composio Connect CLI
1. Install the Composio CLI
Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

```bash
curl -fsSL https://composio.dev/install | bash
```

## What is the LeadMagic MCP server, and what's possible with it?

The LeadMagic MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your LeadMagic account. It provides structured and secure access so your agent can perform LeadMagic operations on your behalf.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `LEADMAGIC_ADD_EMAILS_TO_SUPPRESSION_LIST` | Add Emails To Suppression List | Add a non-empty plaintext email list to one owned suppression list; LeadMagic stores only normalized SHA-256 hashes. Use the exact list_id captured in the same create lifecycle and only addresses intentionally owned by that workflow. |
| `LEADMAGIC_CREATE_CREDIT_BUDGET` | Create Credit Budget | Create a persistent credit budget that caps spend for one LeadMagic scope. Record the returned id so the owned budget can be updated or deleted later. |
| `LEADMAGIC_CREATE_EMAIL_SUPPRESSION_LIST` | Create Email Suppression List | Create an owned suppression list from a unique list_id and non-empty plaintext email list. LeadMagic hashes emails server-side. Capture the returned list_id, use only that exact ID for subsequent reads or mutations, and always delete the owned list at the end of the lifecycle. |
| `LEADMAGIC_CREATE_JOB_SEARCH_EXPORT_V3` | Create Job Search Export V3 | Synchronously export up to 5,000 matching jobs. At least one search filter is required. This route is credit-metered, but LeadMagic does not publish an exact rate. The limit defaults to 1 and bounds result count, not guaranteed credit exposure; use credits_consumed as finalized spend. |
| `LEADMAGIC_DELETE_CREDIT_BUDGET` | Delete Credit Budget | Permanently delete one credit budget. This is an irreversible teardown action: use only the exact budget ID captured from Create Credit Budget in the same owned lifecycle, and never delete a budget discovered by listing workspace data. |
| `LEADMAGIC_DELETE_EMAIL_SUPPRESSION_LIST` | Delete Email Suppression List | Permanently delete an entire suppression list and its stored hashes. This is an irreversible teardown action: use only the exact list_id captured from Create Email Suppression List in the same owned lifecycle, never a pre-existing list. |
| `LEADMAGIC_DETECT_JOB_CHANGE` | Detect Job Change | Check whether a person has changed jobs relative to an expected company. A resolved check costs 3 credits; PROFILE_NOT_FOUND costs 0 credits. |
| `LEADMAGIC_DOWNLOAD_BULK_JOB_RESULTS_CSV` | Download Bulk Job Results CSV | Download all result rows for an owned bulk job as a CSV file. Use only a jobId captured from the same submission chain. The streamed download is offloaded and fails if it exceeds the documented 50 MiB bulk source-size bound. |
| `LEADMAGIC_ENRICH_COMPANY_V1` | Enrich Company V1 | Call POST /v1/companies/company-search to enrich one company from its domain, name, or business profile identifier. A successful enriched-company result costs 1 credit; use credits_consumed as the finalized spend. |
| `LEADMAGIC_ENRICH_COMPANY_V3_DOCS_ALIAS` | Enrich Company V3 Docs Alias | Call the distinct documented POST /v3/companies/enrich alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing routes are unmetered; LeadMagic does not state an exact alias-specific charge, so use credits_consumed as finalized spend. |
| `LEADMAGIC_FIND_COMPANY_COMPETITORS_V1` | Find Company Competitors V1 | Find competitors from a company domain, profile, or name. A successful competitor list costs 5 credits. |
| `LEADMAGIC_FIND_COMPANY_EMPLOYEES_V1` | Find Company Employees V1 | Find up to 10 employees at one company, returning names, titles, locations, and professional profile URLs. Provider documentation conflicts between 0.05 and 1 credit per returned employee, so treat 1 credit per result as the exposure bound and use credits_consumed as finalized spend. |
| `LEADMAGIC_FIND_JOBS_V1` | Find Jobs V1 | Call POST /v1/jobs/jobs-finder to find jobs with the LeadMagic V1 filters. Each returned job costs 1 credit; an empty result costs 0 credits. per_page is capped at 50. |
| `LEADMAGIC_FIND_LOOKALIKE_COMPANIES_V3` | Find Lookalike Companies V3 | Find similar companies from a seed domain, name, or description. The OpenAPI contract documents a flat 5-credit charge for a non-empty result and no charge when empty; another provider surface says 1 credit, so use credits_consumed as the finalized spend. |
| `LEADMAGIC_FIND_MOBILE_PHONE` | Find Mobile Phone | Find one person's mobile phone number from a professional profile URL or known email. A found mobile number costs 5 credits; no result is free. Exactly one person is processed per call. |
| `LEADMAGIC_FIND_PERSONAL_EMAIL` | Find Personal Email | Find one person's personal email addresses from a professional profile URL or identifier. A successful result costs 2 credits. Personal email addresses are sensitive personal data; use this tool only for a lawful, authorized purpose. |
| `LEADMAGIC_FIND_PERSON_BY_ROLE_V1` | Find Person By Role V1 | Find one person by job title at a specified company. A successful match costs 2 credits; rely on credits_consumed as finalized spend. The response can contain personal identity and professional profile data. |
| `LEADMAGIC_FIND_WORK_EMAIL` | Find Work Email | Find one person's work email from their name and company domain or name. A found valid email costs 1 credit; no result is free. Exactly one person is processed per call. |
| `LEADMAGIC_FIND_WORK_EMAIL_FROM_B2B_PROFILE` | Find Work Email From B2B Profile | Find one person's work email from a professional profile URL or slug. LeadMagic's published sources conflict on whether a successful result costs 1 or 5 credits; treat 5 credits as the maximum documented exposure and use credits_consumed as finalized spend. |
| `LEADMAGIC_GET_ACCOUNT_OVERVIEW` | Get Account Overview | Return the connected workspace's available credits, API-key permission summary, current rate limits, and today's usage. This read is free. |
| `LEADMAGIC_GET_ANALYTICS_ALL_TIME_SUMMARY` | Get Analytics All Time Summary | Get documented lifetime account request, credit, product, success, and latency statistics, optionally restricted to a date range. This free analytics route was not individually live-probed during the build. |
| `LEADMAGIC_GET_ANALYTICS_CREDIT_HISTORY` | Get Analytics Credit History | Get LeadMagic credit consumption history with a daily breakdown. |
| `LEADMAGIC_GET_ANALYTICS_DAILY_METRICS` | Get Analytics Daily Metrics | Get documented daily request, credit, latency, and error metrics for the last 1 to 90 days. This free analytics route was not individually live-probed during the build. |
| `LEADMAGIC_GET_ANALYTICS_DAY_BREAKDOWN` | Get Analytics Day Breakdown | Get the documented per-product request and credit breakdown for one date. This free analytics route was not individually live-probed during the build. |
| `LEADMAGIC_GET_ANALYTICS_PRODUCTS` | Get Analytics Products | Get per-product LeadMagic usage with request, credit, and success metrics. |
| `LEADMAGIC_GET_ANALYTICS_USAGE` | Get Analytics Usage | Get daily LeadMagic usage with request, credit, and chargeable-rate totals. |
| `LEADMAGIC_GET_B2B_AD_DETAILS_V1` | Get B2B Ad Details V1 | Get full details for a specific B2B ad from its library URL, detail path, or numeric ID. A successful full-details lookup costs exactly 2 credits; use credits_consumed as finalized spend. |
| `LEADMAGIC_GET_B2B_PROFILE_FROM_EMAIL` | Get B2B Profile From Email | Find one person's professional profile from a supplied work or personal email. A found complete profile costs 10 credits. Email addresses and matched profile data are personal data; submit and use them only for a lawful, authorized purpose. |
| `LEADMAGIC_GET_B2B_PROFILE_FROM_PROFILE_URL` | Get B2B Profile From Profile URL | Retrieve one person's professional profile, including employment, education, certifications, and honors, from a profile URL or slug. A found full profile costs 1 credit. Returned profile data is personal data; use it only for a lawful, authorized purpose. |
| `LEADMAGIC_GET_BATCH` | Get Batch | Read status, progress, cost, and metadata for a mixed-product batch by its exact batch identifier. A missing synthetic identifier safely returns not found and does not mutate or spend credits. |
| `LEADMAGIC_GET_BATCH_CAMPAIGN_METRICS` | Get Batch Campaign Metrics | Read aggregate usage and success metrics for a batch campaign. A syntactically valid missing identifier can be used for a safe, non-mutating not-found check. |
| `LEADMAGIC_GET_BATCH_CLIENT_METRICS` | Get Batch Client Metrics | Read aggregate batch usage and success metrics for one client UUID. An all-zero missing UUID is safe for a non-mutating not-found check. |
| `LEADMAGIC_GET_BULK_CAPABILITIES` | Get Bulk Capabilities | Return the current bulk submission limits and supported operational features in a stable agent-facing shape. Service-internal host and deployment metadata are intentionally omitted. |
| `LEADMAGIC_GET_BULK_JOB` | Get Bulk Job | Read status, progress, timestamps, and finalized credit usage for one bulk job. Pass a jobId captured from the same owned submission workflow; do not inspect an unrelated workspace job. |
| `LEADMAGIC_GET_BULK_JOB_PROGRESS` | Get Bulk Job Progress | Return LeadMagic's compact progress snapshot for frequent polling of one bulk job owned by the connected workspace. This read does not start, stop, or restart processing. |
| `LEADMAGIC_GET_COMPANY_FUNDING_V1` | Get Company Funding V1 | Call POST /v1/companies/company-funding to get complete funding history and related company intelligence by domain or name. A successful funding result costs 4 credits. |
| `LEADMAGIC_GET_COMPANY_FUNDING_V3_COMPANY_DOCS_ALIAS` | Get Company Funding V3 Company Docs Alias | Call the distinct documented POST /v3/companies/company-funding alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing routes are unmetered; LeadMagic does not state an exact alias-specific charge, so use credits_consumed as finalized spend. |
| `LEADMAGIC_GET_COMPANY_FUNDING_V3_DOCS_ALIAS` | Get Company Funding V3 Docs Alias | Call the distinct documented POST /v3/companies/funding alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing routes are unmetered; LeadMagic does not state an exact alias-specific charge, so use credits_consumed as finalized spend. |
| `LEADMAGIC_GET_COMPANY_TECHNOGRAPHICS_V1` | Get Company Technographics V1 | Get a company's technology stack from its domain. A successful stack result costs 1 credit; use credits_consumed as finalized spend. |
| `LEADMAGIC_GET_CREDIT_BALANCE_V1` | Get Credit Balance V1 | Check the connected LeadMagic workspace's current credit balance for free. |
| `LEADMAGIC_GET_CREDIT_BUDGET_STATUS` | Get Credit Budget Status | Read current limits, remaining credits, and exceeded state for every LeadMagic credit budget. This does not reserve or consume credits. |
| `LEADMAGIC_GET_CREDIT_SERVICE_HEALTH_V1_DOCS_ONLY` | Get Credit Service Health V1 Docs Only | Validate the connected LeadMagic API key and check credit-service authentication status. This medium-confidence docs-only read has an undocumented response schema and billing behavior and was not live-probed. |
| `LEADMAGIC_GET_EMAIL_SUPPRESSION_LIST` | Get Email Suppression List | Return one offset-controlled page of details and irreversible SHA-256 email hashes for one owned suppression list. Use only the exact list_id captured in the same create lifecycle, never auto-fetch pages, and continue only with the returned next_offset. Hashes cannot be converted back to plaintext emails. |
| `LEADMAGIC_GET_JOB_BOARD_STATS_V3` | Get Job Board Stats V3 | Return the free job search dataset statistics through LeadMagic's exact job-board integration alias route. |
| `LEADMAGIC_GET_JOB_SEARCH_CATALOGS` | Get Job Search Catalogs | Return the free filter catalogs used by job search, including countries, regions, job types, industries, company types, and seniority values. This helper consumes 0 credits. |
| `LEADMAGIC_GET_JOB_SEARCH_DATASET_STATS_V3` | Get Job Search Dataset Stats V3 | Return free public coverage, freshness, and capability statistics for the LeadMagic Jobs Search index. |
| `LEADMAGIC_GET_SEARCH_STATS` | Get Search Stats | Return free cached coverage, capabilities, and top dimensions for selected LeadMagic search products. Requested product sections may be absent when unavailable. This helper costs 0 credits. |
| `LEADMAGIC_LIST_BATCH_CLIENTS` | List Batch Clients | List existing organization-scoped client records used to segment batch work. This read does not create or modify clients. |
| `LEADMAGIC_LIST_BATCH_CLIENT_WEBHOOKS` | List Batch Client Webhooks | List delivery webhooks configured for one batch client. This read does not create, change, or invoke webhooks. |
| `LEADMAGIC_LIST_BATCHES` | List Batches | List one bounded page of mixed-product batches for the connected organization. Continue only with the returned next_offset; this tool never auto-fetches additional pages. |
| `LEADMAGIC_LIST_BULK_JOB_ERRORS` | List Bulk Job Errors | Return one offset-controlled page of failed rows and error details for a bulk job owned by the connected workspace. This is read-only and never retries or restarts failed rows. |
| `LEADMAGIC_LIST_BULK_JOB_EVENTS` | List Bulk Job Events | Return the append-only event log, newest first, for one bulk job owned by the connected workspace. Reading events does not alter the job lifecycle. |
| `LEADMAGIC_LIST_BULK_JOB_RESULTS` | List Bulk Job Results | Return one bounded offset page of row-level JSON results for an owned bulk job. Use only a jobId captured from the same submission chain and pass next_offset back explicitly to continue; this tool never auto-fetches all rows. |
| `LEADMAGIC_LIST_BULK_JOBS` | List Bulk Jobs | Return one bounded offset page of bulk jobs owned by the connected account, newest first. Use next_offset to continue; this action never auto-fetches pages. |
| `LEADMAGIC_LIST_CREDIT_BUDGETS` | List Credit Budgets | List all persistent credit budgets configured for the connected LeadMagic workspace, including identifiers needed for owned-budget lifecycle operations. |
| `LEADMAGIC_LIST_EMAIL_SUPPRESSION_LISTS` | List Email Suppression Lists | Read all suppression-list summaries for the connected workspace. This tool is for discovery only: never pass an ID from this result to a mutation or deletion; lifecycle writes must use the exact ID captured from a list created by that workflow. |
| `LEADMAGIC_LIST_EXTERNAL_BATCH_PROVIDERS` | List External Batch Providers | List organization-level external enrichment provider configurations. LeadMagic redacts stored credentials from this read. |
| `LEADMAGIC_LIST_JOB_COMPANY_TYPES_V1` | List Job Company Types V1 | List the company type IDs accepted by the legacy V1 Jobs Finder API. No route-specific charge is documented; reported finalized spend should be treated as authoritative. |
| `LEADMAGIC_LIST_JOB_COUNTRIES_V1` | List Job Countries V1 | List the free country codes accepted by the legacy V1 Jobs Finder API. Use V3 catalogs or locations for V3 job search. |
| `LEADMAGIC_LIST_JOB_INDUSTRIES_V1` | List Job Industries V1 | List the industry IDs accepted by the legacy V1 Jobs Finder API. No route-specific charge is documented; reported finalized spend should be treated as authoritative. |
| `LEADMAGIC_LIST_JOB_OCCUPATION_TAXONOMY_V3` | List Job Occupation Taxonomy V3 | Autocomplete LeadMagic's broad-to-specific occupation taxonomy and return canonical IDs, labels, levels, and paths. This helper is free and consumes 0 credits. |
| `LEADMAGIC_LIST_JOB_REGIONS_V1` | List Job Regions V1 | List the free region IDs accepted by the legacy V1 Jobs Finder API. Use the exact returned IDs with V1 job searches. |
| `LEADMAGIC_LIST_JOB_SEARCH_COMPANY_SUGGESTIONS_V3` | List Job Search Company Suggestions V3 | Autocomplete companies or resolve an exact domain into canonical company IDs and card data for Job Search filters. This helper is free and consumes 0 credits. |
| `LEADMAGIC_LIST_JOB_SEARCH_LOCATION_SUGGESTIONS_V3` | List Job Search Location Suggestions V3 | Autocomplete countries, regions, states, and cities into canonical IDs for exact Job Search geo filters. This helper is free and consumes 0 credits. |
| `LEADMAGIC_LIST_JOB_SEARCH_ROLE_SUGGESTIONS_V3` | List Job Search Role Suggestions V3 | Autocomplete role names into canonical occupation taxonomy IDs for Job Search filters. This helper is free and consumes 0 credits. |
| `LEADMAGIC_LIST_JOB_SEARCH_TAG_SUGGESTIONS_V3` | List Job Search Tag Suggestions V3 | Autocomplete normalized job tags with tag-type and occupation taxonomy metadata for Job Search filters. This helper is free and consumes 0 credits. |
| `LEADMAGIC_LIST_JOB_SEARCH_TITLE_SUGGESTIONS_V3` | List Job Search Title Suggestions V3 | Autocomplete searchable job title phrases with occupation taxonomy metadata for Job Search filters. This helper is free and consumes 0 credits. |
| `LEADMAGIC_LIST_JOB_TYPES_V1` | List Job Types V1 | List the job type IDs accepted by the legacy V1 Jobs Finder API. No route-specific charge is documented; reported finalized spend should be treated as authoritative. |
| `LEADMAGIC_LOOKUP_COMPANY_DOMAIN_V3_DOCS_ALIAS` | Lookup Company Domain V3 Docs Alias | Call the distinct documented POST /v3/companies/domain-lookup alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing routes are unmetered; LeadMagic does not state an exact alias-specific charge, so use credits_consumed as finalized spend. |
| `LEADMAGIC_LOOKUP_COMPANY_V3_DOCS_ALIAS` | Lookup Company V3 Docs Alias | Call the distinct documented POST /v3/companies/lookup alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. This route remains ordinarily metered even when browsing routes are unmetered; LeadMagic does not state an exact alias-specific charge, so use credits_consumed as finalized spend. |
| `LEADMAGIC_PAUSE_BULK_JOB` | Pause Bulk Job | Pause a queued or running LeadMagic bulk job. This mutates processing state but is reversible with Resume Bulk Job. Use only a job ID owned by the connected workspace and intentionally selected for this lifecycle workflow. |
| `LEADMAGIC_PREVIEW_MIXED_BATCH_COST` | Preview Mixed Batch Cost | Estimate the maximum credit cost and budget impact of an exact mixed-product batch payload. This is a free dry run: it does not submit work, reserve credits, or consume credits. |
| `LEADMAGIC_REFRESH_CREDIT_CACHE_V1_DOCS_ONLY` | Refresh Credit Cache V1 Docs Only | Force LeadMagic to refresh the connected workspace's credit cache from its database. This medium-confidence docs-only POST updates cached account state; its response schema and billing behavior are undocumented and it was not live-probed. |
| `LEADMAGIC_REMOVE_EMAILS_FROM_SUPPRESSION_LIST` | Remove Emails From Suppression List | Irreversibly remove specific email suppressions from one owned list, allowing those addresses to be processed again. Use only the exact list_id captured in the same create lifecycle and the exact lifecycle-owned plaintext addresses previously added; never alter a pre-existing list. |
| `LEADMAGIC_RESOLVE_JOB_SEARCH_FILTERS_V3` | Resolve Job Search Filters V3 | Resolve friendly job-search companies, tags, occupation taxonomy, locations, and titles into canonical values. This helper returns no jobs and costs 0 credits. |
| `LEADMAGIC_RESTART_BULK_JOB` | Restart Bulk Job | Destructively restart a LeadMagic bulk job in full, for failed rows only, or from a zero-based row or shard. This irreversible lifecycle operation can repeat work and consume additional credits. Use only an intentionally selected job owned by the connected workspace; inspect its status and errors first. |
| `LEADMAGIC_RESUME_BULK_JOB` | Resume Bulk Job | Resume a paused LeadMagic bulk job. This mutates processing state and may continue the job's existing credit-consuming work. Use only a job ID owned by the connected workspace and intentionally paused in this workflow. |
| `LEADMAGIC_REVIEW_BULK_JOB` | Review Bulk Job | Resume or irreversibly cancel an owned bulk job. Use only a jobId captured from the same submission chain, choose a state-valid transition, and never mutate a pre-existing job discovered by listing workspace jobs. |
| `LEADMAGIC_SEARCH_B2B_ADS_V1` | Search B2B Ads V1 | Search for B2B ads by company domain or name. The exact charge is 1 base credit plus 1 credit per returned ad, with a minimum of 1 credit. Set limit to bound the per-ad portion; use credits_consumed as finalized spend. |
| `LEADMAGIC_SEARCH_COMPANIES` | Search Companies | Call the canonical POST /v3/companies/search route to search or look up companies by domain, name, website, professional profile URL, or company filters and return one cursor-controlled page. On the connected Starter plan, each search request costs 1 credit; eligible higher plans may be unmetered. The page limit is capped at 50. |
| `LEADMAGIC_SEARCH_COMPANIES_V1_LEGACY_DOCS_ALIAS` | Search Companies V1 Legacy Docs Alias | Call the distinct legacy compatibility route POST /v1/companies/search. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. Billing is 1 credit per search on metered plans and unmetered on eligible Search RPS plans; credits_consumed is the finalized spend. |
| `LEADMAGIC_SEARCH_COMPANIES_V3_COMPANY_HYPHENATED_DOCS_ALIAS` | Search Companies V3 Company Hyphenated Docs Alias | Call the distinct documented POST /v3/companies/company-search alias. Prefer SEARCH_COMPANIES for new integrations. Returns one cursor-controlled page. Billing is 1 credit per search on metered plans and unmetered on eligible Search RPS plans; credits_consumed is the finalized spend. |
| `LEADMAGIC_SEARCH_GOOGLE_ADS_V1` | Search Google Ads V1 | Search for Google ads run by a company. Each returned ad costs exactly 1 credit and no results are free. The limit defaults to 1 to bound spend; use credits_consumed as finalized spend. |
| `LEADMAGIC_SEARCH_JOBS` | Search Jobs | Call the canonical POST /v3/jobs/search route to search by title, company, location, taxonomy, tags, salary, seniority, date, and work arrangement, returning one cursor-controlled page. On the connected Starter plan, each returned job costs 1 credit and zero-result pages are free. Eligible higher plans may be unmetered. The page limit is capped at 5, for a maximum exposure of 5 credits per call. |
| `LEADMAGIC_SEARCH_JOBS_V1_LEGACY_DOCS_ALIAS` | Search Jobs V1 Legacy Docs Alias | Call the distinct legacy compatibility route POST /v1/jobs/search; prefer POST /v3/jobs/search for new integrations. Returns one cursor page. Billing is 1 credit per search on metered plans and unmetered on eligible Search RPS plans. |
| `LEADMAGIC_SEARCH_JOBS_V2_LEGACY_DOCS_ALIAS` | Search Jobs V2 Legacy Docs Alias | Call the distinct legacy compatibility route POST /v2/jobs/search; prefer POST /v3/jobs/search for new integrations. Returns one cursor page. Billing is 1 credit per search on metered plans and unmetered on eligible Search RPS plans. |
| `LEADMAGIC_SEARCH_JOBS_V3_HYPHENATED_OPENAPI_ALIAS` | Search Jobs V3 Hyphenated OpenAPI Alias | Search the distinct documented POST /v3/jobs-search alias and return one cursor-controlled page. On metered plans, each returned job can cost 1 credit; the page limit is capped at 5 credits of result exposure. |
| `LEADMAGIC_SEARCH_JOBS_V3_SINGULAR_DOCS_ALIAS` | Search Jobs V3 Singular Docs Alias | Call the distinct documented compatibility route POST /v3/job-search; prefer POST /v3/jobs/search for new integrations. Returns one cursor page. Billing is 1 credit per search on metered plans and unmetered on eligible Search RPS plans. |
| `LEADMAGIC_SEARCH_META_ADS_V1` | Search Meta Ads V1 | Search for Meta ads by company domain or name. Each returned ad costs exactly 1 credit and no results are free. The limit defaults to 1 to bound spend; use credits_consumed as finalized spend. |
| `LEADMAGIC_SEARCH_PEOPLE` | Search People | Call the canonical POST /v3/people/search route to search by company, title, role, free text, and contact availability, returning one cursor-controlled page without raw email or mobile details. On the connected Starter plan, each returned person costs 1 credit; zero results are free. The maximum base exposure is 10 credits per call. |
| `LEADMAGIC_SEARCH_PEOPLE_V1_LEGACY_DOCS_ALIAS` | Search People V1 Legacy Docs Alias | Call the distinct legacy compatibility route POST /v1/people/search; prefer the canonical V3 route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each returned person costs 1 credit on metered plans; zero results are free; maximum base exposure is 10 credits. |
| `LEADMAGIC_SEARCH_PEOPLE_V2_LEGACY_DOCS_ALIAS` | Search People V2 Legacy Docs Alias | Call the distinct legacy compatibility route POST /v2/people/search; prefer the canonical V3 route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each returned person costs 1 credit on metered plans; zero results are free; maximum base exposure is 10 credits. |
| `LEADMAGIC_SEARCH_PEOPLE_V3_BY_TITLE_DOCS_ALIAS` | Search People V3 By Title Docs Alias | Call the distinct compatibility route POST /v3/people/by-title; prefer the canonical route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each returned person costs 1 credit on metered plans; zero results are free; maximum base exposure is 10 credits. |
| `LEADMAGIC_SEARCH_PEOPLE_V3_COMPANY_DOCS_ALIAS` | Search People V3 Company Docs Alias | Call the distinct documented POST /v3/people/company-search alias. Prefer SEARCH_PEOPLE for new integrations. Returns one cursor page without raw contacts. Each returned person costs 1 base credit; zero results are free. |
| `LEADMAGIC_SEARCH_PEOPLE_V3_CONTACTS_BY_TITLE_DOCS_ALIAS` | Search People V3 Contacts By Title Docs Alias | Call the distinct compatibility route POST /v3/people/contacts-by-title; prefer the canonical route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each returned person costs 1 credit on metered plans; zero results are free; maximum base exposure is 10 credits. |
| `LEADMAGIC_SEARCH_PEOPLE_V3_EMPLOYEES_DOCS_ALIAS` | Search People V3 Employees Docs Alias | Call the distinct compatibility route POST /v3/people/employees; prefer the canonical route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each returned person costs 1 credit on metered plans; zero results are free; maximum base exposure is 10 credits. |
| `LEADMAGIC_SEARCH_PEOPLE_V3_FULL_DOCS_ALIAS` | Search People V3 Full Docs Alias | Call the distinct documented POST /v3/people/full-search alias. Prefer SEARCH_PEOPLE for new integrations. Despite its route name, raw contacts stay disabled. Each returned base person costs 1 credit; zero results are free. |
| `LEADMAGIC_SEARCH_PEOPLE_V3_ICP_DOCS_ALIAS` | Search People V3 Icp Docs Alias | Call the distinct documented compatibility route POST /v3/people/icp-search; prefer POST /v3/people/search for new integrations. Returns one base-only cursor page and never requests raw contact details. Each returned person costs 1 credit on metered plans; zero results are free; maximum base exposure is 10 credits. |
| `LEADMAGIC_SEARCH_PEOPLE_V3_LOOKALIKE_DOCS_ALIAS` | Search People V3 Lookalike Docs Alias | Call the distinct compatibility route POST /v3/people/lookalike; prefer the canonical route for new integrations. Returns one base-only cursor page and never requests raw contact details. Each returned person costs 1 credit on metered plans; zero results are free; maximum base exposure is 10 credits. |
| `LEADMAGIC_SEARCH_PEOPLE_V3_MIXED_DOCS_ALIAS` | Search People V3 Mixed Docs Alias | Call the distinct documented POST /v3/people/mixed-search alias. Prefer SEARCH_PEOPLE for new integrations. Returns one cursor page without raw contacts. Each returned person costs 1 base credit; zero results are free. |
| `LEADMAGIC_SEARCH_PEOPLE_V3_SINGULAR_DOCS_ALIAS` | Search People V3 Singular Docs Alias | Call the distinct documented POST /v3/person/search alias. Prefer SEARCH_PEOPLE for new integrations. Returns one cursor page of base person data without raw contacts. Each returned person costs 1 base credit; zero results are free. |
| `LEADMAGIC_SUBMIT_BULK_JOB` | Submit Bulk Job | Create one asynchronous bulk enrichment job from exactly one input mode. This can consume credits for every processed row. Retain the returned jobId and use only that owned ID for follow-up reads or lifecycle changes. |
| `LEADMAGIC_SUBMIT_BULK_LOCAL_LEADS_JOB` | Submit Bulk Local Leads Job | Create a long-running local-leads bulk job. Every keyword-city combination becomes work and may consume credits. Retain the returned jobId and use only that owned ID for follow-up reads or lifecycle changes. |
| `LEADMAGIC_SUBMIT_MIXED_PRODUCT_BATCH` | Submit Mixed Product Batch | Create one asynchronous mixed-product enrichment batch. This can consume credits for every item: preview the exact payload first, keep the item count bounded, and supply an idempotency_key before submitting. |
| `LEADMAGIC_UPDATE_BATCH_METADATA` | Update Batch Metadata | Update metadata or client association for an owned batch during its mutable window. Use only a product and batch_id captured from the same submitted batch; never mutate a batch discovered by listing workspace data. |
| `LEADMAGIC_UPDATE_BULK_JOB_PRIORITY` | Update Bulk Job Priority | Change the priority of a queued or running LeadMagic bulk job owned by the connected workspace. This mutates scheduling but does not restart the job or change which rows it processes. |
| `LEADMAGIC_UPDATE_CREDIT_BUDGET` | Update Credit Budget | Update one or more controls on a credit budget created and owned by the caller. Use only an id captured from that owned budget lifecycle; never modify a budget discovered incidentally in workspace listings. |
| `LEADMAGIC_VALIDATE_BULK_SUBMISSION` | Validate Bulk Submission | Validate exactly one bulk input mode and its options without persisting or processing a job. This is a contract check, not a submission. |
| `LEADMAGIC_VALIDATE_EMAIL` | Validate Email | Check one email address for deliverability and return mail-server and company context. A definitive valid or invalid result costs 0.25 credits; an unknown result is free. Exactly one email is validated per call. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The LeadMagic MCP server provides comprehensive access to LeadMagic operations through Composio. Once connected, Hermes can perform all major LeadMagic actions on your behalf using natural language commands.

## Complete Code

None listed.

## Conclusion

### Way Forward
With LeadMagic connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.
From here, you can extend Hermes further:
- Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
- Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
- Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.
If you run into trouble or want to share what you've built, join the [community](https://discord.com/invite/composio) or check out the [Docs](https://docs.composio.dev?utm_source=toolkits&utm_medium=framework_template&utm_campaign=hermes&utm_content=docs) for deeper configuration options.

## How to build LeadMagic MCP Agent with another framework

- [ChatGPT Work](https://composio.dev/toolkits/leadmagic/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/leadmagic/framework/claude-cowork)

## Related Toolkits

- [HubSpot](https://composio.dev/toolkits/hubspot) - HubSpot is an all-in-one marketing, sales, and customer service platform. It lets teams nurture leads, automate outreach, and track every customer interaction in one place.
- [Pipedrive](https://composio.dev/toolkits/pipedrive) - Pipedrive is a sales management platform offering pipeline visualization, lead tracking, and workflow automation. It helps sales teams keep deals moving forward efficiently and never miss a follow-up.
- [Salesforce](https://composio.dev/toolkits/salesforce) - Salesforce is a leading CRM platform that helps businesses manage sales, service, and marketing. It centralizes customer data, enabling teams to drive growth and build strong relationships.
- [Apollo](https://composio.dev/toolkits/apollo) - Apollo is a CRM and lead generation platform that helps businesses discover contacts and manage sales pipelines. Use it to streamline customer outreach and track your deals from one place.
- [Attio](https://composio.dev/toolkits/attio) - Attio is a customizable CRM and workspace for managing your team's relationships and workflows. It helps teams organize contacts, automate tasks, and collaborate more efficiently.
- [Acculynx](https://composio.dev/toolkits/acculynx) - AccuLynx is a cloud-based roofing business management software for contractors. It streamlines project tracking, lead management, and document sharing.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Affinity](https://composio.dev/toolkits/affinity) - Affinity is a relationship intelligence CRM that helps private capital investors find, manage, and close more deals. It streamlines deal flow and surfaces key connections to help you win opportunities.
- [Agencyzoom](https://composio.dev/toolkits/agencyzoom) - AgencyZoom is a sales and performance platform built for P&C insurance agencies. It helps agents boost sales, retain clients, and analyze producer results in one place.
- [Agile CRM](https://composio.dev/toolkits/agile_crm) - Agile CRM is a unified customer management platform combining contacts, sales pipelines, marketing, and support. Use it to centralize customer data, automate campaigns, and manage deals and tickets in one place.
- [Bettercontact](https://composio.dev/toolkits/bettercontact) - Bettercontact is a smart contact enrichment tool for finding emails and phone numbers. It helps boost lead generation with automated, waterfall search across multiple sources.
- [Blackbaud](https://composio.dev/toolkits/blackbaud) - Blackbaud provides cloud-based software for nonprofits, schools, and healthcare institutions. It streamlines fundraising, donor management, and mission-driven operations.
- [Blitz API](https://composio.dev/toolkits/blitz_api) - Blitz API is a people, company, and job search API with contact and company enrichment. Use it to enrich leads and accelerate sales outreach with accurate contact and firmographic data.
- [Brilliant directories](https://composio.dev/toolkits/brilliant_directories) - Brilliant Directories is an all-in-one platform for building and managing online membership communities and business directories. It streamlines listings, member management, and engagement tools into a single, easy interface.
- [Capsule crm](https://composio.dev/toolkits/capsule_crm) - Capsule CRM is a user-friendly CRM platform for managing contacts and sales pipelines. It helps businesses organize relationships and streamline their sales process efficiently.
- [Centralstationcrm](https://composio.dev/toolkits/centralstationcrm) - CentralStationCRM is an easy-to-use CRM software focused on collaboration and long-term customer relationships. It helps teams manage contacts, deals, and communications all in one place.
- [Clarify MCP](https://composio.dev/toolkits/clarify_mcp) - Clarify MCP is a CRM platform for managing companies, people, deals, meetings, tasks, lists, and campaigns. Use it to centralize CRM data and streamline sales and marketing workflows.
- [Clay MCP](https://composio.dev/toolkits/clay_mcp) - Clay MCP is a prospect enrichment service for researching companies and contacts. It runs enrichment providers and Clay functions to return enriched prospect data.
- [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time.
- [Close](https://composio.dev/toolkits/close) - Close is a CRM platform built for sales teams, combining calling, email automation, and predictive dialers. It streamlines sales workflows and boosts productivity with all-in-one communication tools.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and LeadMagic MCP?

With a standalone LeadMagic MCP server, the agents and LLMs can only access a fixed set of LeadMagic tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from LeadMagic and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Hermes?

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right LeadMagic tools.

### Can I manage the permissions and scopes for LeadMagic while using Tool Router?

Yes, absolutely. You can configure which LeadMagic scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your LeadMagic data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)