Advanced documentation

Technical reference for agents, builders, and operators.

This page documents the complete hosted Zentools tool surface, workflow states, and lower-level controls. Most customers can use plain-language requests from the customer guide instead.

33hosted agent tools
4tool groups
5core workflows
Core workflows

Use the smallest tool path that creates the requested result.

These are implementation paths for agents and operators, not required vocabulary for customers.

01

Request leads

Create this ICP, research it, then find me N leads in Fast mode or Quality mode.

OutputVerified email-bearing leads with evidence, fit score, outreach status, activity history, and any available contributor-backed warm path.
Primary toolszen_icp_createzen_icp_statuszen_lead_iterative_findzen_lead_batch_statuszen_current_leadszen_lead_updatezen_lead_activity_list

ICP, mode, status, enrichment, usage, lead-list, and activity tools let users search the shared network before the web, choose speed or precision, inspect results, and preserve outreach context without exposing lower-level sourcing controls.

02

Enrich delivered emails

Enrich this delivered lead with more evidence before I reach out.

OutputAn enriched lead record with extra evidence, context, and notes attached to a verified email.
Primary toolszen_lead_enrich_launchzen_lead_enrich_statuszen_lead_enrich_watchzen_current_leads

Enrichment is a separate follow-up job so users can deepen a delivered email without launching another full lead run.

03

Request a warm introduction

Ask the original contributor of this delivered lead for a warm introduction.

OutputA connector-reviewed three-way introduction email to the lead with the requester CC'd.
Primary toolszen_intro_request_createzen_intro_requests_listzen_intro_request_decidezen_intro_send

The request, connector decision, final email review, Wallet Credit charge, and 10% connector reward are separate auditable steps. A paid request never guarantees acceptance or an introduction.

04

Reach out and keep the record

Give me the verified emails, let me send from my own mailbox, then record who I contacted.

OutputA filterable workspace lead list plus workspace-scoped notes and outreach history. Sending remains in the customer's reviewed email path.
Primary toolszen_current_leadszen_lead_updatezen_lead_activity_list

zen_current_leads finds the right rows, zen_lead_update records notes or verified outreach after it happens, and zen_lead_activity_list makes the full history auditable. Recording never sends a message.

05

Create brand assets

Make a campaign image, hero visual, logo card, or footer asset I can use later.

OutputA public asset URL that can be referenced from a brand profile or a later campaign.
Primary toolszen_image_generatezen_image_editzen_asset_public_upload

Upload tools exist because campaign assets need stable public URLs, not local files.

Delivery modes

Choose coverage or stricter qualification.

Fast modeemail_verified

Deliver verified emails first, then score fit.

Zentools checks shared people inventory first, then uses web discovery when needed. It delivers verified person-specific emails as soon as it finds them and attaches fit score, evidence, and contributor context.

Exploration, hard-to-source audiences, and list building when recall matters.
Quality modeicp_qualified

Keep searching until a verified email clears the ICP threshold.

Zentools checks the pool before each web-search loop, keeps sub-threshold verified emails as inventory, and delivers leads only when they clear the 0.5 fit threshold.

Tighter campaigns where precision matters more than speed.
Supporting controls

Tools for reuse, status, billing, audit, and assets.

Reuse

Save customer profile, brand, and assets once so later lead runs do not rebuild the same context.

workspace_initzen_workspace_selectzen_brand_profile_put

Control

Inspect a batch or child run before asking Zentools to spend more acquisition work.

zen_lead_batch_statuszen_lead_run_statuszen_icp_status

Audit

Confirm what happened: which leads were delivered, who was contacted or replied, what notes were recorded, how enrichment finished, and how many shared Wallet Credits remain.

zen_usage_summaryzen_wallet_credits_getzen_current_leadszen_lead_activity_listzen_contact_reward_delivery_audit

Billing

Inspect the shared Om wallet or add Wallet Credits by the authenticated account's default saved card or an invoice after explicit approval.

zen_wallet_credits_getzen_wallet_topup

Network introductions

Spend 500 Wallet Credits to ask the original contact contributor for an introduction. They decide per request and earn 50 Wallet Credits only after sending the three-way email.

zen_intro_request_createzen_intro_requests_listzen_intro_request_decidezen_intro_send

Contribute

Contact-reward Wallet Credits are 50 per eligible contact, up to $500 for up to 1,000 contacts. Credits settle after Resend reports invitation delivery. Submitted contacts become shared people inventory.

zen_people_global_pool_submitzen_people_global_pool_searchzen_contact_reward_delivery_audit

Asset plumbing

Images and files must become stable public URLs before they can be reused in later campaigns.

zen_image_generatezen_asset_public_upload
Complete tool catalog

Hosted Zentools agent surface.

Tool names and examples below track the deployed OAuth-enabled agent service.

01

Workspace and brand

Define your customer profile once; the agent uses it on every run.

6 tools
  • workspace_initInitialize a workspace with your customer profile and customer-owned reply-to email.Initialize a workspace for AI-native biotech founders with reply-to founder@example.com.
  • zen_workspace_getRead the current workspace profile and operating defaults.Show my current customer profile, reply-to, and campaign defaults.
  • zen_workspaces_listList workspaces owned by the signed-in user.List my Zentools workspaces.
  • zen_workspace_selectSelect the workspace subsequent MCP calls should use.Use the Zen Alpha workspace for the next campaign.
  • zen_brand_profile_putCreate or update visual brand settings for emails and assets.Save this logo URL, color palette, footer note, and campaign assets as my launch brand profile.
  • zen_usage_summaryInspect usage and delivered-lead counts for the current workspace.Summarize this week's accepted leads and delivered emails.
