MCP Tools

Base URL
https://api.nitrosend.com/mcp

AI-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"
    }
  }
}
Protocol MCP 2026-07-28Transport streamable-httpCapabilities tools, resources, prompts

Tools

nitro_get_status

read-onlyidempotent
TOOLnitro_get_status

Get current account context, sender identity, dashboard links, readiness, onboarding status, and recommendations.

nitro_select_account

idempotent
TOOLnitro_select_account

Switch this OAuth MCP connection to an account listed by nitro_get_status; the next call uses it.

Parameters

account_idintegerrequired

From nitro_get_status available_accounts.items[*].id.

nitro_select_brand

idempotent
TOOLnitro_select_brand

Select the current brand for this OAuth MCP connection. Use this instead of passing brand_sid to other tools.

Parameters

brand_sidstring

Exact brand SID to select. Provide either brand_sid or name.

namestring

Brand name to select when the SID is unknown. Provide either name or brand_sid. Ambiguous names return candidates without changing context.

nitro_query

read-onlyidempotent
TOOLnitro_query

Query any Nitrosend entity. Returns paginated results.

Parameters

entitystringflowscampaignstemplatessegmentscontactslistseventsimportsmessagessuppressionshistoryproductsrequired

Contact full text: nitro_search_contacts.

filtersobject

Filters: 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.

pageinteger

Default 1.

perinteger

Max 50, default 25.

nitro_search_contacts

read-onlyidempotent
TOOLnitro_search_contacts

Search contacts by email, name, or phone. Returns summary list or full profile.

Parameters

querystringrequired
modestringsummaryprofile

summary = list, profile = single contact detail (default: summary)

pageinteger

Default 1.

perinteger

Max 50, default 25.

nitro_set_brand_kit

idempotentopen-world
TOOLnitro_set_brand_kit

Set Brand Kit from a website, fields, document, or logo URL. Fields override scraping; async is URL-only.

Body

application/json
urlstring
logo_urlstring

Public/Nitro image URL; ingest local logos first.

fieldsobject
Show child attributes
brand_colorstring

Hex color e.g. #ff0000

text_colorstring

Hex color

bg_colorstring

Hex color

font_bodystring
font_headingstring
heading_sizeinteger

Heading/title font size in pixels, 12-48

body_sizeinteger

Body text font size in pixels, 12-20

radiusinteger

Global brand corner radius in pixels, 0-64. Defaults to 8; set 0 for square corners across every eligible layer.

spacing_densitystringcompactnormalspacious

Section spacing rhythm: compact, normal, or spacious

company_namestring
physical_addressstring
company_descriptionstring
documentstring
scan_idstring
new_brandstring
dry_runbooleanfalse
modestringsyncasyncsync
idempotency_keystring

Required for URL scraping or remote logo fetch; reuse only for an exact retry.

nitro_ingest

open-world
TOOLnitro_ingest

Store 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

application/json
kindstring
image_datastring
image_urlstring
image_fileobject
Show child attributes
download_urlstring
file_idstring
mime_typestring
file_namestring
signed_idstring
descriptionstring

Truthful visible content (alt text).

uploadobject

Reserve a local-image upload; PUT bytes, then ingest its signed_id.

Show child attributes
kindstringrequired
filenamestringrequired
content_typestringrequired
byte_sizeintegerrequired
checksumstringrequired

Base64 MD5.

filenamestring
content_typestring

nitro_manage_audience

destructiveopen-world
TOOLnitro_manage_audience

Contacts, 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_tagvalidaterequired

delete_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.

paramsobjectrequired

manage_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_runbooleanfalse
confirmbooleanfalse

Required for every delete.

idempotency_keystring

Same key returns the first result.

nitro_define_segment

idempotent
TOOLnitro_define_segment

Preview or persist a filtered contact segment. preview_only defaults true; set false and provide name to save.

Body

application/json
namestring
filtersArray<any> | anyrequired

Flat AND filters or a boolean group tree of attribute/event filters.

Show child attributes
One of

Flat AND filters.

