Tj{6dZddlmZddlZddlZddlZddlZejjddjdZ ejjddZ dd Z dd Z d dd Zdd Zd Zy)uSmartlead cold-email control — in-process MCP so Jarvis runs Ahmed's outreach. Smartlead (server.smartlead.ai) is the platform where Ahmed's cold-email campaigns live — sender inboxes (warmed), campaigns, email sequences, the leads in each campaign, and the reply/open analytics. This module gives Jarvis hands on ALL of it by voice: report how campaigns are doing, spin one up, drop the Ultron-scraped verified leads into it, write the follow-up sequence, and start/pause it. Auth: a single admin API key in .env as SMARTLEAD_API_KEY, passed as the `?api_key=` query param on every call (Smartlead's scheme). MCP_SMARTLEAD=0 disables the whole server. No extra deps — stdlib urllib, same as the other _control.py modules. Tools (Claude sees them as mcp__smartlead__): smartlead_campaigns list campaigns + status smartlead_campaign_stats analytics for one campaign (sent/open/reply/bounce) smartlead_senders sender inboxes + warmup reputation/health smartlead_create_campaign make a new campaign, returns its id smartlead_set_sequence write the email steps/follow-ups for a campaign smartlead_add_leads push leads (e.g. Ultron verified emails) into one smartlead_campaign_control start / pause / stop a campaign smartlead_api generic passthrough for ANY other endpoint (full control) The named tools cover the common voice actions; smartlead_api is the escape hatch so "full control" really means full — any REST endpoint Smartlead exposes. ) annotationsN SMARTLEAD_URLz"https://server.smartlead.ai/api/v1/SMARTLEAD_API_KEYchtjjdddk(ryttS)z5On when a key is present and not explicitly disabled. MCP_SMARTLEAD10F)osenvirongetbool_KEYE/Users/ahmed/devFolder/Ultron/claude-voice/voice/smartlead_control.pyenabledr(s& zz~~os+s2 :rcdd|dgiS)Ncontenttext)typerr)msgs r_textr/s 56 77rc|jdsd|z}d|vrdnd}t||dt}|#tj|j nd}t jj|||}|jdd|jd d |jd d t jj|| 5}|j} ddd rtj"| SiS#1swY"xYw#t jj$rC} | jdd jdd} td| j d| d} ~ wwxYw)zOne Smartlead REST call. api_key is appended as a query param. Raises RuntimeError with the server's message on a non-2xx so the tool can speak it.r?&zapi_key=N)datamethodz Content-Typezapplication/jsonz User-AgentzuMozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36Accept)timeoutizutf-8ignorezHTTP z: ) startswith_BASErjsondumpsencodeurllibrequestRequest add_headerurlopenreaderror HTTPErrordecode RuntimeErrorcodeloads) rpathbodyr!sepurlrreqrrawedetails r_apir=3sM ??3 Tz##C GD6#htf -C(,(84::d  " " $dD .. 4 ?CNN>#56NN<45NN8/07 ^^ # #C # 9Q&&(C: "4::c?)r) : 9 << ! !7$3&&w9U166("VH5667s02!DD$DD DE1.>E,,E1c,t|j}|sy|jr|S tddxsgD]X}t|j ddj |j k(s>t|j dcStddxsgD]W}|j t|j ddj vs=t|j dcS y#t $rYywxYw)zDResolve a campaign id from an id or a (case-insensitive) name match.NGET /campaignsnamerid)strstripisdigitr=rlower Exception)refcs r _campaign_idrJNs c(.. C  {{} e\*0b0A155$%++-<155;''1e\*0b0Ayy{c!%%"34::<<155;''1  s+A D>DA D(DD DDc  ddl ddlm}m}|ddid$ fd }|dddtid$ fd }|d d id$ fd }|d ddtid$ fd }|ddttdd$ fd }|ddttdd$ fd }|ddttdd$ fd }|ddtttdd$ fd } |d!d"|||||||| g#S)%Nr)toolcreate_sdk_mcp_serversmartlead_campaignszList Ahmed's Smartlead cold-email campaigns with their status (DRAFTED/ACTIVE/PAUSED/COMPLETED). Use for 'how are my campaigns', 'what campaigns do I have', 'is the outreach running'.c K jtddd{}|s tdS|Dcgc]:}d|jdd|jdd|jd <}}tt |d d j |zS7cc}w#t $r$}td t|dd cYd}~Sd}~wwxYww)Nr?r@uQNo campaigns yet — the account has sender inboxes ready but nothing is running.z- [rBz] rAu — statusz campaign(s):  zsmartlead_campaigns failed: ) to_threadr=rrlenjoinrGrC)argscampsrIlinesr;asyncios rrNz)build_server..smartlead_campaignses H!++D%FFE=>>$%#155;-r!%%-):%h?PQ# %CJ<7$))E:JJK K G% H7At ~FG G Hs_CB&BB&CB&?B!4*B&CB&!B&& C/CC CCCsmartlead_campaign_statszGet performance analytics for ONE campaign: sent, opens, replies, bounces, unsubscribes. `campaign` = the id or the campaign name. Use for 'how is the campaign doing', 'any replies on the outreach'.campaigncKjt|jddd{}|s tdS jtdd|dd{fd}tdjd |d |d d |d d|dd|dd|dd|dxs|ddS77j#t $r$}tdt |ddcYd}~Sd}~wwxYww)Nr[ruZCouldn't find that campaign — try smartlead_campaigns first to get the exact name or id.r? /campaigns/z /analyticsc(j|dS)Nr)r)kas rz@build_server..smartlead_campaign_stats..s!%%1+r Campaign rAz: sent sent_countz , opened open_countz , replied reply_countz , bounced bounce_countz, unsubscribed unsubscribed_countz, leads campaign_lead_stats total_count.z!smartlead_campaign_stats failed: rR)rSrJrrr=rGrC)rVcidgr;r`rYs @rrZz.build_server..smartlead_campaign_statsus4 %%lDHHZ4LMM>? ? M''e{3%z5RSSA%AAEE&#./0,( !L/1BC]+,Jq7H6IJ !"6 78901EQ}5EFa IJ JN T M.smartlead_senderss   F **eBDDD<==EUU+,2 |,--=vv159:"uu.456&'ee,?&@deLNOCI;m4tyy7GGH HD F5c!fTcl^DE E FsOD CCCD B%CD C D"D;D<D DD smartlead_create_campaignzCreate a new (empty, DRAFTED) campaign and return its id. Follow up with smartlead_set_sequence + smartlead_add_leads, then smartlead_campaign_control to start it. `name` is the campaign name.rAcKt|jddj}|s tdS j t ddd|id{}|jdxs|jd}td|d |d S7:#t $r$}td t|dd cYd}~Sd}~wwxYww) NrArz.smartlead_create_campaign failed: need a name.POSTz/campaigns/createrB campaign_idzCreated campaign z (id z(). Next: set its sequence and add leads.z"smartlead_create_campaign failed: rR)rCrrDrrSr=rG)rVrAoutrkr;rYs rryz/build_server..smartlead_create_campaigns 488FB'(..0IJ J N))f1FD>CCC''$-9377=#9C,THE#?AAB BC  N=c!fTcl^LM M NsF7CBB9BCB CB=7C8C=CCsmartlead_set_sequenceaoSet/overwrite a campaign's email sequence (the initial email + follow-ups). `campaign` = id or name. `sequence_json` = a JSON array of steps, each {"seq_number":1, "seq_delay_details":{"delay_in_days":0}, "subject":"...", "email_body":"

