Connect ChatGPT to Yirlo

What the ChatGPT connection does

The Yirlo MCP server lives at https://yirlo.com/mcp and speaks Streamable HTTP with MCP protocol 2025-06-18. When ChatGPT connects to it, your chat gains 33 tools. Each tool makes one call to the public Yirlo API, so ChatGPT sees the same data you see in the app: balance, projects, campaigns, hot leads and the inbox.

This suits founders, agency owners and sales leads who already work in ChatGPT and would rather type "pause the dentist campaign" than click through screens. Yirlo keeps finding companies, checking emails and sending in the background. ChatGPT becomes a second control panel on top of that.

Start your very first project at yirlo.com with your website address, because the initial payment happens on that site. Any project after that can be created inside ChatGPT using create_project, and setup takes about a minute. The campaigns of a project made that way sit paused, ready for you to start one.

Set up ChatGPT with the Yirlo MCP server

We tested this flow live on 2026-11-13 using a ChatGPT Free account. The steps below match what we saw on screen.

Sign in to yirlo.com in the same browser first. That keeps the approval screen to a single click.

• In ChatGPT, open Plugins and click Add, then choose Add custom MCP server.
• Set Name to Yirlo.
• Set Server URL to https://yirlo.com/mcp.
• Set Authentication to OAuth. ChatGPT registers itself, so you paste nothing.
• Tick I understand and want to continue, then click Create as a plugin.
• Click Connect Yirlo. ChatGPT opens a Yirlo screen titled Connect ChatGPT to your Yirlo account?
• Sign in to yirlo.com if asked, then click Allow. You return to ChatGPT, and the plugin shows as connected.

Your first test request

Start with a read-only question. In any chat, type: Use the Yirlo plugin: what is my credit balance, list my projects.

In our test, ChatGPT read the balance, the account details and every project, along with the number of campaigns in each. If you see those figures, the connection works and every other tool is ready.

Naming the plugin in the prompt helps ChatGPT pick the right tool on the first try. After a few chats you can usually leave it out and just ask about your leads or campaigns.

What you can ask ChatGPT to do

Plain business questions work best. ChatGPT picks the matching tool and returns the result in the chat. Here are requests that map directly to the tools:

• "How many hot leads this week?" ChatGPT lists hot leads, then summarizes who is interested and in which campaign.
• Say "Pause the dentist outreach" and ChatGPT matches it to the right campaign and stops it.
• "Raise the daily budget to $30." It sets the campaign or project budget. Sending is billed at about $0.05 per email from your prepaid credit, so the daily budget is the number to watch.
• "Reply to the last interested lead offering Tuesday." It reads the conversation, writes the reply and sends it as a real email.
• "Add my competitor's domain to the do-not-contact list." It adds the domain to your suppression list so nobody there is emailed.
• "Which campaign is getting the most replies this month?" It pulls campaign analytics and compares them.
• "Invite my colleague to the project." It sends a team invitation by email.

The 33 tools, grouped

You do not need to memorize tool names, but knowing the groups shows what is possible.

Billing and account: get_account and get_balance. Projects: list_projects, get_project (it reports whether a project is still being created or is ready), create_project, project_analytics, get_project_budget and set_project_budget. Importing leads: import_leads loads a CSV list you already have, and get_import shows how that import turned out. Post audiences: leads_from_post builds a campaign from the engagement on a LinkedIn or X post of yours, meaning everyone who left a comment or a reply, and list_posts shows your posts.

Campaign tools: list_campaigns, get_campaign and campaign_analytics show what is happening, set_campaign_budget and archive_campaign adjust it, and create_campaign, start_campaign and stop_campaign control what runs. Lead and inbox tools: read_conversation, list_inbox and list_hot_leads let you look, while reply, set_lead_note and set_lead_status let you act.

Protection and automation: suppress_emails, suppress_domains, list_webhooks, add_webhook and test_webhook. Team: list_team and invite_teammate.

Getting hot leads into your CRM starts with a prompt asking ChatGPT to create a webhook that points at a Zapier, n8n or Make trigger. Run test_webhook a single time and the sample payload gives you what you need to map each field. Every event Yirlo delivers carries an HMAC-SHA256 signature, found under the X-Yirlo-Signature header, so the receiving side can check who sent it.

Staying in control of changes and replies

Every Yirlo tool is available to ChatGPT, including the ones that change things. That covers starting and stopping campaigns, changing budgets, suppressing addresses and sending replies. ChatGPT asks for your confirmation before it runs a tool that changes something, so read the confirmation before you approve it.

Give reply extra care: it delivers an actual email to an actual lead from your Yirlo mailboxes. Ask ChatGPT to show you the draft first, adjust the wording in the chat, and then tell it to send.

Budget changes deserve the same care. A line such as "set the daily budget to $30" is easy to type, so check the campaign name and the amount in the confirmation prompt.

Keeping your key safe

The ChatGPT setup above uses OAuth, so you never copy a key into ChatGPT. The connection is tied to your Yirlo sign-in and the Allow click, which is the safest route for this integration.

An API key suits scripts and other MCP clients. Create one in the app at https://yirlo.com/app/api-keys. Keys start with yk_live_ and are accepted by the SDKs, the MCP server and the API. Send it as Authorization: Bearer yk_live_your_key, or in an X-API-Key header.

Treat that key like a password. It can send email and spend credit, so keep it in a secrets manager or an environment variable. Keep it out of chat messages, screenshots, shared documents and code repositories. Never paste it into a ChatGPT conversation, since the OAuth connection makes that unnecessary.

To end ChatGPT's access, open Integrations, then API key in Yirlo. The connection appears there as ChatGPT (connected), and you can disconnect it at any time.

Questions

Related