Array<any>
any
segment_idinteger
preview_onlybooleantrue
idempotency_keystring

nitro_import_contacts

TOOLnitro_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

application/json
recordsArray<object>
Show child attributes
emailstring
phonestring
first_namestring
last_namestring
country_codestring
sourcestring
dataobject

Custom contact fields.

opt_inboolean

true/false subscribes/unsubscribes new/existing channels written.

import_idinteger
signed_idstring

Uploaded CSV signed ID.

uploadobject

Reserve upload; PUT CSV; finalize signed_id.

Show child attributes
filenamestringrequired
content_typestringrequired
byte_sizeintegerrequired
checksumstringrequired

Base64 MD5.

resourcestringcontactscontacts

Inline contacts or CSV contacts.

parserstringdefault
columnsobject
optionsobject

Import options.

Show child attributes
list_idsArray<integer>
start_flowsboolean
dry_runbooleanfalse
idempotency_keystring

nitro_manage_template

destructive
TOOLnitro_manage_template

Create/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

application/json
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.

Show child attributes
idstring

Preferred stable section id.

indexinteger
typestring

Existing type to target or assert.

occurrenceinteger

0-based occurrence of type.

propsobject

Non-copy props to shallow-merge.

stylesobject

Styles to shallow-merge.

text_patchobject

Literal replacement in one string prop.

Show child attributes
propstring

String prop to edit. Required when the section type has no clear default or when editing a non-default prop.

findstring
replacestring
allbooleanfalse

Replace every occurrence; requires at least one match

subjectstring
namestring
composition_modestringintentdraftvalidategenerate

intent plans; validate checks; draft persists; generate composes and persists.

contract_idstring
brand_context_refstring
validate_onlybooleanfalse
design_mode_overridestringpremium_richpremium_minimalfounder_letterutility_plain
renegotiatebooleanfalse
user_instructionstring
creative_route_idstring

Intent-only route id.

source_textstring

Untrusted source evidence; put authoring directions in user_instruction.

factsArray<object>

Literal evidence: required values must appear; available values may be used.

Show child attributes
kindstringurlimage_urloffer_codepricedeadlineoffercta_textrequired
valuestringrequired
descriptionstring

For image_url: truthful visible content for selection and alt text.

requirementstringrequiredavailablerequired
draft_metaobject

Optional authoring provenance; never blocks.

Show child attributes
creative_route_idstring
concrete_anchorstring
why_this_earns_the_inboxstring
preheaderstring
bodystring

Author text (plain) or custom text alternative (designed).

content_formatstringdesignedplain

Match source.

plain_text_modestringderivedcustom

Text provenance.

from_namestring
from_emailstring
reply_tostring
themeobject

Brand-theme overrides; logo_url uses public or nitro_ingest media_url/image_url, never signed_id.

template_idinteger
based_oninteger
if_versioninteger

Version token for conflict-safe writes.

goalstring
dry_runbooleanfalse
idempotency_keystring

Required for non-dry-run persistence; exact retry only.

nitro_compose_flow

destructiveopen-world
TOOLnitro_compose_flow

Live/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

application/json
namestring

Flow name; required on create.

modestringcreatereplacepatchcreate

create: new; replace: whole graph; patch: name/email actions

flow_idinteger
expected_updated_atstring

Prefer expected_draft_revision_id.

expected_draft_revision_idinteger

Conflict-safe draft revision.

goalstring
lifecycle_keystring
composition_modestringintentdraftvalidategenerate

intent: plan; validate: check; draft/generate: persist.

contract_idstring
brand_context_refstring
validate_onlybooleanfalse
design_mode_overridestringpremium_richpremium_minimalfounder_letterutility_plain
renegotiatebooleanfalse
user_instructionstring
creative_route_idstring

Intent-only sequence-wide route id.

email_baseline_selectionsArray<object>

Intent-only creative_routes[].id and image binding ids per email action_name.

Show child attributes
action_namestringrequired
route_idstringrequired
image_binding_idsArray<string>
source_textstring

Untrusted source evidence; put authoring directions in user_instruction.

