How to connect LeadMagic to Hermes Agent
Connect LeadMagic to Hermes with ClawLink: paste your LeadMagic key once and 109 tools work from chat. No MCP server to run, nothing stored on your machine.
LeadMagicAPI KEYMCPLeadMagic provides people, company, jobs, advertising, and enrichment data for sales and recruiting workflows.. Once connected, Hermes Agent can read and act on LeadMagic from chat — pairing, token refresh, and tool wiring handled for you.
Most guides for giving Hermes Agent LeadMagic access start with registering your own OAuth app or pasting API keys into env files, then leave the token refresh and tool wiring to you. ClawLink gives Hermes a more practical LeadMagic setup: pair once in the browser and your always-on Hermes agent can act on LeadMagic for you, reading and doing real work on your behalf with no auth, token refresh, or tool wiring to build yourself.
Copy this prompt into Hermes to install the plugin and pair your account.
Set up ClawLink for Hermes and tell me when it's ready.
1. Install the plugin:
hermes plugins install ClawLink-HQ/hermes-plugin --enable
2. Start pairing. It prints an approval link, so show me the link and stop, don't wait:
hermes clawlink begin
3. I'll approve it in my browser, then reply "approved".
4. When I say approved, finish setup:
hermes clawlink finish
5. Then run `hermes clawlink test` and tell me whether ClawLink is ready.Setup
It takes three steps to connect Hermes to LeadMagic.
1Install and pair
Install the ClawLink plugin, then pair Hermes with a one-time browser approval:
hermes plugins install ClawLink-HQ/hermes-plugin --enable- 2
Connect LeadMagic
Paste your API key in the dashboard.
- 3
Use it from chat
Ask Hermes Agent: "What can you do with LeadMagic?"
Install by command
The prompt above walks Hermes through this. By hand, it is four commands and a browser approval:
hermes plugins install ClawLink-HQ/hermes-plugin --enable
hermes clawlink begin # prints an approval link — open it and approve
hermes clawlink finish # after approving in the browser
hermes clawlink testThen connect LeadMagic in the ClawLink dashboard — paste your LeadMagic API key once.
Verify the connection by asking Hermes:
Search LeadMagic for what I need, summarize the results, and tell me the next best action.
Using a different agent?
The Hermes plugin is one client of ClawLink's MCP server. Claude Code, Cursor, Codex, or any agent that can run a shell command pairs with the same ClawLink account through the CLI:
npx -y @useclawlink/cli loginlogin opens the same browser approval and stores a credential locally. Once LeadMagic is connected in the dashboard, that agent calls the same 109 LeadMagic tools over MCP. Full setup for MCP clients and shell agents: connect apps to any AI agent.
LeadMagic MCP for Hermes
Looking for a LeadMagic MCP server for Hermes Agent? ClawLink connects LeadMagic to Hermes Agent and exposes 109 LeadMagic tools your agent can call over MCP, with hosted auth and nothing to run or maintain yourself. Using OpenClaw instead? The OpenClaw LeadMagic integration works the same way.
What the Hermes Agent LeadMagic integration can do
109 LeadMagic tools are ready for Hermes Agent once the account is connected. The 30 below are the ones people reach for most; your agent can call all 109.
30 of 109 LeadMagic tools for Hermes
| Tool | What it does |
|---|---|
Create job search export v3 leadmagic_create_job_search_export_v3 | Synchronously export up to 5,000 matching jobs |
Detect job change leadmagic_detect_job_change | Check whether a person has changed jobs relative to an expected company |
Download bulk job results CSV leadmagic_download_bulk_job_results_csv | Download all result rows for an owned bulk job as a CSV file |
Enrich company v1 leadmagic_enrich_company_v1 | Call POST /v1/companies/company-search to enrich one company from its domain, name, or business |
Enrich company v3 docs alias leadmagic_enrich_company_v3_docs_alias | Call the distinct documented POST /v3/companies/enrich alias |
Find company competitors v1 leadmagic_find_company_competitors_v1 | Find competitors from a company domain, profile, or name |
Find company employees v1 leadmagic_find_company_employees_v1 | Find up to 10 employees at one company, returning names, titles, locations, and professional |
Find jobs v1 leadmagic_find_jobs_v1 | Call POST /v1/jobs/jobs-finder to find jobs with the LeadMagic V1 filters |
Find lookalike companies v3 leadmagic_find_lookalike_companies_v3 | Find similar companies from a seed domain, name, or description |
Find mobile phone leadmagic_find_mobile_phone | Find one person's mobile phone number from a professional profile URL or known email |
Find person by role v1 leadmagic_find_person_by_role_v1 | Find one person by job title at a specified company |
Find personal email leadmagic_find_personal_email | Find one person's personal email addresses from a professional profile URL or identifier |
Find work email leadmagic_find_work_email | Find one person's work email from their name and company domain or name |
Find work email from b2b profile leadmagic_find_work_email_from_b2b_profile | Find one person's work email from a professional profile URL or slug |
Get account overview leadmagic_get_account_overview | Return the connected workspace's available credits, API-key permission summary, current rate |
Get analytics all time summary leadmagic_get_analytics_all_time_summary | Get documented lifetime account request, credit, product, success, and latency statistics |
Get analytics credit history leadmagic_get_analytics_credit_history | Get LeadMagic credit consumption history with a daily breakdown |
Get analytics daily metrics leadmagic_get_analytics_daily_metrics | Get documented daily request, credit, latency, and error metrics for the last 1 to 90 days |
Get analytics day breakdown leadmagic_get_analytics_day_breakdown | Get the documented per-product request and credit breakdown for one date |
Get analytics products leadmagic_get_analytics_products | Get per-product LeadMagic usage with request, credit, and success metrics |
Get analytics usage leadmagic_get_analytics_usage | Get daily LeadMagic usage with request, credit, and chargeable-rate totals |
Get b2b ad details v1 leadmagic_get_b2b_ad_details_v1 | Get full details for a specific B2B ad from its library URL, detail path, or numeric ID |
Get b2b profile from email leadmagic_get_b2b_profile_from_email | Find one person's professional profile from a supplied work or personal email |
Get b2b profile from profile URL leadmagic_get_b2b_profile_from_profile_url | Retrieve one person's professional profile, including employment, education, certifications |
Get batch leadmagic_get_batch | Read status, progress, cost, and metadata for a mixed-product batch by its exact batch |
Get batch campaign metrics leadmagic_get_batch_campaign_metrics | Read aggregate usage and success metrics for a batch campaign |
Get batch client metrics leadmagic_get_batch_client_metrics | Read aggregate batch usage and success metrics for one client UUID |
Get bulk capabilities leadmagic_get_bulk_capabilities | Return the current bulk submission limits and supported operational features in a stable |
Get bulk job leadmagic_get_bulk_job | Read status, progress, timestamps, and finalized credit usage for one bulk job |
Get bulk job progress leadmagic_get_bulk_job_progress | Return LeadMagic's compact progress snapshot for frequent polling of one bulk job owned by the |
Try it: find the LeadMagic tool you need
Browse the 30 LeadMagic tools
Click any tool to see exactly what Hermes can do and copy a ready-to-use prompt.
Example prompts
Search LeadMagic for what I need, summarize the results, and tell me the next best action.
Use LeadMagic to detect job change and walk me through the result in plain English.
Use LeadMagic to download bulk job results csv and walk me through the result in plain English.
Use LeadMagic to enrich company v1 and walk me through the result in plain English.
ClawLink vs. building it yourself
The alternative to ClawLink is usually manual API key setup plus your own token handling, permission troubleshooting, and tool plumbing for Hermes Agent. That is fine if you want to build and maintain the integration yourself. Most teams just want LeadMagic working from chat.
| Manual | ClawLink | |
|---|---|---|
| Credential handling | Collect, validate, store, and rotate the LeadMagic API key yourself, then make sure every tool call uses the right account. | Users complete the hosted ClawLink setup once and the connected LeadMagic account becomes available to the agent without you building credential management. |
| Ongoing maintenance | You own refresh logic, permission debugging, environment config, and every provider-specific edge case for LeadMagic. | ClawLink handles the repetitive integration plumbing so your team can focus on the workflow instead of the infrastructure. |
| Agent usability | You still need to expose the right LeadMagic actions to the runtime in a format your agent can reliably use. | 109 tools for LeadMagic are already exposed through ClawLink, so the agent can read and act from chat immediately. |
ClawLink vs. Composio
Composio also exposes LeadMagic to AI agents. It is developer infrastructure: Python and TypeScript SDKs, an MCP server, and a catalog past 1,000 apps, aimed at teams shipping agent products. ClawLink is built for Hermes Agent users instead. You install the plugin once, connect LeadMagic in the browser, and the 109 tools above work from chat. There is no SDK and no config file, and the LeadMagic key you paste at setup is stored server-side rather than kept in your environment. Choosing between them? Read the full Composio alternatives comparison.
Troubleshooting
Hermes paired but still can't use LeadMagic
Pairing is a two-step handshake: run hermes clawlink begin, approve the link in your browser, then run hermes clawlink finish. If you ran finish before approving, or the approval link expired, run hermes clawlink begin again to get a fresh link. Confirm the plugin was installed with --enable, then verify with hermes clawlink test.
Connection succeeds but no tools appear
Reconnect LeadMagic from the dashboard, then start a fresh chat if the runtime still has the old tool catalog loaded.
"Tool schema not loaded yet" error when calling LeadMagic tools
LeadMagic tool schemas load on demand the first time a tool runs and are cached after that, so this error usually clears on its own: wait a few seconds and retry the same request. If every LeadMagic call keeps failing with it in a fresh chat, reconnect from the dashboard, and contact support if it still persists — that pattern points to a configuration problem on our side, not something you can fix by reconnecting again.
LeadMagic returns 403 or "permission denied" on one action while others work
Two usual causes. The connected account may not have access to the specific workspace, inbox, store, or project in the request — check that first. If access looks right, the agent may have sent a placeholder value (like "YOUR_ID" or an example id from documentation) instead of a real one: ask it to run a list or search tool first, then retry the action with a real id from those results. Most failures at this stage are one of these two, not ClawLink bugs.
API key setup works but results look incomplete
Double-check that the API key for LeadMagic has the right scopes or account access. A valid key can still be too limited for some reads or writes.
FAQ
Is there a Hermes Agent LeadMagic integration?
Yes. ClawLink is the fastest way to connect Hermes to LeadMagic: link your LeadMagic account once in the browser and Hermes Agent can call the LeadMagic API through 109 ready-made tools — no custom code or token handling.
How do I connect LeadMagic to Hermes with ClawLink?
Install the plugin with hermes plugins install ClawLink-HQ/hermes-plugin --enable, then pair once: run hermes clawlink begin, approve the link in your browser, and run hermes clawlink finish. Connect LeadMagic in the dashboard and Hermes can use it from the next message — no config files, and the LeadMagic key you paste is stored server-side instead of in your environment.
How long does it take to connect LeadMagic to Hermes Agent?
About two minutes. Sign in, click Connect next to LeadMagic in the dashboard, authenticate, and Hermes Agent can use it from the next chat message.
Why use ClawLink instead of wiring LeadMagic up myself?
The alternative to ClawLink is usually manual API key setup plus your own token handling, permission troubleshooting, and tool plumbing for Hermes Agent. That is fine if you want to build and maintain the integration yourself. Most teams just want LeadMagic working from chat.
Hermes paired but still can't use LeadMagic
Pairing is a two-step handshake: run hermes clawlink begin, approve the link in your browser, then run hermes clawlink finish. If you ran finish before approving, or the approval link expired, run hermes clawlink begin again to get a fresh link. Confirm the plugin was installed with --enable, then verify with hermes clawlink test.
Related
Hermes DataRobot integration
DataRobot is a machine learning platform that automates model building, deployment, and monitoring, enabling organizations to derive predictive insights from large datasets.
Hermes Chatbotkit integration
ChatBotKit is a platform that enables developers to build and manage AI-powered chatbots, offering comprehensive APIs and SDKs for seamless integration into applications.
Just One API
Just One API provides unified access to public social media, creator, entertainment, and ecommerce data across hundreds of metered endpoints.