...

"}. Use {{first_name}} etc. for personalisation. Follow-ups usually have subject:"" so they thread under the first email.)r[ sequence_jsoncKjt|jddd{}|s tdS t j |jdd} jtdd |d d |id{td t|d |dS7y#t $r$}tdt|ddcYd}~Sd}~wwxYw7Q#t $r$}tdt|ddcYd}~Sd}~wwxYww)Nr[rCouldn't find that campaign.r[]z sequence_json isn't valid JSON: xr{r]z /sequences sequenceszSaved a z-step sequence on campaign rjzsmartlead_set_sequence failed: rR rSrJrrr%r3rGrCr=rT)rVrkseqsr;rYs rr~z,build_server..smartlead_set_sequences%%lDHHZ4LMM78 8 L::dhh=>D K##f C5 ;d#% % %8CI;.I#aPQ QN  L;CF4CL>JK K L % K:3q6$3<.IJ J Ks{*D B'D %B)&!CCC&D ) C2C C D CD C D$D=D>D DD smartlead_add_leadsuSAdd leads to a campaign — this is how Ultron's scraped, verified emails get loaded for outreach. `campaign` = id or name. `leads_json` = a JSON array of leads, each {"email":"..", "first_name":"..", "last_name":"..", "company_name":"..", "phone_number":"..", "custom_fields":{..}}. email is required; the rest optional. Max 100 per call.)r[ leads_jsonc Kjt|jddd{}|s tdS t j |jdd}|s tdS jtd d |d d |dd id{}|jd|jdt|}|jdd}td|d||r d|dzSdzS7#t $r$}tdt|ddcYd}~Sd}~wwxYw7#t $r$}tdt|ddcYd}~Sd}~wwxYww)Nr[rrrrzleads_json isn't valid JSON: rzNo leads to add.r{r]z/leads lead_listd upload_count total_leadsalready_added_to_campaignrzAdded z lead(s) to campaign z (z were already in it).rjzsmartlead_add_leads failed: rRr)rVrkleadsr;r}upduprYs rrz)build_server..smartlead_add_leadss%%lDHHZ4LMM78 8 IJJtxx d;.smartlead_campaign_controls  %%lDHHZ4LMM78 8) Ds488Hb1288:;@A A O##f C588V:LN N N9SEvha89 9N N O>s1vds|nMN N OsR*C7CAC7 !C,C-CC7C C4C/)C4*C7/C44C7 smartlead_apiuEscape hatch for FULL control — call ANY Smartlead REST endpoint the named tools don't cover (webhooks, lead status, schedules, warmup toggles, delete, etc.). `method` = GET/POST/DELETE. `path` = the path after /api/v1, e.g. '/campaigns/123/leads?offset=0&limit=20' (api_key is added for you). `body_json` = JSON string for the request body (omit for GET). Returns the raw JSON. Prefer a named tool when one fits; use this for everything else.)rr4 body_jsoncKt|jddj}t|jddj}|s t dSd}|jdr t j |d} jt|||d{}t j|d }t |dd t|d kDrd zSdzS#t$r$}t dt|ddcYd}~Sd}~wwxYw7r#t$r$}t d t|ddcYd}~Sd}~wwxYww)Nrr?r4rz"smartlead_api failed: need a path.rzbody_json isn't valid JSON: rF) ensure_asciiiu …[truncated]zsmartlead_api failed: i,) rCrupperrDrr%r3rGrSr=r&rT)rVrr4r5r;r}srYs rrz#build_server..smartlead_apis@TXXh./557488FB'(..0=> > 88K  Lzz${"34 B))$dCCC 3U3A5D#a&4-%6PQ QRPQ Q  L;CF4CL>JKK LD B1#a&#,@A A Bs~A3E7C.D +D,9D %E&D -E. D7DDEDED E )EE EE  E smartleadz1.0.0)rAversiontools)rVdictreturnr)rYclaude_agent_sdkrLrMrC) rLrMrNrZrmryr~rrrrYs @r build_serverras<  CDFH H H H $ S s   M  M"  89;=F =F$ % Q 3-  N  N " ? S 13K3K   1 # .0H0H* & 2c * , O , O / 0#C 8:B:B$ ! '"$<>O(*@"$> O r)rr)rrCrr)N)rrCr4rCr5zdict | list | Noner!int)rHrCrz str | None)__doc__ __future__rr%r urllib.errorr(urllib.requestr rrstripr$rrrr=rJrrrrrs~6#  ; ==CVC[ zz~~)2.8=A**6&{r