Zen Tools MCP docs

Four things customers ask Zen Tools to do.

Most users ask for leads, templates, sends, or brand assets. Codex and Claude can write the copy; Zen Tools makes the result usable: paid email-template creation, valid email components, public asset URLs, sender rules, tests, delivery checks, and usage.

4core customer outcomes
32documented product commands
OAuthno API-key fallback
Wallet Credits

Pricing is tied to the artifact you ask Zen Tools to create.

Validation, recipient preview, delivery audit, and public asset upload are workflow controls, not separate customer decisions.

Lead acquisitionWallet Credits per requested lead run

Fast mode delivers verified emails with fit scores. Quality mode keeps searching for verified emails above the 0.5 fit threshold. Downstream search and enrichment Wallet Credits are tracked separately in Usage.

Reusable email templateWallet Credits per saved template

One saved template created from your brief, brand profile, and supported email components.

Campaign image generationWallet Credits per generated image

One image generation request for email, landing, or campaign assets.

Image edit or upscaleWallet Credits per image edit

One image utility request for refining a campaign asset.

Public asset uploadIncluded workflow control

Stores a generated asset and returns a stable public URL for email rendering as part of the campaign workflow.

Hosted OAuth MCP

Install once, then authorize Zen Tools in your agent.

Zen Tools uses the hosted OAuth MCP endpoint. Do not paste API keys into Codex, Claude Code, or browser clients.

Codex install

Add Zen Tools MCP to Codex with OAuth, then authorize the email scope in the browser.

codex mcp add zentools --url https://agents.omtx.ai/zentools-mcp
codex mcp login --scopes email zentools

Claude Code install

Add Zen Tools MCP over hosted HTTP, then run /mcp and authenticate.

claude mcp add --transport http zentools https://agents.omtx.ai/zentools-mcp
claude mcp login zentools
Earn Wallet Credits

Earn Wallet Credits for useful contacts.

Submit structured professional contacts with name and email. Eligible submitted contacts enter the shared people pool, receive one Zentools pitch email, and reward your workspace only after delivery is verified.

01

Submit contacts

Provide structured professional contacts with a real name and email. Accepted contacts become shared Zentools people inventory for future ICP matching.

zen_people_global_pool_submit
02

Verify delivery

Zentools sends one pitch email for that reward lane. Credits do not settle on submission; delivery has to come back from the email provider.

email.delivered
03

Earn 500 Wallet Credits

Once delivery is verified, the wallet reward settles for the selected workspace and mode. Same-mode duplicates do not earn again.

zen_contact_reward_delivery_audit
Lead modes

Choose speed or precision before the run starts.

Both modes require a verified person-specific email before a lead is delivered. The difference is whether fit scoring is advisory or a delivery threshold.

Fast modeemail_verified

Deliver verified emails first, then score fit.

Zen Tools delivers verified person-specific emails as soon as it finds them, then attaches fit score, evidence, and notes so the customer can triage quickly.

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

Keep searching until a verified email clears the ICP threshold.

Zen Tools 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.
Start here

Use the smallest tool path that creates the customer artifact.

The rest of the MCP exists for reuse, control, auditability, and asset plumbing. Users should only drop into lower-level commands when they need to inspect or customize a step.

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, delivery mode, and contact paths.
Primary toolszen_icp_createzen_icp_statuszen_lead_iterative_findzen_lead_batch_statuszen_current_leads

ICP, mode, status, enrichment, usage, and lead-list tools let users create reusable research context, choose speed or precision, inspect results, and continue from delivered leads without exposing lower-level sourcing controls.

02

Create an email template

Turn my copy, audience, and brand into a reusable email.

OutputA saved template that Zentools structured, QC'd, and made previewable from supplied content and component intent.
Primary toolszen_email_template_createzen_update_validate

Validation and send tools exist so users can reuse a saved artifact safely before anything is sent.

03

Send or test emails

Send this template to myself first, then launch it to the approved recipients.

OutputA test or live send from Zen Tools with delivery state and reply routing back to the customer.
Primary toolszen_update_send_testzen_update_sendzen_update_delivery_audit

Recipient preview and audit tools exist so users can inspect the audience and reconcile delivery without guessing.

04

Create brand assets

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

OutputA public, email-safe asset URL that can be referenced from templates and brand profiles.
Primary toolszen_image_generatezen_image_editzen_asset_public_upload

Upload tools exist because email templates need stable public asset URLs, not local files.

Why more than four commands?

Supporting tools are for power users, not the first-run path.

Text generation is deliberately not the main value proposition. Your MCP client can write copy. Any copy shaping Zen Tools needs should happen inside the paid template or asset flow, not as a separate customer decision.

Reuse

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

workspace_initzen_workspace_selectzen_brand_profile_put

Control

Inspect or validate the artifact before Zen Tools spends work, sends a test, or launches a campaign.

zen_lead_batch_statuszen_update_validatezen_update_recipients_preview

Audit

Confirm what happened: which leads were delivered, which emails sent, and what usage was recorded.

zen_usage_summaryzen_update_delivery_auditzen_contact_reward_delivery_audit

Earn

Earn up to $5K in Wallet Credits when you share up to 1,000 eligible contacts with Zentools. Audit delivery and settlement before counting credits as granted.

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 embedded in rendered emails.

zen_image_generatezen_asset_public_upload
Product reference

Customer-facing commands for agents that need more control.

Start with the core workflows above. Use the full list when you need to reuse a profile, validate a template, publish an asset URL, or audit delivery. Low-level text helpers are implementation details inside template creation, not customer-facing workflow choices.

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 Zen Tools 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 delivery counts for the current workspace.Summarize this week's accepted leads and delivered emails.
02

Lead discovery

Create a reusable ICP, complete its research context, then generate evidence-backed leads. Fast mode prioritizes verified emails with scoring; Quality mode requires verified emails to clear the ICP threshold. Usage shows the actual workspace spend.

16 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 write the first email.
  • 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 leads delivered to the selected workspace, with optional ICP and audience filters.Show my current delivered leads for the landscaping owner ICP.
  • zen_people_global_pool_submitSubmit structured people lists into shared inventory. Earn up to $5K in Wallet Credits when you share up to 1,000 eligible contacts with Zentools. Credits settle only after delivery verification.Add this conference speaker list to the people pool and audit reward delivery state.
  • 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.
03

Custom email generation and sending

Generate custom emails, test them on yourself, then send from zentools.omtx.ai with no email platform fee.

7 tools
  • zen_email_template_createCreate a workspace-stored email template from a content brief, brand constraints, and supported email blocks; billed as Wallet Credits per saved template.Create a founder follow-up template with a proof block and CTA from this draft copy.
  • zen_update_validateValidate a campaign template before any send.Validate this campaign and tell me which fields are missing.
  • zen_update_recipients_previewPreview the recipient list assembled from accepted leads or custom emails.Preview recipients for the May launch campaign before sending a test.
  • zen_update_send_testSend one test email to yourself or a teammate using the real template.Send a test of this campaign to me at founder@example.com.
  • zen_update_sendShip the approved campaign to the workspace recipient list.Send the approved May launch campaign and report delivered counts.
  • zen_email_send_one_offSend one workspace-scoped personal Zentools email without newsletter unsubscribe handling.Send this personal follow-up to sara@example.com from my selected workspace.
  • zen_update_delivery_auditAudit sends against delivery state and summarize delivered, bounced, and failed outcomes.Audit the May campaign delivery and summarize delivered, bounced, and failed.
04

Campaign assets

Create images and public asset URLs for campaigns. Copy and structured text shaping happen inside template creation.

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.