# LeadBoxer — how to use (mcp.ai)

Connect your LeadBoxer account and use 9 tools for analytics straight from your AI agent. Connect with your own API key. Lead generation platform that gives you real-time info about companies and people that visit your website. Turning anonymous web traffic into actionable data.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/leadboxer/add/or/update/lead/tags` — Tool to add or update lead tags in LeadBoxer. Use when you need to manage lead tags by adding new tags, removing specific tags, or overwriting all existing tags for a specified user.
  - body: { action?: string, userId: string, leadTags: string, datasetId?: string }
- `POST https://api.mcp.ai/api/leadboxer/delete/ctd` — Tool to delete a custom tracking domain entry for a dataset. Use when you need to remove a specific custom tracking domain (CTD) associated with a dataset in LeadBoxer.
  - body: { ctd: string, email: string, datasetId: string }
- `POST https://api.mcp.ai/api/leadboxer/get/events` — Tool to fetch events for specified sessions from LeadBoxer. Use when you need to retrieve behavioral data including pageviews, clicks, form submissions, email interactions, and custom events. Events c
  - body: { email?: string, limit?: integer, userId?: string, segmentId?: string, sessionId?: string, smartlistId?: string }
- `POST https://api.mcp.ai/api/leadboxer/get/lead/score/formula` — Tool to fetch the lead score formula for a specific dataset. Use when you need to understand how lead scores are calculated for records in a dataset. The formula defines scoring based on criteria type
  - body: { email?: string, datasetId: string }
- `POST https://api.mcp.ai/api/leadboxer/get/sessions` — Tool to fetch sessions for a specified lead ID from LeadBoxer. Use when you need to retrieve session data for a user, with optional filtering by email, user ID, Smartlist ID, or segment ID. A session 
  - body: { email?: string, limit?: integer, leadId: string, userId?: string, segmentId?: string, smartlistId?: string }
- `POST https://api.mcp.ai/api/leadboxer/log/event` — Tool to track server-side events in LeadBoxer. Use when tracking backend events, page views, or custom activities from your server. This endpoint supports tracking user interactions, conversions, and 
  - body: { ip?: string, lc?: string, ti?: string, tz?: string, eid?: string, ref?: string, sid?: string, uid?: string, email?: string, proxy?: boolean, locale?: string, userId?: string, browser?: string, platform?: string }
- `POST https://api.mcp.ai/api/leadboxer/management/ctd` — Tool to fetch custom tracking domain entries for a dataset. Use when you need to retrieve all custom tracking domains that are created or in progress for a specific datasetId.
  - body: { email: string, datasetId: string }
- `POST https://api.mcp.ai/api/leadboxer/post/event` — Tool to send event data for tracking user activities via POST request. Use when tracking events by sending data in the request body with application/x-www-form-urlencoded format.
  - body: { si: string, ti?: string, sid?: string, uid?: string, name?: string, page?: string, email?: string, proxy?: boolean, company?: string, referrer?: string }
- `POST https://api.mcp.ai/api/leadboxer/views/lead/detail` — Tool to fetch detailed information about a lead based on filters. Use when you need comprehensive lead data for a specific lead ID. The default view type is B2B. Note: On initial pageview, there may b
  - body: { email?: string, leadId: string, noShortenEmail?: boolean }

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

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