# LeadIQ

> B2B sales-intelligence and contact-data platform. LeadIQ exposes three programmable surfaces over one data core: a public GraphQL Data API at https://api.leadiq.com/graphql (people search, company search, advanced grouped/flat search, prospect lists, account usage, data feedback, champion tracking), a REST Prospector API at https://prospector.leadiq.com for saved lists and prospects, and a remote MCP connector at https://mcp.leadiq.com/mcp exposing seventeen tools to AI agents over OAuth 2.0. Metering is credit-based (Universal Credits): 0.1 UC per profile, 1 UC per verified work email, 10 UC per direct phone, 3 UC per company. Generated by API Evangelist from LeadIQ's published surfaces; LeadIQ serves no llms.txt of its own (probed 2026-08-13, HTTP 404 on leadiq.com and developer.leadiq.com).

## APIs

- [GraphQL Data API](https://api.leadiq.com/graphql): Single GraphQL endpoint. HTTP Basic auth with the Secret Base64 key sent verbatim. Anonymous introspection is enabled — 216 types, 18 Query fields, 11 Mutation fields.
- [Prospector REST API](https://prospector.leadiq.com): OpenAPI 3.1.0, 14 operations under /v1 for lists, prospects, email verification, Salesforce export and caller identity. Auth via X-API-Key (the DECODED key) or a bearer JWT.
- [MCP connector](https://mcp.leadiq.com/mcp): Streamable HTTP, OAuth 2.0 with dynamic client registration, scopes `leadiq:api` and `offline_access`. Seventeen tools plus a guided `icp` prompt.

## Specs

- [Prospector OpenAPI 3.1.0](https://prospector.leadiq.com/openapi.json): the provider-served spec, harvested verbatim to openapi/_original/leadiq-prospector-api-openapi.json.
- [GraphQL SDL](graphql/leadiq.graphql): rendered from live introspection at api.leadiq.com/graphql.
- [GraphQL introspection JSON](graphql/leadiq-introspection.json)
- [OAuth protected-resource metadata (RFC 9728)](https://mcp.leadiq.com/.well-known/oauth-protected-resource)
- [OAuth authorization-server metadata (RFC 8414)](https://leadiq-mcp-prod.us.auth0.com/.well-known/oauth-authorization-server)

## Docs

- [Developer portal / API reference](https://developer.leadiq.com/): operations, types, pagination guidance, and the MCP connector section with the full tool table.
- [LeadIQ Public API Guide](https://leadiqhelp.zendesk.com/hc/en-us/articles/29375289152795-LeadIQ-Public-API-Guide): authentication, credits, error-status table, Prospector REST basics.
- [LeadIQ Public API Overview](https://leadiqhelp.zendesk.com/hc/en-us/articles/35509840045083-LeadIQ-Public-API-Overview): access model, rate limits, use cases.
- [Using the LeadIQ MCP Connector](https://leadiqhelp.zendesk.com/hc/en-us/articles/46186818771611-Using-the-LeadIQ-MCP-Connector-AI-Powered-Prospecting-Enrichment): setup for Claude, ChatGPT and Microsoft Copilot.
- [Understanding Universal Credits](https://leadiqhelp.zendesk.com/hc/en-us/articles/32700544948507-Understanding-Universal-Credits)
- [Code samples (Bash, Python, TypeScript)](https://github.com/leadiq/api-samples)
- [Pricing](https://leadiq.com/pricing)
- [Status](https://status.leadiq.com)

## MCP tools

- EnrichPeople — known people by LinkedIn URL, work email, or name + company; batch up to 10. Wraps `searchPeople`.
- EnrichCompanies — known companies by domain, name, or LinkedIn; batch up to 10. Wraps `searchCompany`.
- FindPeople — ICP prospecting, paginated. Wraps `flatAdvancedSearch`.
- FindCompanies — ICP account discovery with contact counts. Wraps `groupedAdvancedSearch`.
- FindJobChanges — recent job changes and promotions with previous/current position.
- BrowseProspectLists / CreateProspectList / GetProspectList — list management. Free.
- AddProspectToList / AttachProspectToList / CreateProspect / GetProspect / SearchProspects — prospect management. Free.
- VerifyEmail / VerifyProspectEmail — deliverability checks. 0.1 UC each.
- ExportProspectToSalesforce — export a saved prospect as a Lead or Contact with duplicate detection.
- CheckCredits — balance, live unlock costs, signed-in account. Free.

## Operational notes for agents

- GraphQL errors arrive in the `errors` array with HTTP **200**. Never treat 200 as success on api.leadiq.com/graphql.
- No rate-limit response headers exist on any surface. The published limit is 60 requests/minute (Standard); exhaustion returns 429 with no Retry-After.
- Field selection is the billing contract on GraphQL — over-selecting `phones` costs 10 UC per person.
- Four of five write paths are documented as NOT idempotent, including the Salesforce export, which writes irreversibly into the caller's CRM and has no delete path. There is no Idempotency-Key mechanism.
- Advanced search: `skip + limit` may not exceed 10,000; use the opaque `after` cursor for anything larger.
- Sustained API access is sales-gated — all plans get 50 one-off test calls; beyond that requires an enterprise agreement.

## Artifacts

- [apis.yml](apis.yml)
- [Authentication](authentication/leadiq-authentication.yml)
- [OAuth scopes](scopes/leadiq-scopes.yml)
- [MCP server](mcp/leadiq-mcp.yml)
- [Tool crosswalk](mcp/leadiq-tool-crosswalk.yml)
- [Conventions](conventions/leadiq-conventions.yml)
- [Error catalogue](errors/leadiq-problem-types.yml)
- [Rate limits](rate-limits/leadiq-rate-limits.yml)
- [Plans and pricing](plans/leadiq-plans-pricing.yml)
- [Lifecycle](lifecycle/leadiq-lifecycle.yml)
- [Conformance](conformance/leadiq-conformance.yml)
- [Data model](data-model/leadiq-data-model.yml)
- [Packages](packages/leadiq-packages.yml)
- [Well-known](well-known/leadiq-well-known.yml)
- [Domain security](security/leadiq-domain-security.yml)
- [Agent skills](skills/_index.yml)