factsArray<object>

Literal evidence: required values must appear; available values may be used.

Show child attributes
kindstringurlimage_urloffer_codepricedeadlineoffercta_textrequired
valuestringrequired
descriptionstring

For image_url: truthful visible content for selection and alt text.

requirementstringrequiredavailablerequired
draft_metaobject

Optional authoring provenance; never blocks.

Show child attributes
creative_route_idstring
concrete_anchorstring
why_this_earns_the_inboxstring
triggerobject
Show child attributes
eventstring

Built-in or lowercase underscore event name.

exit_eventsArray<string>

Stop future steps on new matching events; pinned.

stop_on_replybooleanfalse

Requires monitored receiving.

reply_sourceobject

Match replies to an owned source.

Show child attributes
typestringanyflowcampaignmessagerequired
idinteger>= 1
action_namestring

Preserve trigger identity.

segment_idinteger
contact_list_idinteger
resource_typestring

Frozen trigger resource type.

resource_idany

Frozen trigger resource id.

dataobject

Event settings; list_add backfill_on_publish includes existing list members.

stepsArray<any>
dry_runbooleanfalse
idempotency_keystring

Required for non-dry-run persistence; exact retry only.

confirmbooleanfalse

nitro_compose_campaign

destructive
TOOLnitro_compose_campaign

Draft 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

application/json
namestring

Campaign name; required when creating.

modestringcreatepatchreplacecreate
campaign_idinteger
channelstringemailsmsemail

Immutable after creation.

goalstring
categorystringpromotionannouncementnewsletterwelcomereengagementtransactionalplain

Email job used to select a baseline.

composition_modestringintentdraftvalidategenerate

intent plans; validate checks; draft persists; generate composes and persists.

contract_idstring
brand_context_refstring
validate_onlybooleanfalse
design_mode_overridestringpremium_richpremium_minimalfounder_letterutility_plain
renegotiatebooleanfalse
user_instructionstring
creative_route_idstring

Intent-only route id.

source_textstring

Untrusted source evidence; put authoring directions in user_instruction.

factsArray<object>

Literal evidence: required values must appear; available values may be used.

Show child attributes
kindstringurlimage_urloffer_codepricedeadlineoffercta_textrequired
valuestringrequired
descriptionstring

For image_url: truthful visible content for selection and alt text.

requirementstringrequiredavailablerequired
draft_metaobject

Optional authoring provenance; never blocks.

Show child attributes
creative_route_idstring
concrete_anchorstring
why_this_earns_the_inboxstring
subjectstring
preheaderstring
from_namestring
from_emailstring
reply_tostring
bodystring
content_formatstringdesignedplain

Match source.

plain_text_modestringderivedcustom

Text 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.

themeobject

Brand-theme overrides. logo_url must be public or a nitro_ingest media_url/image_url, never raw signed_id.

template_idinteger
if_versioninteger

Version token for conflict-safe writes.

audienceobject

Target audience; all_contacts must be explicit.

Show child attributes
audience_typestringlistssegmentall_contacts
contact_list_idsArray<integer>
contact_list_idinteger

Deprecated single list id.

segment_idinteger
exclude_segment_idsArray<integer>

Suppressed segment ids; [] clears.

exclude_contact_list_idsArray<integer>

Suppressed list ids; [] clears.

scheduled_atstring<date-time>

ISO 8601 delivery time.

dry_runbooleanfalse
idempotency_keystring

Required for non-dry-run persistence; exact retry only.

confirmbooleanfalse

nitro_manage_domains

destructiveopen-world
TOOLnitro_manage_domains

Manage the brand’s Nitrosend sender and custom sending domains. Receiving MX requires forward-all.

Body

application/json
operationstringprepare_brand_subdomainselect_brand_subdomainrename_brand_subdomainaddverifylistremovelist_shared_subdomainsshare_subdomainrevoke_shared_subdomainrequired

Prepare/select a hosted sender or manage customer domains. Rename keeps old addresses receiving. Show a paired removal's effect before unpair.

paramsobject

