Connect Cline to Yirlo with the Yirlo MCP server
By the Yirlo team · Product details checked against the app
Once Cline is pointed at Yirlo's MCP server, it can drive your whole Yirlo account from inside the editor. Setup is a single remote server entry, with your API key sent as a header. Cline then exposes 33 tools for campaigns, the inbox, hot leads, budgets, projects and lead imports. Below you will find a config block to copy, a way to confirm it works, sample prompts and advice on protecting the key.
What Cline can do with Yirlo
The MCP endpoint at yirlo.com/mcp gives Cline the controls for outreach that reaches a single decision maker at each company. All 33 tools correspond to one request to Yirlo's public API apiece, so whatever Cline reads or changes matches what the API itself exposes.
This arrangement fits developers and technical founders who live in VS Code with Cline all day. Looking at results, pausing a campaign or replying to an interested lead turns into one line typed in the task window, with no extra browser tab.
Your first project starts on yirlo.com: open it and enter your website address. Any later project can be created directly from Cline with create_project, and Cline then takes care of the day-to-day work.
Before you connect
Keys are made in the app, on the API Keys page. Each one begins with yk_live_. One key covers the REST API, the MCP server and both SDKs, so there is no second credential to obtain.
Before you start, make sure the project you plan to drive from Cline already exists in your account. The server speaks MCP protocol revision 2025-06-18 over Streamable HTTP, and current Cline versions support that.
Cline setup with the exact config
In Cline, open the MCP Servers panel and choose Remote Servers. Name the entry yirlo, paste the endpoint address (https://yirlo.com/mcp) and select Streamable HTTP as the transport type. Since the key goes in a header, editing the settings file directly is the simplest path.
In the MCP Servers panel, choose the option that opens cline_mcp_settings.json, then paste the block below. Swap YOUR_KEY for your own yk_live_ key.
{
"mcpServers": {
"yirlo": {
"headers": {
"Authorization": "Bearer YOUR_KEY"
},
"type": "streamableHttp",
"url": "https://yirlo.com/mcp"
}
}
}The type field is required. If "type": "streamableHttp" is missing, Cline assumes a remote server uses the legacy SSE transport, and the connection breaks. For the credential, an X-API-Key header works in place of the Bearer authorization, and the server takes both.
After you save the file, Cline connects on its own and lists the yirlo server in the MCP Servers panel, with all of its tools beneath it.
A first test request
Open a new task and type: Use the yirlo server to show my account and my credit balance. Cline asks for approval to run get_account and get_balance. Approve both, and the answer comes back in the conversation.
For a second check, type: List my Yirlo projects and show last week's analytics for the first one. Cline calls list_projects and then project_analytics. Both calls only read data, so this test changes nothing in your account.
When both answers arrive, the key, the header and the transport are all correct, and you can move on to real work.
What you can ask
Cline picks the right tool from plain language. These asks cover most days:
- Asking for the week's hot lead count calls list_hot_leads and project_analytics.
- "Pause the campaign for dentists" uses list_campaigns to find it and stop_campaign to pause it.
- A prompt like "Set the daily limit to $30" is handled by set_campaign_budget or set_project_budget.
- Telling Cline to answer the latest interested lead with a Tuesday time makes it run read_conversation, then reply.
- To block a competitor, ask Cline to put their domain on the suppression list. suppress_domains handles that, and suppress_emails handles individual addresses.
- Asking Cline to register a webhook for incoming hot leads and fire a test event calls add_webhook and test_webhook.
- "Invite my colleague to the project" uses invite_teammate, and list_team shows who is already in.
Actions that send email or spend credit
Some tools just read data, but a couple take action. Calling reply delivers an actual email to the lead. Calling start_campaign kicks off sending, and every email draws about five cents from your prepaid balance, capped by the daily budget you choose.
Keep Cline's approval prompt switched on for these tools. A good habit is to ask Cline to show the reply text first, edit it in the conversation, and approve the send only when it reads right.
Auto-approve suits the read tools such as get_balance, list_inbox and list_hot_leads. Before starting a campaign, ask Cline to check get_project_budget so the daily limit is what you expect.
Keeping the key safe
Treat the yk_live_ key like a password. It opens up the API, the MCP server and every SDK. Anyone holding it can read your inbox and send replies for your project.
The config file is where the key lives, which makes a few habits worth adopting:
- Keep cline_mcp_settings.json out of any git repository, and add it to your ignore list if it sits inside a project folder.
- Skip pasting the key into prompts, issues, screenshots or chat messages. Cline only needs it in the headers field.
- To give teammates access, use the invite_teammate tool or go to Integrations > Team in the app. Everyone then logs in with a personal email address.
- If you suspect the key has leaked, generate a replacement at https://yirlo.com/app/api-keys and paste it into the config straight away.
If something fails
Most problems come from the config entry rather than the server. Check these in order:
- Connection error or SSE message: confirm the entry includes "type": "streamableHttp".
- When you get an Unauthorized error, check the Authorization header. It should contain the word Bearer, one space, and the complete yk_live_ key, without stray quotes or line breaks.
- Server listed but tools missing: toggle the yirlo server off and on in the MCP Servers panel, or restart the editor.
- Wrong data returned: ask Cline to run list_projects and confirm which project it is working on.
Questions
How do I connect Cline to Yirlo?
In Cline's remote server form, name the entry yirlo, set the URL to https://yirlo.com/mcp, pick the Streamable HTTP transport, and pass your yk_live_ key in the Authorization header as Bearer plus the key. The matching settings-file entry appears in the setup section above.
Where do I get the key?
A new key is generated on the API keys page of your Yirlo account. It begins with yk_live_, and that single key also authenticates API calls and both SDKs.
Which header should carry the key?
Use Authorization: Bearer with your key, or send the same key as an X-API-Key header. The server accepts both.
Why does Cline treat the server as SSE?
By default Cline assumes a remote server uses the older SSE style. Put "type": "streamableHttp" in the yirlo entry of cline_mcp_settings.json and the connection succeeds.
What size is the Yirlo MCP toolset available inside Cline?
The MCP server exposes 33 tools, and every one mirrors a call in the public Yirlo API. Through them an assistant can read account details and balance, manage suppression lists and webhooks, send team invites, and work with campaigns, budgets, analytics, the inbox, replies, notes, lead status and hot leads. Projects are covered too: create_project opens an additional project once the first one exists. To bring in contacts, use import_leads and get_import for a CSV from your own files, or use leads_from_post together with list_posts to turn the people who commented or replied under one of your LinkedIn or X posts into a campaign.
Can Cline start a new project for me?
After your opening project exists on yirlo.com, set up from your website along with the first payment, Cline can add more through create_project using a domain, or a description of a business that has no site. It then runs their campaigns, budgets, inbox and webhooks through the MCP server.
Does Cline send real emails when it replies?
Yes. Whatever you send through the reply tool is delivered as a real email to the lead. Keep Cline's approval prompt enabled for that tool, and read the draft before confirming.
What does it cost to run campaigns from Cline?
Each email sent is billed at roughly five cents against your prepaid credit, and spending stays inside the daily budget you choose. Running get_balance and get_project_budget in Cline shows your current position.
Can I send hot leads to my CRM from Cline?
Yes, and the setup happens inside Cline itself. Ask it to create a webhook with add_webhook, then run test_webhook to confirm the connection works. After that, Zapier, n8n or Make can pass hot leads and incoming replies along to Pipedrive, Salesforce, HubSpot or whatever CRM your team already uses.