MCP Tools
https://api.nitrosend.com/mcpAI-native email marketing platform for campaigns, lifecycle flows, and transactional email
Connect your client
Add to your MCP client configuration:
{
"mcpServers": {
"nitro": {
"url": "https://api.nitrosend.com/mcp"
}
}
}Tools
nitro_get_status
read-onlyidempotentGet current account context, sender identity, dashboard links, readiness, onboarding status, and recommendations.
nitro_select_account
idempotentSwitch this OAuth MCP connection to an account listed by nitro_get_status; the next call uses it.
Parameters
account_idintegerrequiredFrom nitro_get_status available_accounts.items[*].id.
nitro_select_brand
idempotentSelect the current brand for this OAuth MCP connection. Use this instead of passing brand_sid to other tools.
Parameters
brand_sidstringExact brand SID to select. Provide either brand_sid or name.
namestringBrand name to select when the SID is unknown. Provide either name or brand_sid. Ambiguous names return candidates without changing context.
nitro_query
read-onlyidempotentQuery any Nitrosend entity. Returns paginated results.
Parameters
entitystringflowscampaignstemplatessegmentscontactslistseventsimportsmessagessuppressionshistoryproductsrequiredContact full text: nitro_search_contacts.
filtersobjectFilters: flows status/campaign_id/trigger_event/search; campaigns status/search; templates subject; segments/lists name; contacts query/subscribed_email/subscribed_phone/list_id; events name/from/to; imports status; messages channel/status/to; suppressions email/reason/source_provider/active; history source/event_type/tool/actor/correlation_id/resource_uri/from/to; products status/query; all id.
pageintegerDefault 1.
perintegerMax 50, default 25.
nitro_search_contacts
read-onlyidempotentSearch contacts by email, name, or phone. Returns summary list or full profile.
Parameters
querystringrequiredmodestringsummaryprofilesummary = list, profile = single contact detail (default: summary)
pageintegerDefault 1.
perintegerMax 50, default 25.
nitro_set_brand_kit
idempotentopen-worldSet Brand Kit from a website, fields, document, or logo URL. Fields override scraping; async is URL-only.
Body
urlstringlogo_urlstringPublic/Nitro image URL; ingest local logos first.
fieldsobjectdocumentstringscan_idstringnew_brandstringdry_runbooleanfalsemodestringsyncasyncsyncidempotency_keystringRequired for URL scraping or remote logo fetch; reuse only for an exact retry.
nitro_ingest
open-worldStore a brand image (PNG, JPEG, GIF, WebP; max 10 MB) from image_file (ChatGPT attachment), image_data, image_url or upload then signed_id. Returns a durable email URL, up to 1200px wide.
Body
kindstringimage_datastringimage_urlstringimage_fileobjectsigned_idstringdescriptionstringTruthful visible content (alt text).
uploadobjectReserve a local-image upload; PUT bytes, then ingest its signed_id.
filenamestringcontent_typestringnitro_manage_audience
destructiveopen-worldContacts, subscriptions, lists, events, segments, tags and prepaid email validation. Custom fields: attributes.data. Bulk adds and unsubscribes: nitro_import_contacts.
Parameters
operationstringcreate_contactupdate_contactset_subscriptionmanage_listrecord_eventdelete_segmentdelete_contactsbulk_tagvalidaterequireddelete_contacts: one of list_id, segment_id, contact_ids. validate: exactly one of contact_channel_ids, contact_ids, list_id, segment_id, all_contacts: true. Its dry run quotes; pass quote_digest on execution to refuse audience or price drift. Execution needs idempotency_key, prepaid funds.
paramsobjectrequiredmanage_list action: create (name[, contact_ids|emails]), rename (list_id, name), delete (list_id), add_contacts|remove_contacts (list_id, contact_ids|emails). bulk_tag tag_action: add|remove|set (default add). set_subscription opt_out: true unsubscribes; suppress: true stops all email incl. transactional, false lifts it.
dry_runbooleanfalseconfirmbooleanfalseRequired for every delete.
idempotency_keystringSame key returns the first result.
nitro_define_segment
idempotentPreview or persist a filtered contact segment. preview_only defaults true; set false and provide name to save.
Body
namestringfiltersArray<any> | anyrequiredFlat AND filters or a boolean group tree of attribute/event filters.
segment_idintegerpreview_onlybooleantrueidempotency_keystringnitro_import_contacts
Inline max 100 contacts returns contact_ids. CSV upload/finalize; contact list read-back requires options.list_ids. Limits: status guardrail or GET /v1/my/imports/spec. New contacts with email subscribe both channels; phone-only do not. Existing subscriptions stay unchanged; added email subscribes, added phone does not.
Body
recordsArray<object>import_idintegersigned_idstringUploaded CSV signed ID.
uploadobjectReserve upload; PUT CSV; finalize signed_id.
resourcestringcontactscontactsInline contacts or CSV contacts.
parserstringdefaultcolumnsobjectoptionsobjectImport options.
dry_runbooleanfalseidempotency_keystringnitro_manage_template
destructiveCreate/edit reusable email templates; based_on clones. Creative work: composition_mode=intent, follow exact next_call. Exact edits: template_id, section_updates, if_version. Broadcasts: nitro_compose_campaign.
Body
sectionsArray<object>Email sections; use nitro://schema only for full authoring. Images use public or nitro_ingest media_url/image_url, never signed_id.
section_updatesArray<object>Targeted section edits; never changes order or type.
subjectstringnamestringcomposition_modestringintentdraftvalidategenerateintent plans; validate checks; draft persists; generate composes and persists.
contract_idstringbrand_context_refstringvalidate_onlybooleanfalsedesign_mode_overridestringpremium_richpremium_minimalfounder_letterutility_plainrenegotiatebooleanfalseuser_instructionstringcreative_route_idstringIntent-only route id.
source_textstringUntrusted source evidence; put authoring directions in user_instruction.
factsArray<object>Literal evidence: required values must appear; available values may be used.
draft_metaobjectOptional authoring provenance; never blocks.
preheaderstringbodystringAuthor text (plain) or custom text alternative (designed).
content_formatstringdesignedplainMatch source.
plain_text_modestringderivedcustomText provenance.
from_namestringfrom_emailstringreply_tostringthemeobjectBrand-theme overrides; logo_url uses public or nitro_ingest media_url/image_url, never signed_id.
template_idintegerbased_onintegerif_versionintegerVersion token for conflict-safe writes.
goalstringdry_runbooleanfalseidempotency_keystringRequired for non-dry-run persistence; exact retry only.
nitro_compose_flow
destructiveopen-worldLive/paused flow saves publish. Creative email: composition_mode=intent, follow exact next_call. replace needs flow_id+confirm+draft revision; patch keeps other nodes. Go live: nitro_control_delivery.
Body
namestringFlow name; required on create.
modestringcreatereplacepatchcreatecreate: new; replace: whole graph; patch: name/email actions
flow_idintegerexpected_updated_atstringPrefer expected_draft_revision_id.
expected_draft_revision_idintegerConflict-safe draft revision.
goalstringlifecycle_keystringcomposition_modestringintentdraftvalidategenerateintent: plan; validate: check; draft/generate: persist.
contract_idstringbrand_context_refstringvalidate_onlybooleanfalsedesign_mode_overridestringpremium_richpremium_minimalfounder_letterutility_plainrenegotiatebooleanfalseuser_instructionstringcreative_route_idstringIntent-only sequence-wide route id.
email_baseline_selectionsArray<object>Intent-only creative_routes[].id and image binding ids per email action_name.
source_textstringUntrusted source evidence; put authoring directions in user_instruction.
factsArray<object>Literal evidence: required values must appear; available values may be used.
draft_metaobjectOptional authoring provenance; never blocks.
triggerobjectstepsArray<any>dry_runbooleanfalseidempotency_keystringRequired for non-dry-run persistence; exact retry only.
confirmbooleanfalsenitro_compose_campaign
destructiveDraft email/SMS broadcasts; never sends. Creative email: composition_mode=intent, follow exact next_call. patch preserves omissions; replace needs campaign_id+confirm, clears omitted audience/schedule. Automation: nitro_compose_flow. Transactional: nitro_send_message.
Body
namestringCampaign name; required when creating.
modestringcreatepatchreplacecreatecampaign_idintegerchannelstringemailsmsemailImmutable after creation.
goalstringcategorystringpromotionannouncementnewsletterwelcomereengagementtransactionalplainEmail job used to select a baseline.
composition_modestringintentdraftvalidategenerateintent plans; validate checks; draft persists; generate composes and persists.
contract_idstringbrand_context_refstringvalidate_onlybooleanfalsedesign_mode_overridestringpremium_richpremium_minimalfounder_letterutility_plainrenegotiatebooleanfalseuser_instructionstringcreative_route_idstringIntent-only route id.
source_textstringUntrusted source evidence; put authoring directions in user_instruction.
factsArray<object>Literal evidence: required values must appear; available values may be used.
draft_metaobjectOptional authoring provenance; never blocks.
subjectstringpreheaderstringfrom_namestringfrom_emailstringreply_tostringbodystringcontent_formatstringdesignedplainMatch source.
plain_text_modestringderivedcustomText provenance.
sectionsArray<object>Email design sections; requires subject. Images accept public or nitro_ingest media_url/image_url, never raw signed_id.
section_updatesArray<object>Same entries as nitro_manage_template section_updates.
themeobjectBrand-theme overrides. logo_url must be public or a nitro_ingest media_url/image_url, never raw signed_id.
template_idintegerif_versionintegerVersion token for conflict-safe writes.
audienceobjectTarget audience; all_contacts must be explicit.
scheduled_atstring<date-time>ISO 8601 delivery time.
dry_runbooleanfalseidempotency_keystringRequired for non-dry-run persistence; exact retry only.
confirmbooleanfalsenitro_manage_domains
destructiveopen-worldManage the brand’s Nitrosend sender and custom sending domains. Receiving MX requires forward-all.
Body
operationstringprepare_brand_subdomainselect_brand_subdomainrename_brand_subdomainaddverifylistremovelist_shared_subdomainsshare_subdomainrevoke_shared_subdomainrequiredPrepare/select a hosted sender or manage customer domains. Rename keeps old addresses receiving. Show a paired removal's effect before unpair.
paramsobjectOperation-specific parameters.
confirmbooleanfalseRequired for removal, renaming and subdomain-sharing changes.
nitro_configure_account
idempotentRead or configure sender defaults and test recipients. Use nitro_get_status for readiness; from_email explicitly selects an authorized, ready, brand-owned sending identity.
Parameters
from_namestringSender display name (e.g. 'Acme Marketing')
from_emailstringExact visible From address to select. May use the apex when a ready aligned sending subdomain authorizes it.
reply_tostringtest_email_recipientsArray<string>Saved test-send addresses; [] clears.
nitro_review_delivery
read-onlyidempotentRead-only content and readiness review with validation, spam/SMS analysis, preflight, and previews. Review either one account entity or bounded inline email content; this never approves or sends.
Parameters
target_typestringtemplateflowcampaigntarget_idinteger>= 1revision_idinteger>= 1Optional for flows. Omit to review the current draft, or supply its ID as a current-draft assertion.
contact_idinteger>= 1Merge-tag personalization contact.
subjectstringInline email review subject.
htmlstringInline email review HTML.
nitro_send_test_message
destructiveidempotentopen-worldSend one real email/SMS test. Never approves or sends to an audience. Flows require an exact revision. Success confirms the mail provider accepted the send. Confirm receipt before approving; it does not prove inbox placement.
Parameters
target_typestringtemplateflowcampaignWith target_id, or use template_id/latest_campaign.
target_idinteger>= 1latest_campaignbooleanfalseLatest campaign in this brand.
template_idinteger>= 1Template id; may select a flow/campaign email.
action_idinteger>= 1Select a flow message step.
revision_idinteger>= 1Exact revision; required for flows.
channelstringautoemailsmsautoPrefer auto.
contact_idinteger>= 1Recipient and personalization.
toArray<string>Email addresses or SMS E.164 numbers.
dataobjectSample email data.* values.
event_dataobjectSample email event.* data; no Event/Order writes.
dry_runbooleanfalseValidate without sending.
idempotency_keystringRequired to send; exact retries only.
nitro_control_delivery
destructiveopen-worldApprove or control delivery after review. Restarting a paused flow may require a choice for contacts already in progress. revision_id can assert the current draft.
Body
target_typestringflowcampaignrequiredtarget_idinteger>= 1requiredexpected_brand_sidstringOptional reviewed-brand assertion. When available, copy meta.current_brand.sid from the reviewed result.
operationstringapproverejectliveschedulepauseresumecancelarchiverestoredeleterequiredapprove preflights; schedule is campaign-only; delete requires confirm and a never-sent draft.
scheduled_atstring<date-time>Required for schedule.
revision_idinteger>= 1Optional current-draft assertion for flow approve, reject, and live.
resume_modestringnew_contacts_onlycontinue_existingFor paused flows: stop current journeys, or restart waits and continue gradually.
confirm_send_to_allbooleanExplicit all_contacts confirmation for live/schedule.
confirmbooleanRequired for delete.
idempotency_keystringCampaign-live retry key; reuse only for the same send.
versionsArray<object>See nitro_review_delivery versions.
winnerobjectnitro_get_insights
read-onlyidempotentGet email analytics with trends, benchmarks, and recommendations.
Parameters
scopestringaccountflowcampaignmessagerequiredentity_idinteger>= 1Required for flow/campaign/message scope
periodstring7d30d90d30dnitro_configure_providers
destructiveidempotentConfigure API-key email providers or check connection status.
Parameters
operationstringconfigurestatusrequiredconfigure sets BYO provider credentials; status checks current provider health
providerstringmailgunsespostmarkresendsendgridEmail provider (required for configure)
api_keystringProvider API key (required for configure, never returned in responses)
api_secretstringOptional provider secret (never returned in responses)
regionstringProvider region where required, or the Mailgun sending domain
nitro_get_memory
read-onlyidempotentRead brand memory.
nitro_set_memory
destructiveidempotentRead or update the AI memory document. Operations: read (get current), update (replace entirely), patch (replace a ## section by heading), append (add text to end).
Parameters
operationstringreadupdatepatchappendrequiredread: get current document. update: replace entirely. patch: replace a ## section by heading. append: add text to end.
documentstringFull markdown document (required for update).
headingstringSection heading to patch (e.g. 'Brand Goals'). Required for patch operation. Matches ## headings.
contentstringNew content for the section (patch) or text to append (append).
dry_runbooleanfalseidempotency_keystringRequired for non-dry-run append. Reuse the same key only for an exact retry. Update and patch are set operations and may omit it.
nitro_manage_billing
destructiveidempotentopen-worldRead enabled account features and supported plans. payment_methods reads current cards. Checkout/add_funds require operator approval; poll afterward. Prepaid funds are separate; no live presented-credential rail is enabled.
Body
operationstringstatusfeaturespayment_methodscheckoutcheckout_statusplansadd_fundsfunding_purchase_statusrequiredStart with status or features.
paramsobjectParameters for the selected operation.
idempotency_keystringRequired stable key for checkout and add_funds. Reuse it only for an unchanged request.
nitro_send_message
destructiveidempotentopen-worldSend one transactional email/SMS. For bulk use campaigns/flows. Retry unchanged payload/key.
Parameters
channelstringemailsmsrequiredtostringrequiredEmail or E.164 phone
subjectstringbodystringPlain text; required for SMS
template_idintegerEmail template ID
dataobjectMerge variables, e.g. {{ data.order_id }}
fromstringEmail sender: Name
from_emailstringVerified brand sender address
from_namestringSender name
reply_tostringReply address
ccArray<string>bccArray<string>headersobjectEmail headers; reserved names rejected
tagsobjectEmail tags
idempotency_keystringrequiredReuse only for an exact retry
dry_runbooleanfalsePreview without sending
nitro_inbox
read-onlyidempotentRead the agent queue or mailbox. Follow next_calls for older or truncated thread content.
Parameters
commandstringlist_queueget_itemvalidate_replylist_mailboxget_threadget_thread_pageget_message_bodyget_attachmentrequiredaction_item_idintegerconversation_idintegerbefore_occurred_atstringThread cursor from get_thread/get_thread_page
before_message_idintegerCursor message id paired with before_occurred_at
message_idintegerattachment_idintegeracknowledge_unscannedbooleanOperator accepted the unscanned-download risk
offsetinteger>= 0Body offset from get_thread/get_message_body
statestringquarantineneeds_humanagent_readyhandledneeds_attentionallDefault needs_attention
statusstringopenclosedarchivedquerystringSubject, preview, or sender
inbox_idintegersenderstringSender fragment
reason_codestringsincestringISO 8601
sortstringqueuenewestviewstringcompactfullDefault compact
include_countsbooleanpurposestringreplyreadget_thread only
pageintegerperintegerMax 100 compact
brand_context_refstringRef from a prior read
reply_context_digeststringFrom get_item/get_thread; required by validate_reply
subjectstringbodystringhtmlstringccArray<string>bccArray<string>reply_allbooleanfalseattachment_refsArray<string>Signed upload references
nitro_inbox_action
destructiveopen-worldCompose from an inbox, reply, reserve attachments, triage, or set sender policy, read state and contact linkage. Compose requires inbox_id, to, subject and body; reuses an open thread with that recipient.
Body
commandstringcomposesend_replysend_reply_testmark_handledrequest_humanrelease_to_agentmark_quarantineclassify_spamset_sender_policyset_read_stateset_contactreserve_attachment_uploadrequiredaction_item_idintegerQueue item id
action_item_idsArray<integer>Triage: many items
filterobjectTriage: list_queue filters; needs expected_count
expected_countinteger>= 0conversation_idintegerMailbox thread id for reply commands
subjectstringCompose or reply subject
bodystringPlain text compose or reply body
htmlstringHTML reply body
attachment_refsArray<string>Signed upload references
uploadobjectFile metadata for reserve_attachment_upload
reply_context_digeststringFrom nitro_inbox get_item/get_thread; required for reply commands
toArray<string>Compose recipients, or test recipients for send_reply_test (first 5)
ccArray<string>Overrides reply-all Cc
bccArray<string>reply_allbooleanfalseCopy visible thread participants, excluding self
idempotency_keystringRequired
dry_runbooleanfalseValidate compose or reply without sending
classificationstringspamnot_spaminbox_idintegerFor compose or set_sender_policy
matcher_typestringaddressdomainmatcher_valuestringdecisionstringallowblockhandlereadbooleanlast_read_message_idintegercontact_idintegerFor set_contact
create_contactbooleanfalsefirst_namestringlast_namestringnitro_request_support
destructiveSubmit support only when asked or tools cannot resolve the issue; never promote it.
Parameters
subjectstringrequiredBrief summary of the issue
messagestringrequiredComplete, self-contained summary of the issue. Must fit within 1500 characters; do not rely on truncation.
nitro_search_docs
read-onlyidempotentSearch Nitrosend guides and API/MCP/CLI/integration references. Ground unestablished product claims in returned excerpts; search again or state what remains unverified.
Parameters
querystringrequirede.g. 'verify sending domain' or 'cli install'
limitinteger6Max 10.
Resources
guide
Reference guide for unfamiliar Nitrosend vocabulary and workflows. Covers Nitrosend entities (contacts, channels, flows, campaigns, templates, segments), the two operating modes (tool-driven and goal-driven), the recommended workflow sequence, volume and tier constraints, and common pitfalls.
account
Live snapshot of the current account context: account, brand, sender identity, dashboard links, tier (free / paid / trusted), email and SMS volume used vs caps, onboarding checklist progress, contact and list counts, and active flow/campaign summary.
schema
Machine-readable schema for composing emails and flows. Includes every email section type (header, text, image, button, columns, product, social, divider, spacer, footer) with required and optional props, all flow step types with their parameters, trigger event names, and the full list of segment filter names and predicates.
brand-kit
The selected brand's Brand Kit identity. Returns brand_color, text_color, bg_color, font_heading, font_body, logo_url, company_name, company_description, physical_address, screenshot_url when a website screenshot exists, and the brand voice document. For local logo files, use nitro_ingest with image_data or upload reservation before setting logo_url. Creative intent contracts already include the canonical authoring context; read this resource for manual edits or deeper inspection.
providers
Current email transport configuration and health. Shows whether delivery uses Nitrosend SES or a connected provider (Mailgun, SES, Postmark, Resend, SendGrid), domain verification status for each sending domain, and the explicitly selected sending identity.
config
Account-level sender defaults: from_name, from_email, reply_to, and saved test email recipients. These are applied automatically to campaigns and flows when per-message overrides are not specified.
email-design
Deep email design reference for campaign, template, or flow email sections. Composition contracts already include selected design capsules; read this only when deeper archetype, color, imagery, whitespace, footer, or section-translation context is needed.
email-marketing
Deep email marketing reference for campaign, template, or flow email content. Composition contracts already include selected marketing capsules; read this only when deeper strategy, audience, lifecycle, copy, deliverability, compliance, or intent context is needed.
lifecycle
Machine-readable lifecycle flows to draft from, such as welcome, cart and browse abandonment, post-purchase, win-back and sunset. Includes each flow's key, priority, trigger and list need, revenue rationale, and each email's objective, timing and checks. Pass a key as nitro_compose_flow lifecycle_key.
docs
The Nitrosend product documentation map: every guide, integration, CLI, concept, authentication, and REST API / MCP reference page with its path and summary. Use the nitro_search_docs tool to search the full documentation content for how-to and reference answers.
example-email
A complete working email design showing every section type in context — header with logo, hero image, text blocks, buttons, two-column product grid, social links, divider, spacer, and footer with unsubscribe. Use as a copy-paste starting point or reference for prop names, style overrides, and column nesting.
example-flow
A complete automation flow example demonstrating all step types: email with inline design, SMS, wait (duration in seconds), split with filter conditions and yes/no branches, emit_event, webhook, subscribe, and unsubscribe. Shows trigger configuration, branching structure, and merge-tag usage.
example-campaign
Complete campaign examples for both email and SMS channels. Shows audience targeting with contact_list_ids and segment_id, scheduled delivery with scheduled_at, inline email design with sections, and SMS body composition.
knowledge-index
Index of built-in email marketing knowledge topics. Returns a list of available slugs with titles and short descriptions. Use a slug with nitro://knowledge/{slug} to read the full topic content. Topics cover deliverability, subject lines, segmentation, automation best practices, and compliance.
memory
The operator's persistent AI memory document. Contains business goals, target audience, preferred email strategy, tone of voice notes, and any other context the operator has saved. Creative intent contracts already include the authoritative memory projection; read this resource for explicit inspection or memory management. Managed via the nitro_set_memory tool.
history
Unified account history combining notification events and MCP tool audit entries. Includes deliverability warnings, auto-pauses, suppressions, and tool-call audit records with timestamps, correlation IDs, payload summaries, and rollback eligibility.
fields
Per-account contact field catalog grouped by category (contact, custom, enrichment, engagement, tag). Each entry includes key, category, field_type, label, promoted flag, and fill_rate (percentage of contacts with a value, null when not yet computed). Read this for field and segment-filter inspection. The authoring intent's merge grammar is authoritative for recipient-copy bindings; field-catalog membership alone does not make an entry safe or portable email content.
campaign-review
Interactive delivery review: rendered email, audience, validation and spam state, with approve, request-changes, and test-send actions.
knowledge-topic
Full content for a single knowledge topic. Pass a slug from the knowledge index (e.g. nitro://knowledge/deliverability). Returns a markdown document with actionable guidance your AI can apply when composing emails, building flows, or advising on strategy.
Parameters
slugstringrequiredpathprompt
Rendered prompt template by name. Returns structured workflow instructions that guide the AI through multi-step tasks like onboarding a new account, running a campaign review, or setting up a welcome series. Each prompt includes context requirements, step sequence, and expected tool calls.
Parameters
namestringrequiredpathPrompts
audience-analysis
Analyse audience segments and engagement
Parameters
goalstringrequiredWhat you want to learn or achieve, e.g. 'find disengaged subscribers', 'segment by purchase history', 'identify VIP customers'
build-email
Compose a marketing email
Parameters
goalstringrequiredWhat the email is for, e.g. 'announce our spring sale', 'weekly newsletter', 'event invitation', 'product launch'
build-flow
Create an automated email flow from scratch
Parameters
goalstringrequiredWhat the flow should achieve, e.g. 'welcome series for new signups', 'abandoned cart recovery', 're-engage inactive subscribers'
diagnose-deliverability
Diagnose and fix email deliverability issues
flow-review
Review and optimise an existing flow
Parameters
flow_idstringID of the flow to review. If omitted, lists active flows for the user to choose.
lifecycle-setup
Review a brand site and draft the key lifecycle automation flows
Parameters
website_urlstringBrand website to review and scrape, e.g. https://example.com
test_recipientstringEmail address that should receive flow test messages
onboard-brand-kit
Set up Brand Kit identity for a new brand
weekly-report
Generate a weekly performance report