02

Wallet and billing

Zentools and omtx.ai use the same authenticated Om Wallet Credit balance and saved payment methods.

2 tools
  • zen_wallet_credits_getRead the authenticated user's current shared Om Wallet Credit balance.How many Wallet Credits do I have before starting this lead run?
  • zen_wallet_topupAfter explicit approval, add Wallet Credits with the account's default saved card or create an invoice in the required increments.I approve adding $<amount> Wallet Credits by saved card. Use a new explicit idempotency key.
03

Lead discovery

Create a reusable ICP, then search shared people inventory before the web. Filter delivered people by outreach status, preserve notes and touches, and request a warm introduction when contributor context exists.

22 tools
  • zen_icp_createCreate or update a reusable workspace ICP and launch its required deep-research context.Create an ICP for Series A SaaS retention leaders in North America.
  • zen_icp_statusCheck whether the ICP deep-research context is complete before lead acquisition.Is my Series A SaaS retention ICP ready for lead finding?
  • zen_lead_sources_getDiscover reusable source sites and URLs for a researched workspace ICP before email acquisition.Find reusable sources for my Series A SaaS retention ICP.
  • zen_lead_sources_listList source URLs already discovered for the selected workspace and ICP.Show the saved source inventory for my Series A SaaS retention ICP.
  • zen_lead_emails_getMine previously discovered source URLs for inserted email-bearing leads.Get 10 verified-email leads from the saved landscaping owner source inventory.
  • zen_lead_iterative_findLaunch one or more independent one-lead linear search loops in Fast mode or Quality mode for a researched ICP key.Find 25 leads for my Series A SaaS retention ICP in Quality mode, or use Fast mode to review every verified email with fit scores.
  • zen_lead_run_statusCheck progress on a source, email, or iterative child run.What is the status of this Zentools lead run?
  • zen_lead_run_watchLong-poll a source, email, or iterative child run until it produces results or needs more time.Watch this child run and tell me when a delivered lead is ready.
  • zen_lead_batch_statusInspect a multi-child iterative-find batch by the batch_id returned from zen_lead_iterative_find.Show aggregate counts and child run IDs for this 25-lead batch.
  • zen_lead_enrich_launchLaunch a separate enrichment job for an inserted email-bearing lead.Enrich this delivered lead before I email them from my own mailbox.
  • zen_lead_enrich_statusCheck the status of a lead enrichment job.What is the status of this enrichment run?
  • zen_lead_enrich_watchLong-poll a lead enrichment job until it completes or needs more time.Watch this enrichment run and summarize the result.
  • zen_current_leadsList delivered leads with ICP, CRM stage, outreach-state, search, and pagination filters.Show my not-yet-contacted landscaping leads, 25 at a time.
  • zen_lead_updateRecord a note, outbound touch, inbound reply, meeting, or stage change for one delivered workspace lead. It updates the fast CRM summary but never sends a message.Record that I emailed this lead today and save the provider message ID. Do not send anything.
  • zen_lead_activity_listList the append-only notes and outreach history for one delivered workspace lead.Show the complete outreach history and notes for this lead.
  • zen_people_global_pool_submitSubmit structured people lists into shared inventory. Contact-reward Wallet Credits are 50 per eligible contact, up to $500 for up to 1,000 contacts. Credits settle after Resend reports invitation delivery.Add this conference speaker list to the people pool as shared inventory.
  • zen_people_global_pool_searchSearch reusable people inventory before spending on new web discovery.Search the people pool for professors who match this discovery-services ICP.
  • zen_contact_reward_delivery_auditAudit the selected workspace user's mode-scoped submitted-contact reward delivery and settlement state.Audit my submitted-contact rewards and show pending, granted, rejected, and Stripe-mode counts.
  • zen_intro_request_createSpend 500 Wallet Credits to notify the original contributor that you want a warm introduction to a delivered pool lead. The request is not a guarantee, and only one paid request is allowed per requester and pool lead.Ask the original connector for a warm introduction to this delivered lead and include this context.
  • zen_intro_requests_listList incoming connector requests and outgoing requests with their current status.Show my pending warm-introduction requests.
  • zen_intro_request_decideAccept or decline one request as the original contact contributor; accepting does not send the email.Accept this introduction request, but do not send it yet.
  • zen_intro_sendAfter acceptance and final review, send the introduction to the lead with the requester CC'd and grant the connector 10% of the request credits.Show the exact intro email, then send it after I approve.
04

Campaign assets

Create images and public asset URLs for later campaigns. Outbound send from Zentools is held; use these assets in your own email path.

3 tools
  • zen_image_generateGenerate or reference-edit campaign images.Generate a launch hero image for this campaign.
  • zen_image_editRun image utilities such as edit or upscale.Upscale this campaign image for email use.
  • zen_asset_public_uploadUpload an asset to the public campaign asset library.Upload this campaign hero and return the saved asset path.