ContactOut helps recruiters and sales teams find professional contact information and build targeted prospect lists. Discover work emails, phone numbers, and professional profiles, search for candidates by role and company, and enrich lead records for recruiting and B2B outreach.
Hermes is Nous Research's command-line agent. MCP servers are declared in its YAML config and reloaded without a restart.
This guide connects ContactOut MCP to Hermes through MewCP, so Hermes can use ContactOut MCP's 15 tools, like get-api-usage-stats, people-search and people-enrich, without your ContactOut MCP credentials ever reaching the app.
ContactOut MCP signs in through managed OAuth. MewCP stores the token encrypted, refreshes it before it expires and injects it only at call time. Your agent never holds it, so it can never leak it.
More apps
Ask your AI to find companies, verify email addresses, and build leads lists with Hunter’s MCP.
Search Apollo's B2B contact and company database, enrich records in bulk, and manage email sequences from your connected Apollo account.
Brevo's marketing and CRM platform — manage contacts, lists and segments, send transactional and campaign email, run SMS and WhatsApp campaigns, and track deals and companies
HubSpot connects AI agents to CRM data and business workflows, enabling them to search and manage contacts, companies, deals, tickets, and engagement records, and access HubSpot tools through its remote MCP server.
Other clients
ContactOut MCP works the same way in every client below. Pick yours for its own guide.
Free to start.
Scope access to the exact ContactOut MCP tools and accounts you allow, work and personal side by side. Anything outside that scope is refused at call time, even when the model asks for it.
Each call is logged: what ran, on which account, and whether it worked. Failures come back structured, so the agent knows whether to retry instead of guessing.
Every app sits behind one secure MCP URL, and there is no server for you to deploy or keep running. Add an integration in the dashboard and it is live on the next call, with no config to change and no new credentials to wire up. Tools load only when a task needs them, so your agent stays fast and focused however many apps you connect.
Edit config.yaml in your Hermes config directory (~/.hermes).
Put this under the top-level "mcp_servers:" key.
Run /reload-mcp in Hermes, or start a fresh session. Sign in when the browser window opens.
Start a new chat and ask: "List the tools you can use from MewCP." You should see your connected apps.
Get ContactOut account stats for email, phone, and search for the requested month (`usage` in the JSON body). Responses: - `count` / `phone_count` / `search_count`: successful API requests that consumed that credit in the period. - `quota` / `phone_quota` / `search_quota`: postpaid → monthly quota; prepaid → current prepaid balance. - `remaining` / `phone_remaining` / `search_remaining`: postpaid only; credits left in the month vs period usage. - `over_quota` / `phone_over_quota` / `search_over_quota`: postpaid only; amount over monthly quota when applicable. - `is_prepaid`: boolean indicating if the account is prepaid (true) or postpaid (false). Search (postpaid only): if the account has unlimited search credits, `search_quota` may be the string `unlimited` and `search_remaining` / `search_over_quota` may be omitted.
Get profiles matching the search criteria. Some parameters accept boolean expressions using OR, AND, and NOT. Use parentheses so grouping is explicit (e.g. `(React AND Python) NOT Java`). For example, if you are looking for profiles who have the skills ReactJS and Python, but not Java, you can format the skills parameter as: { "skills": ["(ReactJS AND Python) NOT Java"] }. Always add brackets to ensure the boolean logic is applied correctly. Supported operators: OR, AND, NOT. Responses contain meta information and the matching list of profiles. Each profile contains the information like title, headline, company details, experience, skills etc. It also lists the contact availability and contact information fields. Cost: Consumes 1 search credit for each profile returned. Consumes 1 email/phone credit for every profile where email/phone info is found, if `reveal_info=true` is specified.
Get profile details using a combination of data points such as name, email, phone, LinkedIn URL, company information, education, and location. This tool provides flexible enrichment by allowing you to provide multiple identifying parameters to find and enrich a person's profile. By default, this endpoint returns profile information without contact details. To include contact information such as email addresses and phone numbers, you must specify the include parameter with the desired contact types. Matching rules: supply one primary identifier (`linkedin_url`, `email`, or `phone`) **or** a name (`full_name`, or `first_name` + `last_name`) together with at least one secondary field among `company`, `company_domain`, `job_title`, `location`, or `education`. Contact details only appear when you list them in `include` (`work_email`, `personal_email`, `phone`). Cost: Consumes 1 search credit if a profile was found. Consumes 1 email credit if email is found and 1 phone credit if phone number is found.
Get the total count of profiles matching the search criteria. Uses the same request fields as the `people-search` tool except do not send `page`, `data_types`, or `reveal_info` (they are not supported for counts). Cost: Does not consume credits Access: Only available to paid users
Get profile details for a single linkedin profile URL. Only standard LinkedIn profile URLs are accepted—not Sales Navigator or Talent / Recruiter products. Returns email addresses, phone numbers, work experience, education, skills, and more associated with a LinkedIn profile. Cost: Consumes 1 email credit if email is found and 1 phone credit if phone number is found. Consumes 1 search credit if `profile_only` is set to true or if there is no contact information available for the requested profile.
Get profile details for a single email address. The match rate is typically higher with a personal email address as they change less frequently. For work emails, if the domain is from a past employer, previous work experience is checked to ensure accurate identification. Cost: Consumes 1 email credit if email is found and 1 phone credit if phone number is found.
Get contact details for a single LinkedIn profile. Requesting real-time work emails via `email_type=work` may increase response time. Real-time verified `work_email` is **not** included unless you pass `email_type` accordingly. LinkedIn URLs from Sales Navigator or Recruiter are not supported. If `email_type` is not specified in the request, the response includes both personal and work emails. However, real-time verification is only performed when `email_type=work` is explicitly included, which may yield more work email results but can increase response time. Cost: Consumes 1 email credit if email is found and 1 phone credit if phone number is found (and `include_phone` is set to `true`).
Get LinkedIn profile url for a given email. Cost: Consumes 1 email credit if profile is found.
Verify the deliverability of an email address. `status` returns the status of the email address. Below are the possible values: - `valid`: the email address is valid. - `invalid`: the email address is not valid. - `accept_all`: the email address is valid but any email address is accepted by the server. - `disposable`: the email address comes from a disposable email service provider. - `unknown`: we failed to verify the email address. Cost: Consumes 1 "verifier" credit if result is either `valid`, `invalid` or `accept_all`
Get personal email availability status for a single Linkedin profile Cost: Does not consume credits Access: Only available to paid users
Get work email availability status for a single LinkedIn profile Response: `profile.email` returns true if work email is present. `profile.email_status` returns whether the email is verified or unverified, and may be `Verified`, `Unverified`, or `null`. Cost: Does not consume credits Access: Only available to paid users
Get phone availability status for a single LinkedIn profile Cost: Does not consume credits Access: Only available to paid users
Get profiles of key decision makers within a specified company. **At least one** of `linkedin_url`, `domain`, or `name` is required. You may pass any combination of these to identify the company. Cost: Consumes 1 search credit for each profile returned. Consumes 1 email/phone credit for every profile where email/phone info is found, if `reveal_info=true` is specified.
Get company profiles matching the search criteria. Cost: Consumes 1 search credit for each company returned.
Get company information based on given input domains. Cost: Consumes 1 search credit for each company found.
