# Sendspark — how to use (mcp.ai)

Connect your Sendspark account and use 9 tools for video and audio straight from your AI agent. Connect with your own API key. Sendspark is a video messaging platform that empowers businesses to create, send, and track personalized video content, simplifying communication by allowing users to quickly record or upload videos and share them via email, social media, or other digital channels.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/sendspark/add/multiple/prospects/to/dynamic/campaign` — Tool to add multiple prospects to a dynamic campaign in bulk. Use when you need to add many prospects to your dynamic video campaign at once after confirming associated charges.
  - body: { dynamicsId: string, workspaceId: string, prospectList: object[], prospectDepurationConfig?: object, processAndAuthorizeCharge: boolean }
- `POST https://api.mcp.ai/api/sendspark/add/prospect/to/dynamic/video/campaign` — Tool to add a prospect to a dynamic video campaign. Use after confirming workspace and campaign IDs. Example: Add new prospect with name/contact details to dynamic "dyn12345" under a known workspace.
  - body: { prospect: object, dynamicId: string, workspaceId: string, prospectDepurationConfig?: object, processAndAuthorizeCharge: boolean }
- `POST https://api.mcp.ai/api/sendspark/api/health/status` — Tool to check the health status of the Sendspark API. Use before making other API calls to ensure the service is up.
- `POST https://api.mcp.ai/api/sendspark/create/dynamic/video/campaign2` — Tool to create a dynamic video campaign in a workspace. Use when you need to create a container for AI-personalized dynamic videos that can be sent to prospects.
  - body: { name: string, workspaceId: string }
- `POST https://api.mcp.ai/api/sendspark/delete/webhook` — Delete a webhook by its unique ID. Returns a structured response with status code and message. This action is idempotent: deleting a non-existent webhook (404) with workspaceId provided returns succes
  - body: { webhook_id: string, workspaceId?: string }
- `POST https://api.mcp.ai/api/sendspark/get/dynamic/campaign/by/id` — Tool to retrieve details of a specific dynamic video campaign. Use after confirming workspace and campaign IDs.
  - body: { dynamic_id: string, workspace_id: string }
- `POST https://api.mcp.ai/api/sendspark/get/workspace/prospect/data/by/email` — Tool to retrieve prospect data by email in a dynamic campaign. Use after adding a prospect to a campaign to fetch its details.
  - body: { email: string, dynamic_id: string, workspace_id: string }
- `POST https://api.mcp.ai/api/sendspark/list/dynamic/video/campaigns` — Tool to list all dynamic video campaigns in a workspace. Use when retrieving campaigns with optional pagination, filtering, or search.
  - body: { limit?: integer, offset?: integer, search?: string, filters?: string, workspaceId: string }
- `POST https://api.mcp.ai/api/sendspark/list/webhooks` — Retrieves all configured webhooks for a Sendspark workspace. Webhooks are automated notifications sent when specific events occur in dynamic video campaigns (e.g., video created, video played, CTA cli
  - body: { workspaceId: string }

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

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