Docs

Leadgenerator.io MCP Server

Work with your Agentic Revenue Platform from Claude and other AI assistants.

Overview

The Leadgenerator.io MCP server connects your workspace to AI assistants that support the Model Context Protocol (MCP), such as Claude and ChatGPT. Once connected, you can ask the assistant about your review queue, companies, contacts, emails, replies, reports, and credits, and ask it to do most of what you do in the app: add and find companies and people, go through your review queue, send sequences, answer replies, write templates, change your agent settings, and set up mailboxes and sending domains.

The assistant works as you. It sees what you can see in Leadgenerator.io, and it can only make changes that your workspace administrator allows. Anything that approves, sends, or spends credits shows a card first, and nothing happens until you click.

Connect to Claude

You need a Leadgenerator.io account. Then, in Claude:

Open Settings, then Connectors.
Click Add custom connector.
Name it Leadgenerator.io and paste this server URL:https://app.leadgenerator.io/mcp
Click Add, then Connect.
Sign in to Leadgenerator.io and allow access.

Connect to ChatGPT

You need a Leadgenerator.io account and ChatGPT on the web. On a company ChatGPT plan, your ChatGPT admin may need to allow custom MCP servers. In ChatGPT:

Open Plugins in the left sidebar.
Click Add, then Add custom MCP server.
Name it Leadgenerator.io, paste this server URL, and leave the sign-in settings as they are:https://app.leadgenerator.io/mcp
Sign in to Leadgenerator.io and allow access.
In a new chat, select Leadgenerator.io and ask your first question.

Other assistants that support remote MCP servers connect the same way: add the server URL above and sign in to Leadgenerator.io when asked.

Example prompts

“What needs my attention in Leadgenerator.io today?”
“Walk me through my review queue.”
“Who needs a reply? Tell Priya that Tuesday at 10 works.”
“Find 10 fintech companies in London like Monzo and add the best ones to my Agent Queue.”
“Why didn't my agent run yesterday?”
“Show me the replies from the last week that sound interested.”
“How did my outreach do over the last 30 days compared to the month before?”
“Update my knowledge to also target fintech companies in the United Kingdom.”
“Is my new sending domain ready yet? If not, send the DNS records to it@ostervane.com.”

Tool reference

Each tool is marked with what it does to your workspace:

Read-only only reads data. Nothing changes.
Saves immediately saves as soon as the assistant runs it, so the assistant tells you what changed.
You confirm shows a card in the chat. Nothing changes or is charged until you click to confirm.

Workspace and contacts

searchRead-only: Search companies and contacts already in your workspace by name, domain, email, or job title.
fetchRead-only: Read one full company or contact record returned by search.
list_companiesRead-only: List companies, filtered by lifecycle state (for example the review queue), tier, owner, or a name or domain.
get_companyRead-only: One company in full: profile, fit and intent scores, brief, signals, timeline, notes, tasks, and what the agent is doing with it.
get_contactsRead-only: List people in your workspace, or read one contact in full, including the emails sent to them.
get_my_feedRead-only: What is waiting on you right now: reviews, stopped agent work, and your open tasks.
who_am_iRead-only: Who you are signed in as, your role and workspace, and what this connection may do.

Companies and people

add_companiesYou confirm: Add companies by website or name, a pasted list, or a CSV. A card shows which are already in your workspace and adds them now or to your Agent Queue.
find_companiesYou confirm: Describe the companies you want, and a card searches for up to 10 new ones. Tick the ones to add.
add_contactSaves immediately: Add one person to one of your companies by name or LinkedIn link. If more than one person fits, a card lets you pick.
find_peopleYou confirm: Find people at your companies by job title or leadership, 25 at a time, then tick the ones to add.
review_queueYou confirm: The companies and people waiting on you, on one card, with Approve, Park, or Reject for each.
set_contact_handlingYou confirm: Take contacts manual, or give a parked contact back to the agent.

Agent

