# Persistiq — how to use (mcp.ai)

Connect your Persistiq account and use 14 tools for CRM straight from your AI agent. Connect with your own API key. PersistIQ is a sales automation platform that streamlines outbound sales processes with personalized email campaigns and task management.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/persistiq/add/lead/to/campaign` — Tool to add a lead to a specified campaign. Use when you have lead details and a campaign ID to enroll the lead into the campaign.
  - body: { lead: object, campaign_id: string }
- `POST https://api.mcp.ai/api/persistiq/create/campaign` — Tool to create a new campaign in PersistIQ. Use when you need to set up a new outreach campaign with a specific owner.
  - body: { owner_id: string, campaign_name: string }
- `POST https://api.mcp.ai/api/persistiq/create/dnc/domain` — Tool to create a Do Not Contact domain. Use when you need to block emails from being sent to addresses at a specific domain without manual approval.
  - body: { name: string }
- `POST https://api.mcp.ai/api/persistiq/create/leads` — Tool to bulk create up to 10 leads. Use when you have multiple new contacts and need optional duplicate-handling.
  - body: { leads: object[], duplicate_lead_action?: string }
- `POST https://api.mcp.ai/api/persistiq/list/campaigns` — Tool to list campaigns. Use when you need to fetch multiple campaigns with optional filters and pagination after setting up your filter criteria.
  - body: { name?: string, page?: integer, limit?: integer, lead_id?: string, owner_id?: string }
- `POST https://api.mcp.ai/api/persistiq/list/dnc/domains` — Tool to list Do Not Contact domains. Use when you need to retrieve all domains marked as DNC.
- `POST https://api.mcp.ai/api/persistiq/list/events` — Tool to retrieve a list of PersistIQ events. Use when you need to fetch events filtered by group, campaign, lead, user, or time range.
  - body: { lead?: string, page?: integer, user?: string, group?: string, limit?: integer, end_at?: integer, campaign?: string, start_at?: integer }
- `POST https://api.mcp.ai/api/persistiq/list/lead/fields` — Tool to list all lead fields for your company. Use when you need to retrieve available custom lead fields.
- `POST https://api.mcp.ai/api/persistiq/list/lead/statuses` — Tool to retrieve all lead statuses for your company. Use when you need to list available lead statuses after confirming authentication with PersistIQ.
- `POST https://api.mcp.ai/api/persistiq/list/leads` — Tool to list leads from PersistIQ. Use when you need to fetch a paginated list of leads, optionally filtering by status or updated_after.
  - body: { page?: integer, limit?: integer, status?: string, updated_after?: string }
- `POST https://api.mcp.ai/api/persistiq/list/users` — Tool to list all non-archived users in your company. Use when you need to retrieve user information including id, name, email, activated status, default_mailbox_id, and salesforce_id.
- `POST https://api.mcp.ai/api/persistiq/remove/lead/from/campaign` — Tool to remove a lead from a specified campaign. Use when you need to detach a lead from an existing campaign after confirming both IDs.
  - body: { lead_id: string, campaign_id: string }
- `POST https://api.mcp.ai/api/persistiq/update/lead` — Tool to update a lead's information. Use when you need to modify fields (status, tags, or custom attributes) of an existing lead. Call after confirming the lead_id.
  - body: { email?: string, phone?: string, title?: string, lead_id: string, last_name?: string, first_name?: string, company_name?: string }
- `POST https://api.mcp.ai/api/persistiq/view/lead` — Tool to retrieve a lead by its ID. Use when you have the lead ID and need its detailed information.
  - body: { lead_id: string }

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

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