# Emelia — how to use (mcp.ai)

Connect your Emelia account and use 22 tools for drip emails straight from your AI agent. Connect with your own API key. Emelia is an all-in-one B2B prospecting tool offering features like cold-emailing, LinkedIn outreach, email warm-up, email finder, and LinkedIn Sales Navigator scraping.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/emelia/add/contact/to/blacklist` — Tool to add a contact to the email blacklist. Use after confirming that no further emails should be sent to a specific address. Example: 'Add blocked_user@example.com to blacklist.'
  - body: { email: string }
- `POST https://api.mcp.ai/api/emelia/add/contact/to/campaign` — Tool to add a contact to an email campaign. Use when you have collected subscriber details and want to enroll them in a campaign.
  - body: { id: string, contact: object }
- `POST https://api.mcp.ai/api/emelia/create/campaign` — Tool to create a new email campaign. Use after you have finalized the campaign name.
  - body: { name: string }
- `POST https://api.mcp.ai/api/emelia/create/linkedin/campaign` — Tool to create a new LinkedIn campaign. Use when you need to launch a LinkedIn outreach sequence.
  - body: { name: string }
- `POST https://api.mcp.ai/api/emelia/create/webhook` — Tool to create a new webhook for campaign events. Use when you need to subscribe to activity updates after determining the campaign ID and desired events.
  - body: { type: string, events: string[], hookUrl: string, campaignId: string }
- `POST https://api.mcp.ai/api/emelia/delete/contact/from/campaign` — Tool to remove a contact from an email campaign. Use when you need to revoke a contact's subscription from a specific campaign. Note: this operation is irreversible.
  - body: { contact_id: string, campaign_id: string }
- `POST https://api.mcp.ai/api/emelia/delete/contact/from/linkedin/campaign` — Tool to delete a contact from a LinkedIn campaign. Use when you need to remove a contact by campaign ID and contact URL. Call after confirming the contact exists in the campaign.
  - body: { id: string, url: string }
- `POST https://api.mcp.ai/api/emelia/delete/webhook` — Tool to delete a specific webhook. Use when you need to remove an existing webhook by URL after identifying the campaign.
  - body: { type?: string, hookUrl: string, campaignId: string }
- `POST https://api.mcp.ai/api/emelia/find/email/single/contact` — Tool to initiate a job to find the email address of a specific contact. Use when you have the contact's full name and company details and want to retrieve their email address.
  - body: { country: string, fullname: string, companyName: string, companyWebsite?: string }
- `POST https://api.mcp.ai/api/emelia/get/campaign/activities` — Tool to retrieve activities for a specific email campaign. Use after obtaining the campaign ID.
  - body: { page?: integer, type?: string, query?: string, contactId?: string, versionId?: string, campaignId: string }
- `POST https://api.mcp.ai/api/emelia/get/find/email/result` — Tool to retrieve the result of a previously initiated email find job. Use after initiating a find-email job to check its status and outcome.
  - body: { jobId: string }
- `POST https://api.mcp.ai/api/emelia/get/find/phone/result` — Tool to retrieve the outcome of a previously initiated phone-find job. Use after starting a job to fetch its status and details by job ID.
  - body: { job_id: string }
- `POST https://api.mcp.ai/api/emelia/get/linkedin/campaign/activities` — Tool to retrieve activities for a campaign. Use when you need to inspect engagement events for a specific campaign.
  - body: { page?: integer, per_page?: integer, campaign_id: string }
- `POST https://api.mcp.ai/api/emelia/get/verify/email/result` — Tool to get the result of an email verification job. Use after initiating an email verification job to check its status and outcome.
  - body: { jobId: string }
- `POST https://api.mcp.ai/api/emelia/initiate/email/verification/job` — Tool to initiate an asynchronous email verification job."
  - body: { email: string }
- `POST https://api.mcp.ai/api/emelia/initiate/phone/find/job` — Tool to initiate a phone-find job for a single contact. Use when you want to retrieve a contact's phone number based on their email address.
  - body: { linkedinUrl: string }
- `POST https://api.mcp.ai/api/emelia/list/campaign/contacts` — Tool to list contacts in a specific email campaign. Use when you need to retrieve campaign subscribers with optional pagination.
  - body: { page?: integer, campaignId: string }
- `POST https://api.mcp.ai/api/emelia/list/campaigns` — Tool to retrieve all email campaigns. Use when you need to fetch the list of campaigns, with optional pagination or search filters.
  - body: { page?: integer, limit?: integer, search?: string }
- `POST https://api.mcp.ai/api/emelia/list/email/providers` — Tool to retrieve all configured email providers. Use after setting up your email providers to view them.
- `POST https://api.mcp.ai/api/emelia/list/linkedin/campaigns` — Tool to list all LinkedIn campaigns. Use when you need an overview of your LinkedIn campaigns and want to paginate results.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/emelia/list/webhooks` — Tool to retrieve all webhooks. Use when you need to fetch every configured webhook in Emelia.
- `POST https://api.mcp.ai/api/emelia/remove/contact/from/blacklist` — Tool to remove a contact or domain from the email blacklist. Use after verifying that the address or domain should no longer be blocked.
  - body: { email_or_domain: string }

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

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