Operation-specific parameters.

Show child attributes
domain_idinteger>= 1

The current brand's domain that owns the subdomain.

shared_domain_idinteger>= 1

Shared sending-domain claim to revoke.

target_brand_sidstring

Exact destination brand; must be in this account or an eligible managed client.

pageinteger>= 1
domain_namestring

Customer sending domain for add, verify, or remove.

author_domainstring

Optional aligned visible From domain for Nitrosend SES.

subdomainstring

Sender name; needs no Brand Kit.

expected_fqdnstring

Current brand_subdomain.fqdn, required for rename_brand_subdomain.

local_partstring

Optional From local part.

apexstring

Optional sending apex.

unpairboolean

Confirm removal of the domain's identity pair.

confirmbooleanfalse

Required for removal, renaming and subdomain-sharing changes.

nitro_configure_account

idempotent
TOOLnitro_configure_account

Read 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_namestring

Sender display name (e.g. 'Acme Marketing')

from_emailstring

Exact visible From address to select. May use the apex when a ready aligned sending subdomain authorizes it.

reply_tostring
test_email_recipientsArray<string>

Saved test-send addresses; [] clears.

nitro_review_delivery

read-onlyidempotent
TOOLnitro_review_delivery

Read-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_typestringtemplateflowcampaign
target_idinteger>= 1
revision_idinteger>= 1

Optional for flows. Omit to review the current draft, or supply its ID as a current-draft assertion.

contact_idinteger>= 1

Merge-tag personalization contact.

subjectstring

Inline email review subject.

htmlstring

Inline email review HTML.

nitro_send_test_message

destructiveidempotentopen-world
TOOLnitro_send_test_message

Send 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_typestringtemplateflowcampaign

With target_id, or use template_id/latest_campaign.

target_idinteger>= 1
latest_campaignbooleanfalse

Latest campaign in this brand.

template_idinteger>= 1

Template id; may select a flow/campaign email.

action_idinteger>= 1

Select a flow message step.

revision_idinteger>= 1

Exact revision; required for flows.

channelstringautoemailsmsauto

Prefer auto.

contact_idinteger>= 1

Recipient and personalization.

toArray<string>

Email addresses or SMS E.164 numbers.

dataobject

Sample email data.* values.

event_dataobject

Sample email event.* data; no Event/Order writes.

dry_runbooleanfalse

Validate without sending.

idempotency_keystring

Required to send; exact retries only.

nitro_control_delivery

destructiveopen-world
TOOLnitro_control_delivery

Approve 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

application/json
target_typestringflowcampaignrequired
target_idinteger>= 1required
expected_brand_sidstring

Optional reviewed-brand assertion. When available, copy meta.current_brand.sid from the reviewed result.

operationstringapproverejectliveschedulepauseresumecancelarchiverestoredeleterequired

approve preflights; schedule is campaign-only; delete requires confirm and a never-sent draft.

scheduled_atstring<date-time>

Required for schedule.

revision_idinteger>= 1

Optional current-draft assertion for flow approve, reject, and live.

resume_modestringnew_contacts_onlycontinue_existing

For paused flows: stop current journeys, or restart waits and continue gradually.

confirm_send_to_allboolean

Explicit all_contacts confirmation for live/schedule.

confirmboolean

Required for delete.

idempotency_keystring

Campaign-live retry key; reuse only for the same send.

versionsArray<object>

See nitro_review_delivery versions.

winnerobject

nitro_get_insights

read-onlyidempotent
TOOLnitro_get_insights

Get email analytics with trends, benchmarks, and recommendations.

Parameters

scopestringaccountflowcampaignmessagerequired
entity_idinteger>= 1

Required for flow/campaign/message scope

periodstring7d30d90d30d

nitro_configure_providers

destructiveidempotent
TOOLnitro_configure_providers

Configure API-key email providers or check connection status.

Parameters

operationstringconfigurestatusrequired

configure sets BYO provider credentials; status checks current provider health

providerstringmailgunsespostmarkresendsendgrid

Email provider (required for configure)

