# Build on Embers

URL: https://useembers.com/help/developers/

> Receive signed lead events at your endpoint, let an AI assistant work your queue over MCP, and read Embers from machine-readable files. Solo and above.

## MCP server

Address: https://mcp.useembers.com/mcp

Paste it into any assistant that speaks MCP and approve Embers once in your browser. There is no API key.

## Webhook delivery

Each event is a `POST` with `application/json` and the Standard Webhooks headers `webhook-id`, `webhook-timestamp`, and `webhook-signature`: rebuild the HMAC-SHA256 from the raw body to check each request.

## Webhook events

Every event is a JSON `POST` with the same envelope around an event-specific `data` object. The payload reference lists every field: https://useembers.com/help/integrations/webhook-payload-reference/

| Type | Payload data |
| --- | --- |
| `lead.created` | `lead` and `engagement` (recent form) |
| `lead.engagement.added` | `lead` and `engagement` (batched form) |
| `lead.status_changed` | `lead`, `engagement`, `previous_status`, `status`, `changed_at` |
| `lead.changed` | `lead`, `engagement` (recent form), and `change` |
| `report.generated` | `report`, `reason`, `generated_at` |
| `webhook.test` | `is_test`, `sample_event_type`, and the sample shape of that event |

- [Send lead events to your own endpoint](https://useembers.com/help/integrations/webhooks/) (Solo and above): Create a signed HTTPS webhook endpoint in Embers, choose its events, save the signing secret, send a sample, and read the 30-day delivery log. Markdown: https://useembers.com/help/integrations/webhooks.md
- [Webhook payload reference](https://useembers.com/help/integrations/webhook-payload-reference/) (Solo and above): Every field in an Embers webhook, from the envelope and versions to the lead, engagement, change, contact, report, and test objects, and the key to join on. Markdown: https://useembers.com/help/integrations/webhook-payload-reference.md
- [Verify webhook signatures](https://useembers.com/help/integrations/verify-webhook-signatures/) (Solo and above): Check the Standard Webhooks headers on every Embers delivery: rebuild the HMAC from the raw body, compare it safely, bound the timestamp, and drop repeats. Markdown: https://useembers.com/help/integrations/verify-webhook-signatures.md
- [Webhook retries and pauses](https://useembers.com/help/integrations/webhook-retries-and-pauses/) (Solo and above): How Embers retries a failed webhook delivery across eight attempts and about 6.3 days, what pauses an endpoint, and how to resume it and replay events. Markdown: https://useembers.com/help/integrations/webhook-retries-and-pauses.md

## MCP tools

19 tools in three groups. Reads change nothing, writes touch one lead, and the rest ask you before they start a scan, spend credits, or reach past one lead. Setup and limits: https://useembers.com/help/integrations/mcp/

### Read

Look up the workspace, the queue, a lead, your posts, your sources, your watched profiles' stats, or the ICP, or preview an ICP edit. Nothing changes.

- `list_accounts`: List your workspaces, so it knows which one you mean.
- `today_queue`: The ranked list of leads that need action, with the reason each one surfaced.
- `workspace_summary`: Lead counts, your outreach pipeline, and your newest notifications in one call. An agency workspace also gets a row per client.
- `search_leads`: The same filters as the leads page.
- `get_lead`: Profile, score breakdown, recent engagement, notes, and status.
- `post_performance`: Your posts, watched profiles' posts, keyword posts, and qualified posts, ranked by the leads they brought.
- `list_sources`: Each watched profile, tracked keyword, and qualified post, with the leads it found and what your plan still allows.
- `profile_stats`: Followers, posts per week, engagement rate, engagers read, and ICP engagers for each watched profile, your own included, over up to 365 days.
- `get_icp`: The criteria every lead is scored against.
- `preview_icp_update`: Which current leads an ICP edit would drop or add. Saves nothing.

### Write

Save a draft, a status, or your verdict on one lead.

- `write_opener`: Saved as that lead's draft, for you to send yourself.
- `update_lead_status`: Contacted, replied, follow-up date, outcome, or snooze. The same update twice saves the note once.
- `icp_feedback`: Your verdict on whether one lead fits, or withdraw one recorded by mistake.

### Asks first

These start scans, spend credits, or reach past the lead in front of you. The assistant tells you what would happen and what it would use, and waits for you to agree.

- `update_icp`: Shows what would be added and removed, and how many leads will be re-scored. Applies a preview as shown.
- `undo_icp_change`: Puts back the ICP from before its last save, and the verdicts that save changed. Only the last save.
- `update_sources`: Watch profiles, track keywords, or pull one post's engagers, up to 10 of each. New sources are scanned at once and then on schedule. Removing a profile stops its scans and keeps its leads.
- `reveal_contact`: A lead's work email and phone. Free if found in the last 30 days, otherwise one paid lookup. Not on the free trial.
- `push_leads`: Same limits as Send to. Only a destination an administrator already connected.
- `block_company`: Hides everyone at that company. You can undo it from the company blocklist.

The setup steps for each assistant Embers supports: https://useembers.com/agents/

## Machine-readable files

- [llms.txt](https://useembers.com/llms.txt): A short index of the site for AI assistants, with a link to each section.
- [llms-full.txt](https://useembers.com/llms-full.txt): The marketing site, help center, and blog as one Markdown file.
- [changelog/feed.json](https://useembers.com/changelog/feed.json): The newest product update as JSON, for a What's new badge.
- [pricing.txt](https://useembers.com/pricing.txt): Plans, prices, and limits in plain text.
- [ai-seo.json](https://useembers.com/ai-seo.json): Structured product facts: plans, help articles, tools, and comparisons.
- [<article>.md](https://useembers.com/help/getting-started/quickstart.md): Any help article as Markdown: replace the trailing slash with .md.
