# Helloleads — how to use (mcp.ai)

Connect your Helloleads account and use 3 tools for CRM straight from your AI agent. Connect with your own API key. HelloLeads is a smart and simple lead management solution designed for small businesses to streamline lead capture, tracking, and engagement.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_helloleads?ms=1787295780000`
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. `helloleads_create_lead`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/helloleads`
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/helloleads/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/helloleads/create/lead` — Tool to add a new lead into HelloLeads. Use when you need to push a fresh lead record with mandatory first name and list key.
  - body: { fax?: string, city?: string, tags?: string, email?: string, notes?: string, phone?: string, state?: string, mobile?: string, company?: string, country?: string, website?: string, category?: string, list_key: string, deal_size?: string, interests?: string, last_name?: string, potential?: string, first_name: string, designation?: string, mobile_code?: string, postal_code?: string, address_line1?: string, address_line2?: string }
- `POST https://api.mcp.ai/api/helloleads/list/leads` — Tool to list all leads from HelloLeads. Use after authentication to fetch the entire lead list. Returns empty list if none found.
- `POST https://api.mcp.ai/api/helloleads/list/lists` — Tool to retrieve all lead list keys from HelloLeads. Use when you need to enumerate available lists for lead insertion.

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

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