api_keystring

Provider API key (required for configure, never returned in responses)

api_secretstring

Optional provider secret (never returned in responses)

regionstring

Provider region where required, or the Mailgun sending domain

nitro_get_memory

read-onlyidempotent
TOOLnitro_get_memory

Read brand memory.

nitro_set_memory

destructiveidempotent
TOOLnitro_set_memory

Read 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

operationstringreadupdatepatchappendrequired

read: get current document. update: replace entirely. patch: replace a ## section by heading. append: add text to end.

documentstring

Full markdown document (required for update).

headingstring

Section heading to patch (e.g. 'Brand Goals'). Required for patch operation. Matches ## headings.

contentstring

New content for the section (patch) or text to append (append).

dry_runbooleanfalse
idempotency_keystring

Required 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-world
TOOLnitro_manage_billing

Read 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

application/json
operationstringstatusfeaturespayment_methodscheckoutcheckout_statusplansadd_fundsfunding_purchase_statusrequired

Start with status or features.

paramsobject

Parameters for the selected operation.

Show child attributes
plan_idinteger

Plan ID (required for checkout)

quantityinteger[1, 10000]

Number of units for a quantity-based offer, as returned by features. Other offers require one.

product_keystringbase_plan

Subscription product returned by features; omit for the base plan.

confirmboolean

Set true only after operator confirmation when checkout reports confirmation_required

amount_centsinteger

Integer amount in minor currency units

currencystring

Three-letter funding currency

instrumentstringstripe_checkoutshopify_one_time

Optional add-funds instrument; omit to use the account default

purchase_idinteger

Local purchase ID returned by checkout or add_funds, interpreted by operation

idempotency_keystring

Required stable key for checkout and add_funds. Reuse it only for an unchanged request.

nitro_send_message

destructiveidempotentopen-world
TOOLnitro_send_message

Send one transactional email/SMS. For bulk use campaigns/flows. Retry unchanged payload/key.

Parameters

channelstringemailsmsrequired
tostringrequired

Email or E.164 phone

subjectstring
bodystring

Plain text; required for SMS

template_idinteger

Email template ID

dataobject

Merge variables, e.g. {{ data.order_id }}

fromstring

Email sender: Name

from_emailstring

Verified brand sender address

from_namestring

Sender name

reply_tostring

Reply address

ccArray<string>
bccArray<string>
headersobject

Email headers; reserved names rejected

tagsobject

Email tags

idempotency_keystringrequired

Reuse only for an exact retry

dry_runbooleanfalse

Preview without sending

nitro_inbox

read-onlyidempotent
TOOLnitro_inbox

Read 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_attachmentrequired
action_item_idinteger
conversation_idinteger
before_occurred_atstring

Thread cursor from get_thread/get_thread_page

before_message_idinteger

Cursor message id paired with before_occurred_at

message_idinteger
attachment_idinteger
acknowledge_unscannedboolean

Operator accepted the unscanned-download risk

offsetinteger>= 0

Body offset from get_thread/get_message_body

statestringquarantineneeds_humanagent_readyhandledneeds_attentionall

Default needs_attention

statusstringopenclosedarchived
querystring

Subject, preview, or sender

inbox_idinteger
senderstring

Sender fragment

reason_codestring
sincestring

ISO 8601

sortstringqueuenewest
viewstringcompactfull

Default compact

include_countsboolean
purposestringreplyread

get_thread only

pageinteger
perinteger

Max 100 compact

brand_context_refstring

Ref from a prior read

reply_context_digeststring

From get_item/get_thread; required by validate_reply

subjectstring
bodystring
htmlstring
ccArray<string>
bccArray<string>
reply_allbooleanfalse
attachment_refsArray<string>

Signed upload references

nitro_inbox_action

destructiveopen-world
TOOLnitro_inbox_action

Compose 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

application/json
commandstringcomposesend_replysend_reply_testmark_handledrequest_humanrelease_to_agentmark_quarantineclassify_spamset_sender_policyset_read_stateset_contactreserve_attachment_uploadrequired
action_item_idinteger

