MCP App Store
by KeenEthics
SalesQL icon

SalesQL MCP Server for ChatGPT

By SALESQL LTD

Overview

SalesQL brings B2B prospecting and contact enrichment into your conversations. Describe who you sell to, and SalesQL helps you turn that into a list of matching people and companies with business contact details. What you can do: - Search people by current or past job title, industry, location, company, company size, company type, years of experience and contact availability, and review the matches before revealing any contact data. - Search companies by name, LinkedIn page, industry, location, employee count, company type and founding year. - Reveal emails (with verification status) and phone numbers for specific people, one at a time or up to 100 per request. - Enrich companies with firmographic details such as domain, industry, size, location and LinkedIn page. - Verify whether email addresses accept mail before you reach out, one at a time or up to 500 in a bulk job. - Check which SalesQL account is connected. The included Find Leads workflow drafts an ideal customer profile from your business description or website, resolves the search filters, shows you a shortlist and asks for your approval before revealing any contacts. Who it is for: sales, business development, marketing and recruiting teams that use SalesQL to find and contact prospects. How it works and limitations: - Requires a SalesQL account. You connect it by signing in to SalesQL; no API key is needed. - Search results show contact data in masked form, and contact details are revealed only for the people you choose. ChatGPT may ask you to confirm before revealing contact details or verifying emails. - Coverage varies by person, company and region; not every profile has an email address or phone number. - This plugin does not send emails, run campaigns or update your CRM.

How to connect

  1. ChatGPT: Open the SalesQL listing in the ChatGPT app directory and choose Connect. ChatGPT listing SalesQL exposes 11 tools here.

Tools

enrich_organization

ChatGPT
Enrich an organization/company using SalesQL. Use when the user asks for organization details, company domain, industry, size, website, logo, LinkedIn, or company profile data. Prefer linkedin_url, then organization_domain, then organization_name. Do NOT use for enriching people or contacts. This tool does not consume SalesQL credits.

enrich_organization_bulk

ChatGPT
Enrich up to 100 organizations/companies in one SalesQL request. Use when the user asks to enrich a batch, list, CSV-like group, or multiple companies at once. Each organization should include a linkedin_url, organization_domain, or organization_name. Do NOT use for enriching people or contacts. This tool does not consume SalesQL credits.

enrich_person

ChatGPT
Look up one business contact in SalesQL's B2B database for sales, recruiting or marketing outreach. Returns the professional profile (name, headline, current job title and company, work history, industry, city-level location, LinkedIn URL and profile photo URL) and the emails and phone numbers SalesQL holds for that professional. Use when the user wants the contact details of a specific professional. Identify the person by linkedin_url (preferred), email, or full name plus organization_name or organization_domain. Do NOT use for companies (call enrich_organization). Do NOT use to locate private individuals or to get anyone's contact details for personal, non-business purposes. Uses up to 1 SalesQL enrichment credit.

enrich_person_bulk

ChatGPT
Look up 1 to 100 business contacts in SalesQL's B2B database in one request, for sales, recruiting or marketing outreach. Returns one result per item: the professional profile and the emails and phone numbers SalesQL holds for that professional, or an item-level error. Use when the user provides a list of professionals to enrich. Each item needs a linkedin_url, an email, or a full name plus organization_name or organization_domain. Do NOT use for companies (call enrich_organization_bulk). Do NOT use to locate private individuals or for personal, non-business purposes. Uses up to 1 SalesQL enrichment credit per person found; tell the user the estimate and wait for confirmation before calling.

get_account_status

ChatGPT
Return the current SalesQL account status for the authenticated credential: plan, available enrichment credits, next credit refresh, monthly included credits, role, rate limits, low-credit warnings and whether the account is suspended (banned). Use it before enrichment when the user asks about credits, plan, quota, balance, or whether they have enough credits. The email of the connected SalesQL account (account_email) is left out unless include_account_email is true: set it only when the user explicitly asks which SalesQL account or workspace is connected, for example to confirm they are using the right account, and do not repeat the email in answers about credits or plan. It still answers while an account is suspended, so use it to confirm a suspension another tool reported. This tool does not consume SalesQL credits.

get_email_verification_job

ChatGPT
Read the progress and results of a bulk email verification job created by verify_emails_bulk. Use it with the 'job_id' that tool returned; it does not consume credits. While 'status' is 'queued' or 'processing', 'results' is empty: wait 'retry_after_seconds' and call again. When 'status' is 'completed', 'results' lists every address with its 'status' ('valid', 'invalid', 'catch_all' or 'unknown') and 'email_type', and 'credits_charged' is final. 'failed' means the job could not run and 'failed_not_credits' means the verification balance ran out while it was running: in both cases stop polling, tell the user and do not restart the job. Do NOT use for jobs created from the SalesQL dashboard: they are not visible here.

lookup