get_agent_statusRead-only: What your agent is doing now, the queue, today's sending, and credits left.
get_agent_activityRead-only: What the agent did today, on one past day, or over the last 7 days, including why a run stopped.
get_agent_settingsRead-only: Your mode, run days, agent flow, email quality, and daily contact limits.
list_agent_queueRead-only: Companies waiting for the agent, or the history of what was added, suppressed, or failed.
move_in_queueSaves immediately: Move a waiting company to the top of your Agent Queue, or to a place in the line.
remove_from_queueSaves immediately: Take waiting companies out of your Agent Queue.
set_auto_addYou confirm: Turn on, change, or turn off daily company finding for your Agent Queue.
change_agent_settingsYou confirm: Change your run days, what goes out on each cycle, email quality, quality check, new contacts a day, and cooldown.
set_modeSaves immediately: Switch between Manual and Co-pilot. Turning on Autopilot always needs your own click on a confirmation card.

Emails and replies

list_emailsRead-only: Scheduled, sent, stopped, or failed cadence emails, for you or the whole workspace.
get_emailRead-only: One cadence email in full, with its status, opens, and the first reply.
list_repliesRead-only: Replies to emails sent from your mailboxes, with a verdict and a short snippet.
read_inboxRead-only: Your email conversations with contacts, which ones wait on you, and any one in full. Never your private mail.
handle_replyYou confirm: Decide a reply on a card: it's a lead, or not a lead. After a lead, choose whether to keep emailing their colleagues.
reply_to_conversationYou confirm: The assistant writes your reply, and a card shows it under their last messages. Edit it, then click Send.
send_sequenceYou confirm: Give a contact an email sequence: written for them, one of your templates, or a saved draft. See the emails and the quality check, then send.
change_emailsYou confirm: Stop, pause, or resume emails for people or whole companies. Emails already sent are never touched.
get_suppressionRead-only: Your never-contact list: blocked domains and email addresses.
change_suppressionYou confirm: Add domains or email addresses to your never-contact list, or take them off.

Pipeline

list_pipelineRead-only: Your leads and deals by stage, with deal values, forecasts, close dates, and the totals.
get_pipeline_recordRead-only: One lead or deal in full: what they said, next step, qualification, people, notes, and tasks.
move_pipelineYou confirm: Change a stage, make a lead a deal, mark it won or lost, set a deal's forecast, or delete it. Closing moves are final.
log_leadYou confirm: Make a contact a lead by hand, for a conversation that happened outside the app.
update_deal_checklistSaves immediately: Set a part of a deal's qualification checklist, such as the decision maker, with a note.

Rooms

get_roomsRead-only: Whether someone opened their room, when and for how long, and the rooms opened lately.
list_contentRead-only: Your talking films, videos, decks, product videos, and Room design.
make_roomSaves immediately: Make a draft room for a contact from your Room design. Only your team can open a draft.
turn_on_room_linkYou confirm: Turn on a draft room's link so it can be sent. It can't go back to a draft.
change_roomYou confirm: Add a deck or video from your library to a room, change its link text, or delete it.

Projects

list_projectsRead-only: Every project in your workspace, with its owner, mode, and ideal customer.
create_projectYou confirm: Start a new project of your own. It starts in Manual mode.
stop_projectYou confirm: Stop one of your projects: its emails stop and it switches to Manual. Everything in it stays.

Templates

list_templatesRead-only: Your saved email templates and who uses each one.
write_templateYou confirm: Open a template in the editor on a card, or write a new one, with merge tags for each person's details. Saves when you click Save.
delete_templateYou confirm: Delete a template you no longer use. A template someone is using can't be deleted.

Knowledge

list_knowledgeRead-only: Your knowledge entries and which one is active.
get_knowledgeRead-only: One knowledge entry in full: company, product, targeting, sales motion, and writing instructions.
create_knowledgeSaves immediately: Create a knowledge entry from what you say, or draft one from your website.
update_knowledgeSaves immediately: Change fields on a knowledge entry, or redraft it from a website.
select_knowledgeSaves immediately: Make one knowledge entry the active one the agent uses.
delete_knowledgeSaves immediately: Delete a knowledge entry. The assistant checks with you first.

