About LeadSync
LeadSync is an MCP server for configuring and troubleshooting delivery of Facebook and Instagram lead ads. It connects MCP clients to LeadSync API operations for lead destinations, field mapping, autoresponders and test leads.
Key features
- 01Connect lead forms to destinations
- 02Map lead fields
- 03Add autoresponders
- 04Send test leads
- 05Inspect lead delivery
Use cases
- 01Configure lead form destinations
- 02Troubleshoot field mappings
- 03Test lead delivery
- 04Check a lead's delivery history
MCP support
The MCP server exposes LeadSync API operations to configure and troubleshoot lead delivery. It is run with `npx -y @leadsync/mcp` and requires a LeadSync API key.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @leadsync/mcpLEADSYNC_API_KEYSecretLeadSync API key (Account, Settings, API keys). Optional if you ran npx @leadsync/skills login, which saves it to ~/.leadsync/.env.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
14Saved tool list · updated 1d ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| account_id | any | No | Admin keys only: the LeadSync account (user id, integer or digit string) to act on; overrides LEADSYNC_ACCOUNT |
Details
From the project README@leadsync/mcp
The MCP server for the LeadSync API. It lets Claude and other MCP clients set up and troubleshoot LeadSync lead delivery: connect Meta lead forms to destinations, map fields, add autoresponders, send test leads and check what happened to a lead.
Most people install it with the installer, which also adds the LeadSync skills:
npx @leadsync/skills --claude # or --cursor, --codex
npx @leadsync/skills login
To run it by hand in any MCP client, use the command npx -y @leadsync/mcp. The full guide, the tools list and the safety rules are in the repository README.
Settings
The server reads each setting from the environment first, then from ~/.leadsync/.env (one KEY=value per line, written by npx @leadsync/skills login).
| Variable | What it does |
|---|---|
LEADSYNC_API_KEY | Required. Your API key, from Account, Settings, API keys in LeadSync. Never written to logs or tool output. |
LEADSYNC_API_BASE | Optional. Defaults to https://leadsync.me. |
LEADSYNC_ACCOUNT | Optional. LeadSync staff only. |
Licence: MIT.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.