ChatGPT
Resolve the exact filter values for company_size, company_type, industry, country, or region before building a search_people or search_organizations request. Call lookup FIRST whenever you need to filter by any of those five categories — it returns the canonical {value, label} pairs for the requested type. 'q' is REQUIRED for industry, country and region (they are fuzzy-searched, never listed in full) and ignored for company_size and company_type. Each type feeds a named filter field. In search_organizations: company_size -> employee_ranges, company_type -> company_types, industry -> industries, country -> countries, region -> states_or_cities. In search_people the same values go to organization_employee_ranges, organization_company_types, industries or organization_industries, countries or organization_countries, and states_or_cities or organization_states_or_cities. ALWAYS pass 'value' (not 'label') to those filter fields. For industry, 'value' is a slug; for country and region it is an opaque UUID — treat both as opaque identifiers; never invent or translate them. This tool does not consume SalesQL credits.

search_organizations

ChatGPT
Find companies matching name, LinkedIn company URL, location, industry, employee-count, company-type and founding-year filters. Returns firmographic summaries; it does not consume SalesQL credits. Use when the user wants to BUILD OR QUALIFY A LIST OF COMPANIES ('which SaaS companies in Spain have 51-200 employees?'), or to turn company criteria into the organization identifiers the people search needs. Do NOT use when the user already named one specific company and wants its full profile — call enrich_organization instead. Do NOT use to find PEOPLE: call search_people, which takes the same company criteria through its own organization filters. Call lookup FIRST to resolve valid values for countries, states_or_cities, industries, employee_ranges (lookup type 'company_size') and company_types (lookup type 'company_type') — never guess these identifiers. uuids, countries, states_or_cities, industries, employee_ranges and company_types accept a bare list of values or an {include, exclude} object; name, linkedin_urls and founded_years accept only their positive form. Omit any filter you have no values for — never send empty lists or empty ranges. 'is_total_accurate' is only reliable when page == 1. Contact counts are NOT part of a result: to learn who works at a match, pass its 'uuid' to search_people as organization_uuids. For one company's full firmographics, call enrich_organization: pass the result's 'linkedin_url' unchanged, or pass its 'website_domain' as 'organization_domain' (the parameter has a different name there).

search_people

ChatGPT
Find professionals in SalesQL's B2B database for sales, recruiting or marketing prospecting, by job title, industry, company, location, experience and contact-availability filters. Returns profile summaries; emails and phones are masked (e.g. '...@company.com') and only show which contact data exists. This tool does not use credits. Do NOT use to locate private individuals or for personal, non-business purposes. Call lookup FIRST to resolve valid values for countries, organization_countries, states_or_cities, organization_states_or_cities, industries, organization_industries, organization_employee_ranges, and organization_company_types — never guess these identifiers. Each filter accepts a bare list of values or an {include, exclude} object; omit any filter you have no values for — never send empty lists or empty ranges. Filters combine with AND. Every organization_* filter matches people holding ANY current position at a qualifying organization; people often hold several open positions at once, so the primary organization shown in a result may not be the one that matched the filter. 'is_total_accurate' is only reliable when page == 1. To get the contact details of a specific match the user wants, call enrich_person with its 'linkedin_url' (or full_name plus organization name/domain when it has no LinkedIn URL).

verify_email

ChatGPT
Verify whether ONE email address really exists and accepts mail. Use when the user wants to check an address before emailing it, exporting it or adding it to a campaign, typically after enrich_person returned it. Do NOT use to find or guess an address (call enrich_person) and do NOT call it once per address for a list (call verify_emails_bulk). Result 'status': 'valid' (mailbox exists and accepts mail), 'invalid' (the server rejected it), 'catch_all' (the domain accepts any address, so the mailbox cannot be confirmed; risky) or 'unknown' (mail servers missing or misbehaving; not verifiable right now). Costs 1 VERIFICATION credit, a balance separate from the enrichment credits; an address verified within the last 120 days is served from cache ('from_cache': true) and costs the same. The check can take up to 45 seconds. If the call fails without a clear answer (timeout, dropped connection, backend error), do NOT repeat it right away: the verification may have completed and been charged.

verify_emails_bulk

ChatGPT
Queue a bulk verification job for 1 to 500 email addresses. Use when the user wants to verify a list before exporting it or launching a campaign. Do NOT use for a single address (call verify_email). The result is NOT immediate: this tool returns a 'job_id' with status 'queued'. Call get_email_verification_job with that job_id to read progress and, once 'completed', the per-address results; wait the 'retry_after_seconds' it returns between polls. Only ONE bulk job can run at a time per account through the API or MCP: if one is already running, poll it until it finishes before queuing another. Duplicates are removed, so 'n_emails' may be lower than the number sent. Costs 1 VERIFICATION credit per unique address, charged when the job completes, from a balance separate from the enrichment credits; an address with an invalid format rejects the whole request and nothing is charged. If the call fails without a clear answer (timeout, dropped connection, backend error), do NOT queue the same list again right away: the job may have been created and a second one would charge again.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/salesql"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/salesql)