# PredictLeads — MCP server on mcp.ai
> Connect your PredictLeads account and use 9 tools for AI sales tools straight from your AI agent. Connect with your own API key. PredictLeads provides company intelligence on hiring, technologies, financing, news, products, business connections, and other growth signals.

By: mcp.ai · official
Page: https://mcp.ai/predict_leads

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_predict_leads?ms=1787291220000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/predict_leads/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/predict_leads/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/predict_leads/skill.md
Postman collection (v2.1): https://mcp.ai/predict_leads/postman.json

## Tools
- predict_leads_discover_companies(page?: integer, limit?: integer, sizes?: string[], industry?: string, location?: string, naics_codes?: string[], revenue_range_low?: integer, revenue_range_high?: integer) — Find companies using firmographic filters. Discovery costs one credit per returned record, so the default limit is 5. Deterministic upstream 4xx responses also consume credits and are not retried.
- predict_leads_discover_intelligence(page?: integer, limit?: integer, title?: string, dataset: string, location?: string, date_from?: string, seniority?: string, date_until?: string, onet_codes?: string[], post_types?: string[], active_only?: boolean, company_sizes?: string[], news_categories?: string[], last_seen_at_from?: string, last_seen_at_until?: string, product_categories?: string[], product_subcategories?: string[], financing_types_normalized?: string[], technology_id_or_fuzzy_name?: string) — Discover one page of jobs, technology adoption, news, financing, investor portfolio connections, products, or startup-platform posts across companies. Select exactly one dataset. Each returned record 
- predict_leads_get_api_subscription() — Check PredictLeads subscription status, monthly credit quota, and credits used. This endpoint is free and should be called before or during credit-sensitive workflows.
- predict_leads_get_company(id_or_domain: string) — Retrieve one company by PredictLeads UUID or bare domain. Each upstream response costs 1 credit, including deterministic 4xx failures, so malformed identifiers are rejected locally and 4xx errors shou
- predict_leads_get_company_intelligence(page?: integer, limit?: integer, dataset: string, location?: string, date_from?: string, date_until?: string, not_closed?: boolean, active_only?: boolean, job_categories?: string[], news_categories?: string[], last_seen_at_from?: string, last_seen_at_until?: string, product_categories?: string[], with_location_only?: boolean, company_id_or_domain: string, connection_categories?: string[], product_subcategories?: string[], with_description_only?: boolean) — Retrieve one page of a company's jobs, technology detections, news, financing, SEC filings, connections, website changes, GitHub repositories, or products. Select exactly one dataset. Each call costs 
- predict_leads_get_intelligence_record(identifier: string, record_type: string) — Retrieve one job opening, extended technology detection, technology, news event, SEC filing, or product by identifier. Select exactly one record type. Each call costs 1 credit; malformed identifiers a
- predict_leads_get_similar_companies(page?: integer, limit?: integer, company_id_or_domain: string) — Find one page of companies similar to a specified PredictLeads company UUID or domain. Each returned record costs 1 credit, so the default limit is 5; deterministic 4xx responses are not retried.
- predict_leads_list_followed_companies(page?: integer, limit?: integer) — List one page of companies already followed for PredictLeads webhook updates. This is read-only and does not change follow state. The operation costs 1 credit per response; deterministic 4xx failures 
- predict_leads_search_technologies(page?: integer, limit?: integer, order_by?: string, fuzzy_name?: string) — Search PredictLeads' tracked technology catalog by fuzzy name. This unusually expensive endpoint costs 3 API credits per returned record, so the default limit of 3 can cost up to 9 credits. Check API 

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

## Links
Docs: https://mcp.ai/docs/mcps/predict_leads
Website: https://mcp.ai/mcps/predict_leads