Mailboxes and domains

list_mailboxesRead-only: Every sending mailbox, who owns it, its status, and its settings.
list_domainsRead-only: Every sending domain, its setup status, and the DNS records still needed.
add_mailboxYou confirm: Start adding mailboxes. A card asks whether to connect one you have or create new ones on a domain.
connect_mailboxYou confirm: Connect a Google Workspace or Microsoft 365 mailbox. You sign in to Google or Microsoft yourself.
add_domainYou confirm: Add a sending domain you own, with new mailboxes on it.
add_domain_mailboxesYou confirm: Add more mailboxes to an existing sending domain.
edit_signatureYou confirm: Edit the signature on your own mailboxes in a card, then save it there.
reassign_mailboxYou confirm: Give mailboxes to a teammate, for example when someone leaves.
set_warmupYou confirm: Turn warmup on or off for mailboxes on your domains.
update_mailboxSaves immediately: Change the sender name or open tracking on your own mailboxes.
update_domainSaves immediately: Change the sender name new mailboxes on a domain are created with.
check_domainSaves immediately: Check a domain's DNS records now, or retry a setup that stopped.
send_dns_recordsSaves immediately: Email a domain's DNS records to up to 5 people, such as your IT team.

Reports, credits, and help

get_reportRead-only: Outreach results: emails sent, open, reply, and bounce rates, and where people drop off.
get_warmup_reportRead-only: Warmup scores and inbox placement for mailboxes on your domains.
get_credit_usageRead-only: Where your workspace's credits went, and the pace of spending.
get_startedRead-only: Your setup progress and the next step to take.
get_help_articleRead-only: Search and read guides from the Leadgenerator.io Help Center.

Permissions and safety

The assistant only sees records in your own workspace. It finds new companies or people only when you ask, on a card you click.
Nothing is approved, sent, or deleted without your own click on a card.
Your workspace administrator decides whether the assistant can make changes. Without that permission, it can only read.
It edits the settings and signatures of your own mailboxes only. A teammate's mailbox is never edited.
Autopilot is never turned on without your own click on a confirmation card.
Anything that costs credits, such as finding companies, writing personalized emails, adding mailboxes, or turning on warmup, waits for you to confirm on a card.
It only does what you could do yourself in the app. For example, only a contact's owner can decide their reply or change their emails.
DNS provider tokens (GoDaddy or Cloudflare) are entered on a card and go straight to Leadgenerator.io. Never paste them into the chat.
Replies from prospects are shown to the assistant as information only, never as instructions to follow.

Credits

Some actions use your workspace's credits, the same as when you take them in the app:

Connecting a Google Workspace or Microsoft 365 mailbox: 200 credits per 30 days.
A new mailbox on a sending domain: 500 credits per 30 days, plus 1,000 with warmup.
Drafting knowledge from a website: the workspace's first build is free, and later ones use credits.
Finding new companies: about 10 credits for a search of up to 10 companies.
Finding a person's email after you add them.
Personalized email sequences, written for each person.
Companies the agent works after you add or approve them, or turn on auto-add.

Privacy

Workspace data is shared with your AI assistant only after you connect it, and only to answer your requests. Once the assistant receives it, the assistant's provider handles it under its own privacy policy. Read the full details in our Privacy Policy.

Troubleshooting

The assistant says it can't make changes: Your workspace administrator hasn't allowed changes through MCP. Ask them, or make the change in the app.
No confirmation card appears: Some assistants can't show cards. The assistant will give you a link, or you can do the same thing in the Leadgenerator.io app.
A personal Gmail or Outlook mailbox won't connect: Only Google Workspace and Microsoft 365 mailboxes can be connected.
The connection stopped working: Disconnect Leadgenerator.io in your assistant's connector settings, then connect it again and sign in.

Support

Email support@leadgenerator.io.