Queue item id

action_item_idsArray<integer>

Triage: many items

filterobject

Triage: list_queue filters; needs expected_count

expected_countinteger>= 0
conversation_idinteger

Mailbox thread id for reply commands

subjectstring

Compose or reply subject

bodystring

Plain text compose or reply body

htmlstring

HTML reply body

attachment_refsArray<string>

Signed upload references

uploadobject

File metadata for reserve_attachment_upload

Show child attributes
filenamestringrequired
content_typestringrequired
byte_sizeinteger[1, 6291456]required
checksumstringrequired

Base64 MD5

reply_context_digeststring

From 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_allbooleanfalse

Copy visible thread participants, excluding self

idempotency_keystring

Required

dry_runbooleanfalse

Validate compose or reply without sending

classificationstringspamnot_spam
inbox_idinteger

For compose or set_sender_policy

matcher_typestringaddressdomain
matcher_valuestring
decisionstringallowblockhandle
readboolean
last_read_message_idinteger
contact_idinteger

For set_contact

create_contactbooleanfalse
first_namestring
last_namestring

nitro_request_support

destructive
TOOLnitro_request_support

Submit support only when asked or tools cannot resolve the issue; never promote it.

Parameters

subjectstringrequired

Brief summary of the issue

messagestringrequired

Complete, self-contained summary of the issue. Must fit within 1500 characters; do not rely on truncation.

nitro_search_docs

read-onlyidempotent
TOOLnitro_search_docs

Search Nitrosend guides and API/MCP/CLI/integration references. Ground unestablished product claims in returned excerpts; search again or state what remains unverified.

Parameters

querystringrequired

e.g. 'verify sending domain' or 'cli install'

limitinteger6

Max 10.

Resources

guide

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEnitro://examples/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

RESOURCEnitro://examples/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

RESOURCEnitro://examples/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

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEnitro://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

RESOURCEui://nitrosend/campaign-review/v2.2.0.html

Interactive delivery review: rendered email, audience, validation and spam state, with approve, request-changes, and test-send actions.

authoring-context

RESOURCEnitro://authoring-context/{ref}{?cursor}

Lossless paged read of the exact canonical brand authoring packet named by a composition contract. Start at its supplied ref URI, follow each exact next_uri, concatenate chunk.text in offset order, and verify packet_digest before filling that contract's draft call. A stale ref never returns current content under the old address.

Parameters

refstringrequiredpath
?cursorstringrequiredpath

knowledge-topic

RESOURCEnitro://knowledge/{slug}

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

slugstringrequiredpath

prompt

RESOURCEnitro://prompts/{name}

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

namestringrequiredpath

Prompts

audience-analysis

PROMPTaudience-analysis

Analyse audience segments and engagement

Parameters

goalstringrequired

What you want to learn or achieve, e.g. 'find disengaged subscribers', 'segment by purchase history', 'identify VIP customers'

build-email

PROMPTbuild-email

Compose a marketing email

Parameters

goalstringrequired

What the email is for, e.g. 'announce our spring sale', 'weekly newsletter', 'event invitation', 'product launch'

build-flow

PROMPTbuild-flow

Create an automated email flow from scratch

Parameters

goalstringrequired

What the flow should achieve, e.g. 'welcome series for new signups', 'abandoned cart recovery', 're-engage inactive subscribers'

diagnose-deliverability

PROMPTdiagnose-deliverability

Diagnose and fix email deliverability issues

flow-review

PROMPTflow-review

Review and optimise an existing flow

Parameters

flow_idstring

ID of the flow to review. If omitted, lists active flows for the user to choose.

lifecycle-setup

PROMPTlifecycle-setup

Review a brand site and draft the key lifecycle automation flows

Parameters

website_urlstring

Brand website to review and scrape, e.g. https://example.com

test_recipientstring

Email address that should receive flow test messages

onboard-brand-kit

PROMPTonboard-brand-kit

Set up Brand Kit identity for a new brand

weekly-report

PROMPTweekly-report

Generate a weekly performance report