Leadgenerator.io

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 update your knowledge, change your mode, 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.

Connect to Claude

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

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

Connect to ChatGPT

Connecting a custom MCP server in ChatGPT uses developer mode, which is available on the web for Plus, Pro, Business, Enterprise, and Education plans. In ChatGPT:

  1. Open Settings, then Apps.
  2. Under Advanced settings, turn on Developer mode.
  3. Click Create app.
  4. Name it Leadgenerator.io, paste this server URL, and choose OAuth for authentication:https://app.leadgenerator.io/mcp
  5. Sign in to Leadgenerator.io and allow access.
  6. 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?”
  • “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.

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.
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.

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, and never searches the web for new companies or people.
  • 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 adding mailboxes or turning on warmup, waits for you to confirm on a card.
  • 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.
  • Companies the agent works after you add 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.