# LeadIQ — how to use (mcp.ai)

Connect your LeadIQ account and use 9 tools for sales and CRM straight from your AI agent. Connect with your own API key. The Smart B2B Prospecting Platform. Query professional information about people and companies, find leads, and enrich contact data.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_leadiq?ms=1787293440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `leadiq_abandon_batch`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/leadiq`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/leadiq/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/leadiq/abandon/batch` — Abandon a contact tracking import batch that is no longer needed. Use when you need to cancel or stop an ongoing import batch operation.
  - body: { reason?: string, importId: string }
- `POST https://api.mcp.ai/api/leadiq/get/account` — Retrieve current user's account information including plans, billing cycles, and credit usage. Use to check available API credits, billing status, and data visibility settings before making data queri
- `POST https://api.mcp.ai/api/leadiq/get/contact/tracking/balance` — Tool to check the remaining balance of contact tracking credits available for the account. Use when you need to verify how many contact tracking credits are left.
- `POST https://api.mcp.ai/api/leadiq/get/usage` — Tool to retrieve API usage statistics and credit consumption for the current LeadIQ account. Use when you need to check credit usage, remaining capacity, or billing information.
- `POST https://api.mcp.ai/api/leadiq/search/company` — Tool to search for companies by name, domain, LinkedIn URL, or other identifying information. Use when you need to find companies matching specific criteria. Returns detailed company information inclu
  - body: { input: object }
- `POST https://api.mcp.ai/api/leadiq/search/grouped/advanced` — Tool to search for people by job title, seniority, role, company size, and location with results grouped by company. Returns companies with matching people nested under each company for account-based 
  - body: { input: object }
- `POST https://api.mcp.ai/api/leadiq/search/people` — Search for individual contacts by name, company (past and present), LinkedIn profile, email, or phone number. Use when you need to find people based on identifying information. Returns comprehensive c
  - body: { id?: string, skip?: integer, email?: string, limit?: integer, phone?: string, company?: object, fullName?: string, lastName?: string, firstName?: string, linkedinId?: string, middleName?: string, hashedEmail?: string, linkedinUrl?: string, minConfidence?: integer, profileFilter?: string[], qualityFilter?: string, includeInvalid?: boolean, workEmailStatusIn?: string[], containsWorkContactInfo?: boolean }
- `POST https://api.mcp.ai/api/leadiq/search/people/flat` — Tool to search for people using advanced filters by job title, seniority, role, company size, location, and more. Returns a flat list of individual contacts unorganized by company.
  - body: { input: object }
- `POST https://api.mcp.ai/api/leadiq/submit/person/feedback` — Tool to submit data correction feedback for person contact information to improve LeadIQ data accuracy. Use when you need to report contact info status, invalid reasons, or update profile details.
  - body: { name?: string, type?: string, title?: string, value: string, status?: string, lastSeen?: string, personId?: string, companyId?: string, linkedinId?: string, companyName?: string, linkedinUrl?: string, companyDomain?: string, invalidReason?: string }

## Example prompts
- "What can I do in LeadIQ?"
- "Show me a summary of my LeadIQ account"

## More
- Page: https://mcp.ai/leadiq
- Agent spec (llms.txt): https://mcp.ai/leadiq/llms.txt
- Postman collection: https://mcp.ai/leadiq/postman.json