--- title: "Grok MCP: connect Leadsets B2B data to Grok Bot" description: "Connect Grok Bot to the Leadsets remote MCP server for people and company search, enrichment, verified work emails and website scraping. Setup and limits." canonical: https://www.leadsets.ai/integrations/grok updated: 2026-11-09 --- # Use Leadsets with Grok Bot over MCP Leadsets connects to Grok Bot as a remote MCP server at https://mcp.leadsets.ai, plus free SKILL.md playbooks that teach the agent GTM workflows. Once added, Grok Bot can search people and companies, enrich contacts, verify work emails and scrape company sites through eight Leadsets tools. Leadsets does not publish Grok-specific setup screens, so follow the generic MCP setup in its docs. Grok Bot is a personal AI agent, and Leadsets lists it among the personal agents it supports through its MCP server and skills. This page covers what that gives the agent, how to connect it using the setup Leadsets documents, and where the limits are. ## What Grok Bot can do with Leadsets Leadsets is a B2B data API and remote MCP server built for AI agents. Once connected, Grok Bot can call eight tools: - `search_people`: find people by title, function, seniority, location, company size and industry, with a reason for every match. - `search_companies`: find accounts by industry, headcount band, technology and location. - `enrich_person`: current role, company and a verified work email when one exists. - `enrich_company`: firmographics for a domain, with source and freshness on every field. - `verify_email`: label an address verified, catch-all, unknown or invalid, with a confidence score. - `scrape_company`: turn a company homepage into products, positioning, customers named and key links. - `scrape_jobs`: open roles from careers pages, with titles and dates, as hiring signals. - `get_usage`: what is left in the current window and week, at no cost. You describe your customer in plain language, for example "RevOps leads at 50 to 200 person fintechs", and the agent turns it into filters and picks the tools. Results come back as structured JSON with match reasons, verification status, confidence and the date each field was last checked. ## How to connect Leadsets to Grok Bot Leadsets does not publish setup steps specific to Grok Bot, so the steps below follow the generic MCP and REST setup in the Leadsets docs. Check Grok Bot's own documentation for where it accepts a remote MCP server; Leadsets does not describe those screens. The same approach applies to [any MCP client](https://www.leadsets.ai/integrations/mcp-clients). 1. **Get a key.** Create a free Leadsets account and copy your key from the dashboard. Keys start with `ls_live_` and should be kept server-side. The free plan gives 1,000 records, one time, with no card. 2. **Add the MCP server URL.** Leadsets is a remote MCP server at `https://mcp.leadsets.ai`. There is nothing to install or run locally. 3. **Authenticate.** The docs describe two methods used by different clients: OAuth sign-in (as in Claude's custom connector, with no key to paste) or an `Authorization: Bearer ls_live_…` header (as in Cursor). Use whichever method your client supports. 4. **Check the connection.** Ask the agent "What's my Leadsets usage?" If it calls `get_usage` and answers with your remaining balance, you are connected. 5. **Add skills.** Leadsets publishes 50 free, MIT-licensed SKILL.md playbooks for agents that read the SKILL.md standard. Clone the library with `git clone github.com/leadsets/leadsets-skills` or download a single skill folder, then load it the way your agent loads skills. The full generic walkthrough is in [Connect via MCP](https://www.leadsets.ai/docs/mcp), and the playbooks are in the [skills library](https://www.leadsets.ai/skills). If your workflow prefers plain HTTP to MCP, every tool is also a REST endpoint at `https://api.leadsets.ai/v1` with a bearer key: ``` curl https://api.leadsets.ai/v1/people/search \ -H "Authorization: Bearer $LEADSETS_KEY" \ -d '{ "title": ["VP Sales"], "country": ["US"], "employees": "50-200", "has_verified_email": true, "limit": 25 }' ``` The API has TypeScript and Python SDKs, cursor pagination, idempotency keys and Retry-After headers. Finished lists can be exported as CSV for any sequencer, or pushed into tools such as Google Sheets or LinkedCamp through skills. ## Example: a prospect list from one prompt Maya Chen runs revenue operations at Northwind Analytics (northwind.co). With Leadsets connected and the build an outbound prospect list skill loaded, she asks Grok Bot: "Build a list of 100 heads of RevOps at US B2B SaaS companies with 50 to 200 people. Put it in a CSV." Following the skill, the agent: 1. Confirms the ICP and asks one question if anything is ambiguous. 2. Calls `get_usage` to check remaining limits and plan the run. 3. Probes with a 1-record `search_companies` call to sanity-check the filters. 4. Calls `search_people` to find matching people, each with match reasons. 5. Runs `enrich_person` and `verify_email` on each person. 6. Returns the table with catch-all addresses in a separate segment and a note of what it could not confirm. If Maya then asks "Which of these accounts are hiring SDRs right now?", the agent can call `scrape_jobs` on their careers pages. That step needs scrape units, which are an add-on on paid plans. ## What to watch for - **Free records.** The free plan is 1,000 records once, shared across search and enrichment, and they do not refill. When they run out, the API returns 402 `free_records_exhausted`, and the agent should ask you to upgrade rather than retry. `scrape_company` and `scrape_jobs` are not on Free. - **Records and requests.** Records count only when data comes back, so an empty search uses none. Every call counts as a request, and the request limit is five times the record allowance. - **Windows.** Paid plans have rolling five-hour and weekly limits. Solo ($29 a month) allows 1,000 enrichments and 500 search records per five hours; Pro ($99 a month) allows 15,000 and 7,500; Team ($399) and Max ($999) go higher. Concurrent searches are 3 on Solo, 5 on Pro and 8 on Team and Max. Over a limit, Leadsets returns 429 with a Retry-After time and the blocked call counts against nothing. See [limits and costs](https://www.leadsets.ai/docs/limits). - **Verification labels.** Emails from `enrich_person` are already verified, with no second bill; standalone `verify_email` counts toward enrichment. Verified means send, catch-all means send at lower volume, unknown means unconfirmed, and invalid addresses are never served as contact emails. Read more on [catch-all emails](https://www.leadsets.ai/answers/what-is-a-catch-all-email). - **Scraping units.** One unit is one standard page. Packs cost $9 for 1,000, $19 for 5,000 and $49 for 20,000 units on any paid plan. ## What it does not do - **No phone numbers.** Leadsets returns work emails, US personal emails on paid plans, roles and company data. Phone numbers are not offered yet. - **Not a CRM or sending tool.** Leadsets feeds your CRM and sequencer through skills, the API and CSV; it does not send email. - **Business data only.** No consumer data, no sensitive categories and no personal home addresses. - **No logged-in scraping.** Scraping reads public company pages only, respects robots signals and never goes behind a login. - **SOC 2 is planned, not done.** SOC 2 Type I readiness is underway with a target of Q3 2027. Leadsets runs a GDPR-aligned program and publishes a DPA. - **Outreach compliance stays with you.** You are responsible for following laws such as CAN-SPAM, GDPR and CASL and honouring unsubscribes. ## Questions and answers ### Does Leadsets work with Grok Bot? Yes. The Leadsets integrations page lists Grok Bot as a personal agent supported through the Leadsets MCP server and skills. Leadsets does not publish Grok-specific setup screens, so use the generic MCP setup in its docs. ### What is the Leadsets MCP server URL? The Leadsets remote MCP server is at https://mcp.leadsets.ai, and the REST API base URL is https://api.leadsets.ai/v1. Nothing is installed or run locally. ### Do I need an API key to use Leadsets with an MCP client? It depends on how the client authenticates. The Leadsets docs describe OAuth sign-in for Claude, with no key to paste, and a bearer API key header starting with ls_live_ for Cursor. Use whichever method your client supports. ### How do I check that Leadsets is connected to my agent? Ask the agent "What's my Leadsets usage?" If it calls get_usage and answers with your remaining balance, the connection works. get_usage costs nothing. ### Is there a free way to try Leadsets with Grok Bot? Yes. The free plan gives 1,000 records, one time, with no card, shared across search and enrichment. Scraping tools are not on Free; paid plans start at $29 a month. ### Can Grok Bot get phone numbers through Leadsets? No. Leadsets does not offer phone numbers yet. It returns work emails, US personal emails on paid plans, roles and company data. --- Leadsets · https://www.leadsets.ai · Site index: https://www.leadsets.ai/llms.txt