# nitro

AI-native email marketing platform for campaigns, lifecycle flows, and transactional email

Version: 1.7.0

## nitro_get_status

`TOOL nitro_get_status`

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

Authentication: no security requirement declared for this operation.

Declared MCP annotations:

```json
{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_get_status",
    "arguments": {}
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_get_status",
  "arguments": {}
});
```

### Python

```python
result = await session.call_tool("nitro_get_status", arguments={})
```


## nitro_select_account

`TOOL nitro_select_account`

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

Authentication: no security requirement declared for this operation.

Parameters:

- `account_id` (argument, integer, required) - From nitro_get_status available_accounts.items[*].id.
  Type: integer
  
  From nitro_get_status available_accounts.items[*].id.

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_select_account",
    "arguments": {
        "account_id": 0
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_select_account",
  "arguments": {
    "account_id": 0
  }
});
```

### Python

```python
result = await session.call_tool("nitro_select_account", arguments={
  "account_id": 0
})
```


## nitro_select_brand

`TOOL nitro_select_brand`

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

Authentication: no security requirement declared for this operation.

Parameters:

- `brand_sid` (argument, string, optional) - Exact brand SID to select. Provide either brand_sid or name.
  Type: string
  
  Exact brand SID to select. Provide either brand_sid or name.

- `name` (argument, string, optional) - Brand name to select when the SID is unknown. Provide either name or brand_sid. Ambiguous names return candidates without changing context.
  Type: string
  
  Brand name to select when the SID is unknown. Provide either name or brand_sid. Ambiguous names return candidates without changing context.

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_select_brand",
    "arguments": {
        "brand_sid": "string",
        "name": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_select_brand",
  "arguments": {
    "brand_sid": "string",
    "name": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_select_brand", arguments={
  "brand_sid": "string",
  "name": "string"
})
```


## nitro_query

`TOOL nitro_query`

Query any Nitrosend entity. Returns paginated results.

Authentication: no security requirement declared for this operation.

Parameters:

- `entity` (argument, string, required) - Contact full text: nitro_search_contacts.
  Type: string
  
  Contact full text: nitro_search_contacts.
  
  enum: ["flows","campaigns","templates","segments","contacts","lists","events","imports","messages","suppressions","history","products"]

- `filters` (argument, object, optional) - 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.
  Type: object
  
  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.

- `page` (argument, integer, optional) - Default 1.
  Type: integer
  
  Default 1.

- `per` (argument, integer, optional) - Max 50, default 25.
  Type: integer
  
  Max 50, default 25.

Declared MCP annotations:

```json
{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_query",
    "arguments": {
        "entity": "flows",
        "filters": {},
        "page": 0,
        "per": 0
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_query",
  "arguments": {
    "entity": "flows",
    "filters": {},
    "page": 0,
    "per": 0
  }
});
```

### Python

```python
result = await session.call_tool("nitro_query", arguments={
  "entity": "flows",
  "filters": {},
  "page": 0,
  "per": 0
})
```


## nitro_search_contacts

`TOOL nitro_search_contacts`

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

Authentication: no security requirement declared for this operation.

Parameters:

- `query` (argument, string, required)
  Type: string

- `mode` (argument, string, optional) - summary = list, profile = single contact detail (default: summary)
  Type: string
  
  summary = list, profile = single contact detail (default: summary)
  
  enum: ["summary","profile"]

- `page` (argument, integer, optional) - Default 1.
  Type: integer
  
  Default 1.

- `per` (argument, integer, optional) - Max 50, default 25.
  Type: integer
  
  Max 50, default 25.

Declared MCP annotations:

```json
{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_search_contacts",
    "arguments": {
        "query": "string",
        "mode": "summary",
        "page": 0,
        "per": 0
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_search_contacts",
  "arguments": {
    "query": "string",
    "mode": "summary",
    "page": 0,
    "per": 0
  }
});
```

### Python

```python
result = await session.call_tool("nitro_search_contacts", arguments={
  "query": "string",
  "mode": "summary",
  "page": 0,
  "per": 0
})
```


## nitro_set_brand_kit

`TOOL nitro_set_brand_kit`

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

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `url` (optional)
  Type: string

- `logo_url` (optional)
  Type: string
  
  Public/Nitro image URL; ingest local logos first.

- `fields` (optional)
  Type: object
  
  - `brand_color` (optional)
    Type: string
    
    Hex color e.g. #ff0000
  
  - `text_color` (optional)
    Type: string
    
    Hex color
  
  - `bg_color` (optional)
    Type: string
    
    Hex color
  
  - `font_body` (optional)
    Type: string
  
  - `font_heading` (optional)
    Type: string
  
  - `heading_size` (optional)
    Type: integer
    
    Heading/title font size in pixels, 12-48
  
  - `body_size` (optional)
    Type: integer
    
    Body text font size in pixels, 12-20
  
  - `radius` (optional)
    Type: integer
    
    Global brand corner radius in pixels, 0-64. Defaults to 8; set 0 for square corners across every eligible layer.
  
  - `spacing_density` (optional)
    Type: string
    
    Section spacing rhythm: compact, normal, or spacious
    
    enum: ["compact","normal","spacious"]
  
  - `company_name` (optional)
    Type: string
  
  - `physical_address` (optional)
    Type: string
  
  - `company_description` (optional)
    Type: string

- `document` (optional)
  Type: string

- `scan_id` (optional)
  Type: string

- `new_brand` (optional)
  Type: string

- `dry_run` (optional)
  Type: boolean
  
  default: false

- `mode` (optional)
  Type: string
  
  default: "sync"
  
  enum: ["sync","async"]

- `idempotency_key` (optional)
  Type: string
  
  Required for URL scraping or remote logo fetch; reuse only for an exact retry.
  
  maxLength: 128

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_set_brand_kit",
    "arguments": {
        "url": "string",
        "logo_url": "string",
        "fields": {
          "brand_color": "string",
          "text_color": "string",
          "bg_color": "string",
          "font_body": "string",
          "font_heading": "string",
          "heading_size": 0,
          "body_size": 0,
          "radius": 0,
          "spacing_density": "compact",
          "company_name": "string",
          "physical_address": "string",
          "company_description": "string"
        },
        "document": "string",
        "scan_id": "string",
        "new_brand": "string",
        "dry_run": false,
        "mode": "sync",
        "idempotency_key": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_set_brand_kit",
  "arguments": {
    "url": "string",
    "logo_url": "string",
    "fields": {
      "brand_color": "string",
      "text_color": "string",
      "bg_color": "string",
      "font_body": "string",
      "font_heading": "string",
      "heading_size": 0,
      "body_size": 0,
      "radius": 0,
      "spacing_density": "compact",
      "company_name": "string",
      "physical_address": "string",
      "company_description": "string"
    },
    "document": "string",
    "scan_id": "string",
    "new_brand": "string",
    "dry_run": false,
    "mode": "sync",
    "idempotency_key": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_set_brand_kit", arguments={
  "url": "string",
  "logo_url": "string",
  "fields": {
    "brand_color": "string",
    "text_color": "string",
    "bg_color": "string",
    "font_body": "string",
    "font_heading": "string",
    "heading_size": 0,
    "body_size": 0,
    "radius": 0,
    "spacing_density": "compact",
    "company_name": "string",
    "physical_address": "string",
    "company_description": "string"
  },
  "document": "string",
  "scan_id": "string",
  "new_brand": "string",
  "dry_run": false,
  "mode": "sync",
  "idempotency_key": "string"
})
```


## nitro_ingest

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `kind` (optional)
  Type: string

- `image_data` (optional)
  Type: string

- `image_url` (optional)
  Type: string

- `image_file` (optional)
  Type: object
  
  - `download_url` (optional)
    Type: string
  
  - `file_id` (optional)
    Type: string
  
  - `mime_type` (optional)
    Type: string
  
  - `file_name` (optional)
    Type: string

- `signed_id` (optional)
  Type: string

- `description` (optional)
  Type: string
  
  Truthful visible content (alt text).

- `upload` (optional)
  Type: object
  
  Reserve a local-image upload; PUT bytes, then ingest its signed_id.
  
  - `kind` (required)
    Type: string
  
  - `filename` (required)
    Type: string
  
  - `content_type` (required)
    Type: string
  
  - `byte_size` (required)
    Type: integer
  
  - `checksum` (required)
    Type: string
    
    Base64 MD5.
  
  Additional properties: false

- `filename` (optional)
  Type: string

- `content_type` (optional)
  Type: string

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": true
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_ingest",
    "arguments": {
        "kind": "string",
        "image_data": "string",
        "image_url": "string",
        "image_file": {
          "download_url": "string",
          "file_id": "string",
          "mime_type": "string",
          "file_name": "string"
        },
        "signed_id": "string",
        "description": "string",
        "upload": {
          "kind": "string",
          "filename": "string",
          "content_type": "string",
          "byte_size": 0,
          "checksum": "string"
        },
        "filename": "string",
        "content_type": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_ingest",
  "arguments": {
    "kind": "string",
    "image_data": "string",
    "image_url": "string",
    "image_file": {
      "download_url": "string",
      "file_id": "string",
      "mime_type": "string",
      "file_name": "string"
    },
    "signed_id": "string",
    "description": "string",
    "upload": {
      "kind": "string",
      "filename": "string",
      "content_type": "string",
      "byte_size": 0,
      "checksum": "string"
    },
    "filename": "string",
    "content_type": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_ingest", arguments={
  "kind": "string",
  "image_data": "string",
  "image_url": "string",
  "image_file": {
    "download_url": "string",
    "file_id": "string",
    "mime_type": "string",
    "file_name": "string"
  },
  "signed_id": "string",
  "description": "string",
  "upload": {
    "kind": "string",
    "filename": "string",
    "content_type": "string",
    "byte_size": 0,
    "checksum": "string"
  },
  "filename": "string",
  "content_type": "string"
})
```


## nitro_manage_audience

`TOOL nitro_manage_audience`

Contacts, subscriptions, lists, events, segments, tags and prepaid email validation. Custom fields: attributes.data. Bulk adds and unsubscribes: nitro_import_contacts.

Authentication: no security requirement declared for this operation.

Parameters:

- `operation` (argument, string, required) - 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.
  Type: string
  
  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.
  
  enum: ["create_contact","update_contact","set_subscription","manage_list","record_event","delete_segment","delete_contacts","bulk_tag","validate"]

- `params` (argument, object, required) - 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.
  Type: object
  
  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_run` (argument, boolean, optional)
  Type: boolean
  
  default: false

- `confirm` (argument, boolean, optional) - Required for every delete.
  Type: boolean
  
  Required for every delete.
  
  default: false

- `idempotency_key` (argument, string, optional) - Same key returns the first result.
  Type: string
  
  Same key returns the first result.

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_manage_audience",
    "arguments": {
        "operation": "create_contact",
        "params": {},
        "dry_run": false,
        "confirm": false,
        "idempotency_key": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_manage_audience",
  "arguments": {
    "operation": "create_contact",
    "params": {},
    "dry_run": false,
    "confirm": false,
    "idempotency_key": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_manage_audience", arguments={
  "operation": "create_contact",
  "params": {},
  "dry_run": false,
  "confirm": false,
  "idempotency_key": "string"
})
```


## nitro_define_segment

`TOOL nitro_define_segment`

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

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `name` (optional)
  Type: string

- `filters` (required)
  Type: unknown
  
  Flat AND filters or a boolean group tree of attribute/event filters.
  
  oneOf:
    Type: array
    
    Flat AND filters.
    
    Items:
      Type: unknown
  
    Type: unknown

- `segment_id` (optional)
  Type: integer

- `preview_only` (optional)
  Type: boolean
  
  default: true

- `idempotency_key` (optional)
  Type: string

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_define_segment",
    "arguments": {
        "name": "string",
        "filters": [],
        "segment_id": 0,
        "preview_only": true,
        "idempotency_key": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_define_segment",
  "arguments": {
    "name": "string",
    "filters": [],
    "segment_id": 0,
    "preview_only": true,
    "idempotency_key": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_define_segment", arguments={
  "name": "string",
  "filters": [],
  "segment_id": 0,
  "preview_only": true,
  "idempotency_key": "string"
})
```


## nitro_import_contacts

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `records` (optional)
  Type: array
  
  Items:
    Type: object
    
    - `email` (optional)
      Type: string
    
    - `phone` (optional)
      Type: string
    
    - `first_name` (optional)
      Type: string
    
    - `last_name` (optional)
      Type: string
    
    - `country_code` (optional)
      Type: string
    
    - `source` (optional)
      Type: string
    
    - `data` (optional)
      Type: object
      
      Custom contact fields.
      
      Additional properties: true
    
    - `opt_in` (optional)
      Type: boolean
      
      true/false subscribes/unsubscribes new/existing channels written.

- `import_id` (optional)
  Type: integer

- `signed_id` (optional)
  Type: string
  
  Uploaded CSV signed ID.

- `upload` (optional)
  Type: object
  
  Reserve upload; PUT CSV; finalize signed_id.
  
  - `filename` (required)
    Type: string
  
  - `content_type` (required)
    Type: string
  
  - `byte_size` (required)
    Type: integer
  
  - `checksum` (required)
    Type: string
    
    Base64 MD5.
  
  Additional properties: false

- `resource` (optional)
  Type: string
  
  Inline contacts or CSV contacts.
  
  default: "contacts"
  
  enum: ["contacts"]

- `parser` (optional)
  Type: string
  
  default: "default"

- `columns` (optional)
  Type: object

- `options` (optional)
  Type: object
  
  Import options.
  
  - `list_ids` (optional)
    Type: array
    
    Items:
      Type: integer
  
  - `start_flows` (optional)
    Type: boolean

- `dry_run` (optional)
  Type: boolean
  
  default: false

- `idempotency_key` (optional)
  Type: string

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": false,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_import_contacts",
    "arguments": {
        "records": [
          {
            "email": "string",
            "phone": "string",
            "first_name": "string",
            "last_name": "string",
            "country_code": "string",
            "source": "string",
            "data": {},
            "opt_in": true
          }
        ],
        "import_id": 0,
        "signed_id": "string",
        "upload": {
          "filename": "string",
          "content_type": "string",
          "byte_size": 0,
          "checksum": "string"
        },
        "resource": "contacts",
        "parser": "default",
        "columns": {},
        "options": {
          "list_ids": [
            0
          ],
          "start_flows": true
        },
        "dry_run": false,
        "idempotency_key": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_import_contacts",
  "arguments": {
    "records": [
      {
        "email": "string",
        "phone": "string",
        "first_name": "string",
        "last_name": "string",
        "country_code": "string",
        "source": "string",
        "data": {},
        "opt_in": true
      }
    ],
    "import_id": 0,
    "signed_id": "string",
    "upload": {
      "filename": "string",
      "content_type": "string",
      "byte_size": 0,
      "checksum": "string"
    },
    "resource": "contacts",
    "parser": "default",
    "columns": {},
    "options": {
      "list_ids": [
        0
      ],
      "start_flows": true
    },
    "dry_run": false,
    "idempotency_key": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_import_contacts", arguments={
  "records": [
    {
      "email": "string",
      "phone": "string",
      "first_name": "string",
      "last_name": "string",
      "country_code": "string",
      "source": "string",
      "data": {},
      "opt_in": true
    }
  ],
  "import_id": 0,
  "signed_id": "string",
  "upload": {
    "filename": "string",
    "content_type": "string",
    "byte_size": 0,
    "checksum": "string"
  },
  "resource": "contacts",
  "parser": "default",
  "columns": {},
  "options": {
    "list_ids": [
      0
    ],
    "start_flows": true
  },
  "dry_run": false,
  "idempotency_key": "string"
})
```


## nitro_manage_template

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `sections` (optional)
  Type: array
  
  Email sections; use nitro://schema only for full authoring. Images use public or nitro_ingest media_url/image_url, never signed_id.
  
  Items:
    Type: object

- `section_updates` (optional)
  Type: array
  
  Targeted section edits; never changes order or type.
  
  Items:
    Type: object
    
    - `id` (optional)
      Type: string
      
      Preferred stable section id.
    
    - `index` (optional)
      Type: integer
    
    - `type` (optional)
      Type: string
      
      Existing type to target or assert.
    
    - `occurrence` (optional)
      Type: integer
      
      0-based occurrence of type.
    
    - `props` (optional)
      Type: object
      
      Non-copy props to shallow-merge.
    
    - `styles` (optional)
      Type: object
      
      Styles to shallow-merge.
    
    - `text_patch` (optional)
      Type: object
      
      Literal replacement in one string prop.
      
      - `prop` (optional)
        Type: string
        
        String prop to edit. Required when the section type has no clear default or when editing a non-default prop.
      
      - `find` (optional)
        Type: string
      
      - `replace` (optional)
        Type: string
      
      - `all` (optional)
        Type: boolean
        
        Replace every occurrence; requires at least one match
        
        default: false
      
      Additional properties: false
    
    Additional properties: false

- `subject` (optional)
  Type: string

- `name` (optional)
  Type: string

- `composition_mode` (optional)
  Type: string
  
  intent plans; validate checks; draft persists; generate composes and persists.
  
  enum: ["intent","draft","validate","generate"]

- `contract_id` (optional)
  Type: string

- `brand_context_ref` (optional)
  Type: string

- `validate_only` (optional)
  Type: boolean
  
  default: false

- `design_mode_override` (optional)
  Type: string
  
  enum: ["premium_rich","premium_minimal","founder_letter","utility_plain"]

- `renegotiate` (optional)
  Type: boolean
  
  default: false

- `user_instruction` (optional)
  Type: string

- `creative_route_id` (optional)
  Type: string
  
  Intent-only route id.

- `source_text` (optional)
  Type: string
  
  Untrusted source evidence; put authoring directions in user_instruction.

- `facts` (optional)
  Type: array
  
  Literal evidence: required values must appear; available values may be used.
  
  Items:
    Type: object
    
    - `kind` (required)
      Type: string
      
      enum: ["url","image_url","offer_code","price","deadline","offer","cta_text"]
    
    - `value` (required)
      Type: string
    
    - `description` (optional)
      Type: string
      
      For image_url: truthful visible content for selection and alt text.
    
    - `requirement` (required)
      Type: string
      
      enum: ["required","available"]
    
    Additional properties: false

- `draft_meta` (optional)
  Type: object
  
  Optional authoring provenance; never blocks.
  
  - `creative_route_id` (optional)
    Type: string
  
  - `concrete_anchor` (optional)
    Type: string
  
  - `why_this_earns_the_inbox` (optional)
    Type: string

- `preheader` (optional)
  Type: string

- `body` (optional)
  Type: string
  
  Author text (plain) or custom text alternative (designed).

- `content_format` (optional)
  Type: string
  
  Match source.
  
  enum: ["designed","plain"]

- `plain_text_mode` (optional)
  Type: string
  
  Text provenance.
  
  enum: ["derived","custom"]

- `from_name` (optional)
  Type: string

- `from_email` (optional)
  Type: string

- `reply_to` (optional)
  Type: string

- `theme` (optional)
  Type: object
  
  Brand-theme overrides; logo_url uses public or nitro_ingest media_url/image_url, never signed_id.

- `template_id` (optional)
  Type: integer

- `based_on` (optional)
  Type: integer

- `if_version` (optional)
  Type: integer
  
  Version token for conflict-safe writes.

- `goal` (optional)
  Type: string

- `dry_run` (optional)
  Type: boolean
  
  default: false

- `idempotency_key` (optional)
  Type: string
  
  Required for non-dry-run persistence; exact retry only.
  
  maxLength: 128

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_manage_template",
    "arguments": {
        "sections": [
          {}
        ],
        "section_updates": [
          {
            "id": "string",
            "index": 0,
            "type": "string",
            "occurrence": 0,
            "props": {},
            "styles": {},
            "text_patch": {
              "prop": "string",
              "find": "string",
              "replace": "string",
              "all": false
            }
          }
        ],
        "subject": "string",
        "name": "string",
        "composition_mode": "intent",
        "contract_id": "string",
        "brand_context_ref": "string",
        "validate_only": false,
        "design_mode_override": "premium_rich",
        "renegotiate": false,
        "user_instruction": "string",
        "creative_route_id": "string",
        "source_text": "string",
        "facts": [
          {
            "kind": "url",
            "value": "string",
            "description": "string",
            "requirement": "required"
          }
        ],
        "draft_meta": {
          "creative_route_id": "string",
          "concrete_anchor": "string",
          "why_this_earns_the_inbox": "string"
        },
        "preheader": "string",
        "body": "string",
        "content_format": "designed",
        "plain_text_mode": "derived",
        "from_name": "string",
        "from_email": "string",
        "reply_to": "string",
        "theme": {},
        "template_id": 0,
        "based_on": 0,
        "if_version": 0,
        "goal": "string",
        "dry_run": false,
        "idempotency_key": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_manage_template",
  "arguments": {
    "sections": [
      {}
    ],
    "section_updates": [
      {
        "id": "string",
        "index": 0,
        "type": "string",
        "occurrence": 0,
        "props": {},
        "styles": {},
        "text_patch": {
          "prop": "string",
          "find": "string",
          "replace": "string",
          "all": false
        }
      }
    ],
    "subject": "string",
    "name": "string",
    "composition_mode": "intent",
    "contract_id": "string",
    "brand_context_ref": "string",
    "validate_only": false,
    "design_mode_override": "premium_rich",
    "renegotiate": false,
    "user_instruction": "string",
    "creative_route_id": "string",
    "source_text": "string",
    "facts": [
      {
        "kind": "url",
        "value": "string",
        "description": "string",
        "requirement": "required"
      }
    ],
    "draft_meta": {
      "creative_route_id": "string",
      "concrete_anchor": "string",
      "why_this_earns_the_inbox": "string"
    },
    "preheader": "string",
    "body": "string",
    "content_format": "designed",
    "plain_text_mode": "derived",
    "from_name": "string",
    "from_email": "string",
    "reply_to": "string",
    "theme": {},
    "template_id": 0,
    "based_on": 0,
    "if_version": 0,
    "goal": "string",
    "dry_run": false,
    "idempotency_key": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_manage_template", arguments={
  "sections": [
    {}
  ],
  "section_updates": [
    {
      "id": "string",
      "index": 0,
      "type": "string",
      "occurrence": 0,
      "props": {},
      "styles": {},
      "text_patch": {
        "prop": "string",
        "find": "string",
        "replace": "string",
        "all": false
      }
    }
  ],
  "subject": "string",
  "name": "string",
  "composition_mode": "intent",
  "contract_id": "string",
  "brand_context_ref": "string",
  "validate_only": false,
  "design_mode_override": "premium_rich",
  "renegotiate": false,
  "user_instruction": "string",
  "creative_route_id": "string",
  "source_text": "string",
  "facts": [
    {
      "kind": "url",
      "value": "string",
      "description": "string",
      "requirement": "required"
    }
  ],
  "draft_meta": {
    "creative_route_id": "string",
    "concrete_anchor": "string",
    "why_this_earns_the_inbox": "string"
  },
  "preheader": "string",
  "body": "string",
  "content_format": "designed",
  "plain_text_mode": "derived",
  "from_name": "string",
  "from_email": "string",
  "reply_to": "string",
  "theme": {},
  "template_id": 0,
  "based_on": 0,
  "if_version": 0,
  "goal": "string",
  "dry_run": false,
  "idempotency_key": "string"
})
```


## nitro_compose_flow

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `name` (optional)
  Type: string
  
  Flow name; required on create.

- `mode` (optional)
  Type: string
  
  create: new; replace: whole graph; patch: name/email actions
  
  default: "create"
  
  enum: ["create","replace","patch"]

- `flow_id` (optional)
  Type: integer

- `expected_updated_at` (optional)
  Type: string
  
  Prefer expected_draft_revision_id.

- `expected_draft_revision_id` (optional)
  Type: integer
  
  Conflict-safe draft revision.

- `goal` (optional)
  Type: string

- `lifecycle_key` (optional)
  Type: string

- `composition_mode` (optional)
  Type: string
  
  intent: plan; validate: check; draft/generate: persist.
  
  enum: ["intent","draft","validate","generate"]

- `contract_id` (optional)
  Type: string

- `brand_context_ref` (optional)
  Type: string

- `validate_only` (optional)
  Type: boolean
  
  default: false

- `design_mode_override` (optional)
  Type: string
  
  enum: ["premium_rich","premium_minimal","founder_letter","utility_plain"]

- `renegotiate` (optional)
  Type: boolean
  
  default: false

- `user_instruction` (optional)
  Type: string

- `creative_route_id` (optional)
  Type: string
  
  Intent-only sequence-wide route id.

- `email_baseline_selections` (optional)
  Type: array
  
  Intent-only creative_routes[].id and image binding ids per email action_name.
  
  Items:
    Type: object
    
    - `action_name` (required)
      Type: string
    
    - `route_id` (required)
      Type: string
    
    - `image_binding_ids` (optional)
      Type: array
      
      uniqueItems: true
      
      Items:
        Type: string
    
    Additional properties: false

- `source_text` (optional)
  Type: string
  
  Untrusted source evidence; put authoring directions in user_instruction.

- `facts` (optional)
  Type: array
  
  Literal evidence: required values must appear; available values may be used.
  
  Items:
    Type: object
    
    - `kind` (required)
      Type: string
      
      enum: ["url","image_url","offer_code","price","deadline","offer","cta_text"]
    
    - `value` (required)
      Type: string
    
    - `description` (optional)
      Type: string
      
      For image_url: truthful visible content for selection and alt text.
    
    - `requirement` (required)
      Type: string
      
      enum: ["required","available"]
    
    Additional properties: false

- `draft_meta` (optional)
  Type: object
  
  Optional authoring provenance; never blocks.
  
  - `creative_route_id` (optional)
    Type: string
  
  - `concrete_anchor` (optional)
    Type: string
  
  - `why_this_earns_the_inbox` (optional)
    Type: string

- `trigger` (optional)
  Type: object
  
  - `event` (optional)
    Type: string
    
    Built-in or lowercase underscore event name.
  
  - `exit_events` (optional)
    Type: array
    
    Stop future steps on new matching events; pinned.
    
    maxItems: 20
    
    Items:
      Type: string
      
      pattern: "^[a-z][a-z0-9_]{0,63}$"
  
  - `stop_on_reply` (optional)
    Type: boolean
    
    Requires monitored receiving.
    
    default: false
  
  - `reply_source` (optional)
    Type: object
    
    Match replies to an owned source.
    
    - `type` (required)
      Type: string
      
      enum: ["any","flow","campaign","message"]
    
    - `id` (optional)
      Type: integer
      
      minimum: 1
    
    Additional properties: false
  
  - `action_name` (optional)
    Type: string
    
    Preserve trigger identity.
  
  - `segment_id` (optional)
    Type: integer
  
  - `contact_list_id` (optional)
    Type: integer
  
  - `resource_type` (optional)
    Type: string
    
    Frozen trigger resource type.
  
  - `resource_id` (optional)
    Type: unknown
    
    Frozen trigger resource id.
  
  - `data` (optional)
    Type: object
    
    Event settings; list_add backfill_on_publish includes existing list members.

- `steps` (optional)
  Type: array
  
  Items:
    Type: unknown

- `dry_run` (optional)
  Type: boolean
  
  default: false

- `idempotency_key` (optional)
  Type: string
  
  Required for non-dry-run persistence; exact retry only.
  
  maxLength: 128

- `confirm` (optional)
  Type: boolean
  
  default: false

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_compose_flow",
    "arguments": {
        "name": "string",
        "mode": "create",
        "flow_id": 0,
        "expected_updated_at": "string",
        "expected_draft_revision_id": 0,
        "goal": "string",
        "lifecycle_key": "string",
        "composition_mode": "intent",
        "contract_id": "string",
        "brand_context_ref": "string",
        "validate_only": false,
        "design_mode_override": "premium_rich",
        "renegotiate": false,
        "user_instruction": "string",
        "creative_route_id": "string",
        "email_baseline_selections": [
          {
            "action_name": "string",
            "route_id": "string",
            "image_binding_ids": [
              "string"
            ]
          }
        ],
        "source_text": "string",
        "facts": [
          {
            "kind": "url",
            "value": "string",
            "description": "string",
            "requirement": "required"
          }
        ],
        "draft_meta": {
          "creative_route_id": "string",
          "concrete_anchor": "string",
          "why_this_earns_the_inbox": "string"
        },
        "trigger": {
          "event": "string",
          "exit_events": [
            "string"
          ],
          "stop_on_reply": false,
          "reply_source": {
            "type": "any",
            "id": 1
          },
          "action_name": "string",
          "segment_id": 0,
          "contact_list_id": 0,
          "resource_type": "string",
          "data": {}
        },
        "steps": [],
        "dry_run": false,
        "idempotency_key": "string",
        "confirm": false
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_compose_flow",
  "arguments": {
    "name": "string",
    "mode": "create",
    "flow_id": 0,
    "expected_updated_at": "string",
    "expected_draft_revision_id": 0,
    "goal": "string",
    "lifecycle_key": "string",
    "composition_mode": "intent",
    "contract_id": "string",
    "brand_context_ref": "string",
    "validate_only": false,
    "design_mode_override": "premium_rich",
    "renegotiate": false,
    "user_instruction": "string",
    "creative_route_id": "string",
    "email_baseline_selections": [
      {
        "action_name": "string",
        "route_id": "string",
        "image_binding_ids": [
          "string"
        ]
      }
    ],
    "source_text": "string",
    "facts": [
      {
        "kind": "url",
        "value": "string",
        "description": "string",
        "requirement": "required"
      }
    ],
    "draft_meta": {
      "creative_route_id": "string",
      "concrete_anchor": "string",
      "why_this_earns_the_inbox": "string"
    },
    "trigger": {
      "event": "string",
      "exit_events": [
        "string"
      ],
      "stop_on_reply": false,
      "reply_source": {
        "type": "any",
        "id": 1
      },
      "action_name": "string",
      "segment_id": 0,
      "contact_list_id": 0,
      "resource_type": "string",
      "data": {}
    },
    "steps": [],
    "dry_run": false,
    "idempotency_key": "string",
    "confirm": false
  }
});
```

### Python

```python
result = await session.call_tool("nitro_compose_flow", arguments={
  "name": "string",
  "mode": "create",
  "flow_id": 0,
  "expected_updated_at": "string",
  "expected_draft_revision_id": 0,
  "goal": "string",
  "lifecycle_key": "string",
  "composition_mode": "intent",
  "contract_id": "string",
  "brand_context_ref": "string",
  "validate_only": false,
  "design_mode_override": "premium_rich",
  "renegotiate": false,
  "user_instruction": "string",
  "creative_route_id": "string",
  "email_baseline_selections": [
    {
      "action_name": "string",
      "route_id": "string",
      "image_binding_ids": [
        "string"
      ]
    }
  ],
  "source_text": "string",
  "facts": [
    {
      "kind": "url",
      "value": "string",
      "description": "string",
      "requirement": "required"
    }
  ],
  "draft_meta": {
    "creative_route_id": "string",
    "concrete_anchor": "string",
    "why_this_earns_the_inbox": "string"
  },
  "trigger": {
    "event": "string",
    "exit_events": [
      "string"
    ],
    "stop_on_reply": false,
    "reply_source": {
      "type": "any",
      "id": 1
    },
    "action_name": "string",
    "segment_id": 0,
    "contact_list_id": 0,
    "resource_type": "string",
    "data": {}
  },
  "steps": [],
  "dry_run": false,
  "idempotency_key": "string",
  "confirm": false
})
```


## nitro_compose_campaign

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `name` (optional)
  Type: string
  
  Campaign name; required when creating.

- `mode` (optional)
  Type: string
  
  default: "create"
  
  enum: ["create","patch","replace"]

- `campaign_id` (optional)
  Type: integer

- `channel` (optional)
  Type: string
  
  Immutable after creation.
  
  default: "email"
  
  enum: ["email","sms"]

- `goal` (optional)
  Type: string

- `category` (optional)
  Type: string
  
  Email job used to select a baseline.
  
  enum: ["promotion","announcement","newsletter","welcome","reengagement","transactional","plain"]

- `composition_mode` (optional)
  Type: string
  
  intent plans; validate checks; draft persists; generate composes and persists.
  
  enum: ["intent","draft","validate","generate"]

- `contract_id` (optional)
  Type: string

- `brand_context_ref` (optional)
  Type: string

- `validate_only` (optional)
  Type: boolean
  
  default: false

- `design_mode_override` (optional)
  Type: string
  
  enum: ["premium_rich","premium_minimal","founder_letter","utility_plain"]

- `renegotiate` (optional)
  Type: boolean
  
  default: false

- `user_instruction` (optional)
  Type: string

- `creative_route_id` (optional)
  Type: string
  
  Intent-only route id.

- `source_text` (optional)
  Type: string
  
  Untrusted source evidence; put authoring directions in user_instruction.

- `facts` (optional)
  Type: array
  
  Literal evidence: required values must appear; available values may be used.
  
  Items:
    Type: object
    
    - `kind` (required)
      Type: string
      
      enum: ["url","image_url","offer_code","price","deadline","offer","cta_text"]
    
    - `value` (required)
      Type: string
    
    - `description` (optional)
      Type: string
      
      For image_url: truthful visible content for selection and alt text.
    
    - `requirement` (required)
      Type: string
      
      enum: ["required","available"]
    
    Additional properties: false

- `draft_meta` (optional)
  Type: object
  
  Optional authoring provenance; never blocks.
  
  - `creative_route_id` (optional)
    Type: string
  
  - `concrete_anchor` (optional)
    Type: string
  
  - `why_this_earns_the_inbox` (optional)
    Type: string

- `subject` (optional)
  Type: string

- `preheader` (optional)
  Type: string

- `from_name` (optional)
  Type: string

- `from_email` (optional)
  Type: string

- `reply_to` (optional)
  Type: string

- `body` (optional)
  Type: string

- `content_format` (optional)
  Type: string
  
  Match source.
  
  enum: ["designed","plain"]

- `plain_text_mode` (optional)
  Type: string
  
  Text provenance.
  
  enum: ["derived","custom"]

- `sections` (optional)
  Type: array
  
  Email design sections; requires subject. Images accept public or nitro_ingest media_url/image_url, never raw signed_id.
  
  Items:
    Type: object

- `section_updates` (optional)
  Type: array
  
  Same entries as nitro_manage_template section_updates.
  
  Items:
    Type: object

- `theme` (optional)
  Type: object
  
  Brand-theme overrides. logo_url must be public or a nitro_ingest media_url/image_url, never raw signed_id.

- `template_id` (optional)
  Type: integer

- `if_version` (optional)
  Type: integer
  
  Version token for conflict-safe writes.

- `audience` (optional)
  Type: object
  
  Target audience; all_contacts must be explicit.
  
  - `audience_type` (optional)
    Type: string
    
    enum: ["lists","segment","all_contacts"]
  
  - `contact_list_ids` (optional)
    Type: array
    
    Items:
      Type: integer
  
  - `contact_list_id` (optional)
    Type: integer
    
    Deprecated single list id.
  
  - `segment_id` (optional)
    Type: integer
  
  - `exclude_segment_ids` (optional)
    Type: array
    
    Suppressed segment ids; [] clears.
    
    Items:
      Type: integer
  
  - `exclude_contact_list_ids` (optional)
    Type: array
    
    Suppressed list ids; [] clears.
    
    Items:
      Type: integer

- `scheduled_at` (optional)
  Type: string, date-time
  
  ISO 8601 delivery time.

- `dry_run` (optional)
  Type: boolean
  
  default: false

- `idempotency_key` (optional)
  Type: string
  
  Required for non-dry-run persistence; exact retry only.
  
  maxLength: 128

- `confirm` (optional)
  Type: boolean
  
  default: false

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_compose_campaign",
    "arguments": {
        "name": "string",
        "mode": "create",
        "campaign_id": 0,
        "channel": "email",
        "goal": "string",
        "category": "promotion",
        "composition_mode": "intent",
        "contract_id": "string",
        "brand_context_ref": "string",
        "validate_only": false,
        "design_mode_override": "premium_rich",
        "renegotiate": false,
        "user_instruction": "string",
        "creative_route_id": "string",
        "source_text": "string",
        "facts": [
          {
            "kind": "url",
            "value": "string",
            "description": "string",
            "requirement": "required"
          }
        ],
        "draft_meta": {
          "creative_route_id": "string",
          "concrete_anchor": "string",
          "why_this_earns_the_inbox": "string"
        },
        "subject": "string",
        "preheader": "string",
        "from_name": "string",
        "from_email": "string",
        "reply_to": "string",
        "body": "string",
        "content_format": "designed",
        "plain_text_mode": "derived",
        "sections": [
          {}
        ],
        "section_updates": [
          {}
        ],
        "theme": {},
        "template_id": 0,
        "if_version": 0,
        "audience": {
          "audience_type": "lists",
          "contact_list_ids": [
            0
          ],
          "contact_list_id": 0,
          "segment_id": 0,
          "exclude_segment_ids": [
            0
          ],
          "exclude_contact_list_ids": [
            0
          ]
        },
        "scheduled_at": "2024-01-15T09:30:00Z",
        "dry_run": false,
        "idempotency_key": "string",
        "confirm": false
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_compose_campaign",
  "arguments": {
    "name": "string",
    "mode": "create",
    "campaign_id": 0,
    "channel": "email",
    "goal": "string",
    "category": "promotion",
    "composition_mode": "intent",
    "contract_id": "string",
    "brand_context_ref": "string",
    "validate_only": false,
    "design_mode_override": "premium_rich",
    "renegotiate": false,
    "user_instruction": "string",
    "creative_route_id": "string",
    "source_text": "string",
    "facts": [
      {
        "kind": "url",
        "value": "string",
        "description": "string",
        "requirement": "required"
      }
    ],
    "draft_meta": {
      "creative_route_id": "string",
      "concrete_anchor": "string",
      "why_this_earns_the_inbox": "string"
    },
    "subject": "string",
    "preheader": "string",
    "from_name": "string",
    "from_email": "string",
    "reply_to": "string",
    "body": "string",
    "content_format": "designed",
    "plain_text_mode": "derived",
    "sections": [
      {}
    ],
    "section_updates": [
      {}
    ],
    "theme": {},
    "template_id": 0,
    "if_version": 0,
    "audience": {
      "audience_type": "lists",
      "contact_list_ids": [
        0
      ],
      "contact_list_id": 0,
      "segment_id": 0,
      "exclude_segment_ids": [
        0
      ],
      "exclude_contact_list_ids": [
        0
      ]
    },
    "scheduled_at": "2024-01-15T09:30:00Z",
    "dry_run": false,
    "idempotency_key": "string",
    "confirm": false
  }
});
```

### Python

```python
result = await session.call_tool("nitro_compose_campaign", arguments={
  "name": "string",
  "mode": "create",
  "campaign_id": 0,
  "channel": "email",
  "goal": "string",
  "category": "promotion",
  "composition_mode": "intent",
  "contract_id": "string",
  "brand_context_ref": "string",
  "validate_only": false,
  "design_mode_override": "premium_rich",
  "renegotiate": false,
  "user_instruction": "string",
  "creative_route_id": "string",
  "source_text": "string",
  "facts": [
    {
      "kind": "url",
      "value": "string",
      "description": "string",
      "requirement": "required"
    }
  ],
  "draft_meta": {
    "creative_route_id": "string",
    "concrete_anchor": "string",
    "why_this_earns_the_inbox": "string"
  },
  "subject": "string",
  "preheader": "string",
  "from_name": "string",
  "from_email": "string",
  "reply_to": "string",
  "body": "string",
  "content_format": "designed",
  "plain_text_mode": "derived",
  "sections": [
    {}
  ],
  "section_updates": [
    {}
  ],
  "theme": {},
  "template_id": 0,
  "if_version": 0,
  "audience": {
    "audience_type": "lists",
    "contact_list_ids": [
      0
    ],
    "contact_list_id": 0,
    "segment_id": 0,
    "exclude_segment_ids": [
      0
    ],
    "exclude_contact_list_ids": [
      0
    ]
  },
  "scheduled_at": "2024-01-15T09:30:00Z",
  "dry_run": false,
  "idempotency_key": "string",
  "confirm": false
})
```


## nitro_manage_domains

`TOOL nitro_manage_domains`

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

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `operation` (required)
  Type: string
  
  Prepare/select a hosted sender or manage customer domains.
  Rename keeps old addresses receiving. Show a paired removal's effect before unpair.
  
  enum: ["prepare_brand_subdomain","select_brand_subdomain","rename_brand_subdomain","add","verify","list","remove","list_shared_subdomains","share_subdomain","revoke_shared_subdomain"]

- `params` (optional)
  Type: object
  
  Operation-specific parameters.
  
  - `domain_id` (optional)
    Type: integer
    
    The current brand's domain that owns the subdomain.
    
    minimum: 1
  
  - `shared_domain_id` (optional)
    Type: integer
    
    Shared sending-domain claim to revoke.
    
    minimum: 1
  
  - `target_brand_sid` (optional)
    Type: string
    
    Exact destination brand; must be in this account or an eligible managed client.
  
  - `page` (optional)
    Type: integer
    
    minimum: 1
  
  - `domain_name` (optional)
    Type: string
    
    Customer sending domain for add, verify, or remove.
  
  - `author_domain` (optional)
    Type: string
    
    Optional aligned visible From domain for Nitrosend SES.
  
  - `subdomain` (optional)
    Type: string
    
    Sender name; needs no Brand Kit.
  
  - `expected_fqdn` (optional)
    Type: string
    
    Current brand_subdomain.fqdn, required for rename_brand_subdomain.
  
  - `local_part` (optional)
    Type: string
    
    Optional From local part.
  
  - `apex` (optional)
    Type: string
    
    Optional sending apex.
  
  - `unpair` (optional)
    Type: boolean
    
    Confirm removal of the domain's identity pair.
  
  Additional properties: false

- `confirm` (optional)
  Type: boolean
  
  Required for removal, renaming and subdomain-sharing changes.
  
  default: false

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_manage_domains",
    "arguments": {
        "operation": "prepare_brand_subdomain",
        "params": {
          "domain_id": 1,
          "shared_domain_id": 1,
          "target_brand_sid": "string",
          "page": 1,
          "domain_name": "string",
          "author_domain": "string",
          "subdomain": "string",
          "expected_fqdn": "string",
          "local_part": "string",
          "apex": "string",
          "unpair": true
        },
        "confirm": false
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_manage_domains",
  "arguments": {
    "operation": "prepare_brand_subdomain",
    "params": {
      "domain_id": 1,
      "shared_domain_id": 1,
      "target_brand_sid": "string",
      "page": 1,
      "domain_name": "string",
      "author_domain": "string",
      "subdomain": "string",
      "expected_fqdn": "string",
      "local_part": "string",
      "apex": "string",
      "unpair": true
    },
    "confirm": false
  }
});
```

### Python

```python
result = await session.call_tool("nitro_manage_domains", arguments={
  "operation": "prepare_brand_subdomain",
  "params": {
    "domain_id": 1,
    "shared_domain_id": 1,
    "target_brand_sid": "string",
    "page": 1,
    "domain_name": "string",
    "author_domain": "string",
    "subdomain": "string",
    "expected_fqdn": "string",
    "local_part": "string",
    "apex": "string",
    "unpair": true
  },
  "confirm": false
})
```


## nitro_configure_account

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Parameters:

- `from_name` (argument, string, optional) - Sender display name (e.g. 'Acme Marketing')
  Type: string
  
  Sender display name (e.g. 'Acme Marketing')

- `from_email` (argument, string, optional) - Exact visible From address to select. May use the apex when a ready aligned sending subdomain authorizes it.
  Type: string
  
  Exact visible From address to select. May use the apex when a ready aligned sending subdomain authorizes it.

- `reply_to` (argument, string, optional)
  Type: string

- `test_email_recipients` (argument, array, optional) - Saved test-send addresses; [] clears.
  Type: array
  
  Saved test-send addresses; [] clears.
  
  maxItems: 5
  
  Items:
    Type: string, email

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_configure_account",
    "arguments": {
        "from_name": "string",
        "from_email": "string",
        "reply_to": "string",
        "test_email_recipients": [
          "user@example.com"
        ]
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_configure_account",
  "arguments": {
    "from_name": "string",
    "from_email": "string",
    "reply_to": "string",
    "test_email_recipients": [
      "user@example.com"
    ]
  }
});
```

### Python

```python
result = await session.call_tool("nitro_configure_account", arguments={
  "from_name": "string",
  "from_email": "string",
  "reply_to": "string",
  "test_email_recipients": [
    "user@example.com"
  ]
})
```


## nitro_review_delivery

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Parameters:

- `target_type` (argument, string, optional)
  Type: string
  
  enum: ["template","flow","campaign"]

- `target_id` (argument, integer, optional)
  Type: integer
  
  minimum: 1

- `revision_id` (argument, integer, optional) - Optional for flows. Omit to review the current draft, or supply its ID as a current-draft assertion.
  Type: integer
  
  Optional for flows. Omit to review the current draft, or supply its ID as a current-draft assertion.
  
  minimum: 1

- `contact_id` (argument, integer, optional) - Merge-tag personalization contact.
  Type: integer
  
  Merge-tag personalization contact.
  
  minimum: 1

- `subject` (argument, string, optional) - Inline email review subject.
  Type: string
  
  Inline email review subject.
  
  maxLength: 998

- `html` (argument, string, optional) - Inline email review HTML.
  Type: string
  
  Inline email review HTML.
  
  minLength: 1
  
  maxLength: 262144

Declared MCP annotations:

```json
{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_review_delivery",
    "arguments": {
        "target_type": "template",
        "target_id": 1,
        "revision_id": 1,
        "contact_id": 1,
        "subject": "string",
        "html": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_review_delivery",
  "arguments": {
    "target_type": "template",
    "target_id": 1,
    "revision_id": 1,
    "contact_id": 1,
    "subject": "string",
    "html": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_review_delivery", arguments={
  "target_type": "template",
  "target_id": 1,
  "revision_id": 1,
  "contact_id": 1,
  "subject": "string",
  "html": "string"
})
```


## nitro_send_test_message

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Parameters:

- `target_type` (argument, string, optional) - With target_id, or use template_id/latest_campaign.
  Type: string
  
  With target_id, or use template_id/latest_campaign.
  
  enum: ["template","flow","campaign"]

- `target_id` (argument, integer, optional)
  Type: integer
  
  minimum: 1

- `latest_campaign` (argument, boolean, optional) - Latest campaign in this brand.
  Type: boolean
  
  Latest campaign in this brand.
  
  default: false

- `template_id` (argument, integer, optional) - Template id; may select a flow/campaign email.
  Type: integer
  
  Template id; may select a flow/campaign email.
  
  minimum: 1

- `action_id` (argument, integer, optional) - Select a flow message step.
  Type: integer
  
  Select a flow message step.
  
  minimum: 1

- `revision_id` (argument, integer, optional) - Exact revision; required for flows.
  Type: integer
  
  Exact revision; required for flows.
  
  minimum: 1

- `channel` (argument, string, optional) - Prefer auto.
  Type: string
  
  Prefer auto.
  
  default: "auto"
  
  enum: ["auto","email","sms"]

- `contact_id` (argument, integer, optional) - Recipient and personalization.
  Type: integer
  
  Recipient and personalization.
  
  minimum: 1

- `to` (argument, array, optional) - Email addresses or SMS E.164 numbers.
  Type: array
  
  Email addresses or SMS E.164 numbers.
  
  maxItems: 5
  
  Items:
    Type: string

- `data` (argument, object, optional) - Sample email data.* values.
  Type: object
  
  Sample email data.* values.

- `event_data` (argument, object, optional) - Sample email event.* data; no Event/Order writes.
  Type: object
  
  Sample email event.* data; no Event/Order writes.

- `dry_run` (argument, boolean, optional) - Validate without sending.
  Type: boolean
  
  Validate without sending.
  
  default: false

- `idempotency_key` (argument, string, optional) - Required to send; exact retries only.
  Type: string
  
  Required to send; exact retries only.
  
  minLength: 1

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": true,
  "openWorldHint": true
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_send_test_message",
    "arguments": {
        "target_type": "template",
        "target_id": 1,
        "latest_campaign": false,
        "template_id": 1,
        "action_id": 1,
        "revision_id": 1,
        "channel": "auto",
        "contact_id": 1,
        "to": [
          "string"
        ],
        "data": {},
        "event_data": {},
        "dry_run": false,
        "idempotency_key": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_send_test_message",
  "arguments": {
    "target_type": "template",
    "target_id": 1,
    "latest_campaign": false,
    "template_id": 1,
    "action_id": 1,
    "revision_id": 1,
    "channel": "auto",
    "contact_id": 1,
    "to": [
      "string"
    ],
    "data": {},
    "event_data": {},
    "dry_run": false,
    "idempotency_key": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_send_test_message", arguments={
  "target_type": "template",
  "target_id": 1,
  "latest_campaign": false,
  "template_id": 1,
  "action_id": 1,
  "revision_id": 1,
  "channel": "auto",
  "contact_id": 1,
  "to": [
    "string"
  ],
  "data": {},
  "event_data": {},
  "dry_run": false,
  "idempotency_key": "string"
})
```


## nitro_control_delivery

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `target_type` (required)
  Type: string
  
  enum: ["flow","campaign"]

- `target_id` (required)
  Type: integer
  
  minimum: 1

- `expected_brand_sid` (optional)
  Type: string
  
  Optional reviewed-brand assertion. When available, copy meta.current_brand.sid from the reviewed result.
  
  minLength: 1

- `operation` (required)
  Type: string
  
  approve preflights; schedule is campaign-only; delete requires confirm and a never-sent draft.
  
  enum: ["approve","reject","live","schedule","pause","resume","cancel","archive","restore","delete"]

- `scheduled_at` (optional)
  Type: string, date-time
  
  Required for schedule.

- `revision_id` (optional)
  Type: integer
  
  Optional current-draft assertion for flow approve, reject, and live.
  
  minimum: 1

- `resume_mode` (optional)
  Type: string
  
  For paused flows: stop current journeys, or restart waits and continue gradually.
  
  enum: ["new_contacts_only","continue_existing"]

- `confirm_send_to_all` (optional)
  Type: boolean
  
  Explicit all_contacts confirmation for live/schedule.

- `confirm` (optional)
  Type: boolean
  
  Required for delete.

- `idempotency_key` (optional)
  Type: string
  
  Campaign-live retry key; reuse only for the same send.

- `versions` (optional)
  Type: array
  
  See nitro_review_delivery versions.
  
  Items:
    Type: object

- `winner` (optional)
  Type: object

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_control_delivery",
    "arguments": {
        "target_type": "flow",
        "target_id": 1,
        "expected_brand_sid": "string",
        "operation": "approve",
        "scheduled_at": "2024-01-15T09:30:00Z",
        "revision_id": 1,
        "resume_mode": "new_contacts_only",
        "confirm_send_to_all": true,
        "confirm": true,
        "idempotency_key": "string",
        "versions": [
          {}
        ],
        "winner": {}
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_control_delivery",
  "arguments": {
    "target_type": "flow",
    "target_id": 1,
    "expected_brand_sid": "string",
    "operation": "approve",
    "scheduled_at": "2024-01-15T09:30:00Z",
    "revision_id": 1,
    "resume_mode": "new_contacts_only",
    "confirm_send_to_all": true,
    "confirm": true,
    "idempotency_key": "string",
    "versions": [
      {}
    ],
    "winner": {}
  }
});
```

### Python

```python
result = await session.call_tool("nitro_control_delivery", arguments={
  "target_type": "flow",
  "target_id": 1,
  "expected_brand_sid": "string",
  "operation": "approve",
  "scheduled_at": "2024-01-15T09:30:00Z",
  "revision_id": 1,
  "resume_mode": "new_contacts_only",
  "confirm_send_to_all": true,
  "confirm": true,
  "idempotency_key": "string",
  "versions": [
    {}
  ],
  "winner": {}
})
```


## nitro_get_insights

`TOOL nitro_get_insights`

Get email analytics with trends, benchmarks, and recommendations.

Authentication: no security requirement declared for this operation.

Parameters:

- `scope` (argument, string, required)
  Type: string
  
  enum: ["account","flow","campaign","message"]

- `entity_id` (argument, integer, optional) - Required for flow/campaign/message scope
  Type: integer
  
  Required for flow/campaign/message scope
  
  minimum: 1

- `period` (argument, string, optional)
  Type: string
  
  default: "30d"
  
  enum: ["7d","30d","90d"]

Declared MCP annotations:

```json
{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_get_insights",
    "arguments": {
        "scope": "account",
        "entity_id": 1,
        "period": "30d"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_get_insights",
  "arguments": {
    "scope": "account",
    "entity_id": 1,
    "period": "30d"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_get_insights", arguments={
  "scope": "account",
  "entity_id": 1,
  "period": "30d"
})
```


## nitro_configure_providers

`TOOL nitro_configure_providers`

Configure API-key email providers or check connection status.

Authentication: no security requirement declared for this operation.

Parameters:

- `operation` (argument, string, required) - configure sets BYO provider credentials; status checks current provider health
  Type: string
  
  configure sets BYO provider credentials; status checks current provider health
  
  enum: ["configure","status"]

- `provider` (argument, string, optional) - Email provider (required for configure)
  Type: string
  
  Email provider (required for configure)
  
  enum: ["mailgun","ses","postmark","resend","sendgrid"]

- `api_key` (argument, string, optional) - Provider API key (required for configure, never returned in responses)
  Type: string
  
  Provider API key (required for configure, never returned in responses)

- `api_secret` (argument, string, optional) - Optional provider secret (never returned in responses)
  Type: string
  
  Optional provider secret (never returned in responses)

- `region` (argument, string, optional) - Provider region where required, or the Mailgun sending domain
  Type: string
  
  Provider region where required, or the Mailgun sending domain

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_configure_providers",
    "arguments": {
        "operation": "configure",
        "provider": "mailgun",
        "api_key": "string",
        "api_secret": "string",
        "region": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_configure_providers",
  "arguments": {
    "operation": "configure",
    "provider": "mailgun",
    "api_key": "string",
    "api_secret": "string",
    "region": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_configure_providers", arguments={
  "operation": "configure",
  "provider": "mailgun",
  "api_key": "string",
  "api_secret": "string",
  "region": "string"
})
```


## nitro_get_memory

`TOOL nitro_get_memory`

Read brand memory.

Authentication: no security requirement declared for this operation.

Declared MCP annotations:

```json
{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_get_memory",
    "arguments": {}
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_get_memory",
  "arguments": {}
});
```

### Python

```python
result = await session.call_tool("nitro_get_memory", arguments={})
```


## nitro_set_memory

`TOOL nitro_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).

Authentication: no security requirement declared for this operation.

Parameters:

- `operation` (argument, string, required) - read: get current document. update: replace entirely. patch: replace a ## section by heading. append: add text to end.
  Type: string
  
  read: get current document. update: replace entirely. patch: replace a ## section by heading. append: add text to end.
  
  enum: ["read","update","patch","append"]

- `document` (argument, string, optional) - Full markdown document (required for update).
  Type: string
  
  Full markdown document (required for update).

- `heading` (argument, string, optional) - Section heading to patch (e.g. 'Brand Goals'). Required for patch operation. Matches ## headings.
  Type: string
  
  Section heading to patch (e.g. 'Brand Goals'). Required for patch operation. Matches ## headings.

- `content` (argument, string, optional) - New content for the section (patch) or text to append (append).
  Type: string
  
  New content for the section (patch) or text to append (append).

- `dry_run` (argument, boolean, optional)
  Type: boolean
  
  default: false

- `idempotency_key` (argument, string, optional) - 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.
  Type: string
  
  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.
  
  maxLength: 128

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_set_memory",
    "arguments": {
        "operation": "read",
        "document": "string",
        "heading": "string",
        "content": "string",
        "dry_run": false,
        "idempotency_key": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_set_memory",
  "arguments": {
    "operation": "read",
    "document": "string",
    "heading": "string",
    "content": "string",
    "dry_run": false,
    "idempotency_key": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_set_memory", arguments={
  "operation": "read",
  "document": "string",
  "heading": "string",
  "content": "string",
  "dry_run": false,
  "idempotency_key": "string"
})
```


## nitro_manage_billing

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `operation` (required)
  Type: string
  
  Start with status or features.
  
  enum: ["status","features","payment_methods","checkout","checkout_status","plans","add_funds","funding_purchase_status"]

- `params` (optional)
  Type: object
  
  Parameters for the selected operation.
  
  - `plan_id` (optional)
    Type: integer
    
    Plan ID (required for checkout)
  
  - `quantity` (optional)
    Type: integer
    
    Number of units for a quantity-based offer, as returned by features. Other offers require one.
    
    minimum: 1
    
    maximum: 10000
  
  - `product_key` (optional)
    Type: string
    
    Subscription product returned by features; omit for the base plan.
    
    default: "base_plan"
  
  - `confirm` (optional)
    Type: boolean
    
    Set true only after operator confirmation when checkout reports confirmation_required
  
  - `amount_cents` (optional)
    Type: integer
    
    Integer amount in minor currency units
  
  - `currency` (optional)
    Type: string
    
    Three-letter funding currency
  
  - `instrument` (optional)
    Type: string
    
    Optional add-funds instrument; omit to use the account default
    
    enum: ["stripe_checkout","shopify_one_time"]
  
  - `purchase_id` (optional)
    Type: integer
    
    Local purchase ID returned by checkout or add_funds, interpreted by operation
  
  Additional properties: false

- `idempotency_key` (optional)
  Type: string
  
  Required stable key for checkout and add_funds. Reuse it only for an unchanged request.
  
  maxLength: 128

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": true,
  "openWorldHint": true
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_manage_billing",
    "arguments": {
        "operation": "status",
        "params": {
          "plan_id": 0,
          "quantity": 1,
          "product_key": "base_plan",
          "confirm": true,
          "amount_cents": 0,
          "currency": "string",
          "instrument": "stripe_checkout",
          "purchase_id": 0
        },
        "idempotency_key": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_manage_billing",
  "arguments": {
    "operation": "status",
    "params": {
      "plan_id": 0,
      "quantity": 1,
      "product_key": "base_plan",
      "confirm": true,
      "amount_cents": 0,
      "currency": "string",
      "instrument": "stripe_checkout",
      "purchase_id": 0
    },
    "idempotency_key": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_manage_billing", arguments={
  "operation": "status",
  "params": {
    "plan_id": 0,
    "quantity": 1,
    "product_key": "base_plan",
    "confirm": true,
    "amount_cents": 0,
    "currency": "string",
    "instrument": "stripe_checkout",
    "purchase_id": 0
  },
  "idempotency_key": "string"
})
```


## nitro_send_message

`TOOL nitro_send_message`

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

Authentication: no security requirement declared for this operation.

Parameters:

- `channel` (argument, string, required)
  Type: string
  
  enum: ["email","sms"]

- `to` (argument, string, required) - Email or E.164 phone
  Type: string
  
  Email or E.164 phone

- `subject` (argument, string, optional)
  Type: string

- `body` (argument, string, optional) - Plain text; required for SMS
  Type: string
  
  Plain text; required for SMS

- `template_id` (argument, integer, optional) - Email template ID
  Type: integer
  
  Email template ID

- `data` (argument, object, optional) - Merge variables, e.g. {{ data.order_id }}
  Type: object
  
  Merge variables, e.g. {{ data.order_id }}

- `from` (argument, string, optional) - Email sender: Name <address>
  Type: string
  
  Email sender: Name <address>

- `from_email` (argument, string, optional) - Verified brand sender address
  Type: string
  
  Verified brand sender address

- `from_name` (argument, string, optional) - Sender name
  Type: string
  
  Sender name

- `reply_to` (argument, string, optional) - Reply address
  Type: string
  
  Reply address

- `cc` (argument, array, optional)
  Type: array
  
  maxItems: 10
  
  Items:
    Type: string

- `bcc` (argument, array, optional)
  Type: array
  
  maxItems: 10
  
  Items:
    Type: string

- `headers` (argument, object, optional) - Email headers; reserved names rejected
  Type: object
  
  Email headers; reserved names rejected
  
  Additional properties: 
    Type: string

- `tags` (argument, object, optional) - Email tags
  Type: object
  
  Email tags
  
  Additional properties: 
    Type: string | number | boolean

- `idempotency_key` (argument, string, required) - Reuse only for an exact retry
  Type: string
  
  Reuse only for an exact retry
  
  minLength: 1

- `dry_run` (argument, boolean, optional) - Preview without sending
  Type: boolean
  
  Preview without sending
  
  default: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": true,
  "openWorldHint": true
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_send_message",
    "arguments": {
        "channel": "email",
        "to": "string",
        "subject": "string",
        "body": "string",
        "template_id": 0,
        "data": {},
        "from": "string",
        "from_email": "string",
        "from_name": "string",
        "reply_to": "string",
        "cc": [
          "string"
        ],
        "bcc": [
          "string"
        ],
        "headers": {},
        "tags": {},
        "idempotency_key": "string",
        "dry_run": false
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_send_message",
  "arguments": {
    "channel": "email",
    "to": "string",
    "subject": "string",
    "body": "string",
    "template_id": 0,
    "data": {},
    "from": "string",
    "from_email": "string",
    "from_name": "string",
    "reply_to": "string",
    "cc": [
      "string"
    ],
    "bcc": [
      "string"
    ],
    "headers": {},
    "tags": {},
    "idempotency_key": "string",
    "dry_run": false
  }
});
```

### Python

```python
result = await session.call_tool("nitro_send_message", arguments={
  "channel": "email",
  "to": "string",
  "subject": "string",
  "body": "string",
  "template_id": 0,
  "data": {},
  "from": "string",
  "from_email": "string",
  "from_name": "string",
  "reply_to": "string",
  "cc": [
    "string"
  ],
  "bcc": [
    "string"
  ],
  "headers": {},
  "tags": {},
  "idempotency_key": "string",
  "dry_run": false
})
```


## nitro_inbox

`TOOL nitro_inbox`

Read the agent queue or mailbox. Follow next_calls for older or truncated thread content.

Authentication: no security requirement declared for this operation.

Parameters:

- `command` (argument, string, required)
  Type: string
  
  enum: ["list_queue","get_item","validate_reply","list_mailbox","get_thread","get_thread_page","get_message_body","get_attachment"]

- `action_item_id` (argument, integer, optional)
  Type: integer

- `conversation_id` (argument, integer, optional)
  Type: integer

- `before_occurred_at` (argument, string, optional) - Thread cursor from get_thread/get_thread_page
  Type: string
  
  Thread cursor from get_thread/get_thread_page

- `before_message_id` (argument, integer, optional) - Cursor message id paired with before_occurred_at
  Type: integer
  
  Cursor message id paired with before_occurred_at

- `message_id` (argument, integer, optional)
  Type: integer

- `attachment_id` (argument, integer, optional)
  Type: integer

- `acknowledge_unscanned` (argument, boolean, optional) - Operator accepted the unscanned-download risk
  Type: boolean
  
  Operator accepted the unscanned-download risk

- `offset` (argument, integer, optional) - Body offset from get_thread/get_message_body
  Type: integer
  
  Body offset from get_thread/get_message_body
  
  minimum: 0

- `state` (argument, string, optional) - Default needs_attention
  Type: string
  
  Default needs_attention
  
  enum: ["quarantine","needs_human","agent_ready","handled","needs_attention","all"]

- `status` (argument, string, optional)
  Type: string
  
  enum: ["open","closed","archived"]

- `query` (argument, string, optional) - Subject, preview, or sender
  Type: string
  
  Subject, preview, or sender

- `inbox_id` (argument, integer, optional)
  Type: integer

- `sender` (argument, string, optional) - Sender fragment
  Type: string
  
  Sender fragment

- `reason_code` (argument, string, optional)
  Type: string

- `since` (argument, string, optional) - ISO 8601
  Type: string
  
  ISO 8601

- `sort` (argument, string, optional)
  Type: string
  
  enum: ["queue","newest"]

- `view` (argument, string, optional) - Default compact
  Type: string
  
  Default compact
  
  enum: ["compact","full"]

- `include_counts` (argument, boolean, optional)
  Type: boolean

- `purpose` (argument, string, optional) - get_thread only
  Type: string
  
  get_thread only
  
  enum: ["reply","read"]

- `page` (argument, integer, optional)
  Type: integer

- `per` (argument, integer, optional) - Max 100 compact
  Type: integer
  
  Max 100 compact

- `brand_context_ref` (argument, string, optional) - Ref from a prior read
  Type: string
  
  Ref from a prior read

- `reply_context_digest` (argument, string, optional) - From get_item/get_thread; required by validate_reply
  Type: string
  
  From get_item/get_thread; required by validate_reply

- `subject` (argument, string, optional)
  Type: string

- `body` (argument, string, optional)
  Type: string

- `html` (argument, string, optional)
  Type: string

- `cc` (argument, array, optional)
  Type: array
  
  maxItems: 10
  
  Items:
    Type: string

- `bcc` (argument, array, optional)
  Type: array
  
  maxItems: 10
  
  Items:
    Type: string

- `reply_all` (argument, boolean, optional)
  Type: boolean
  
  default: false

- `attachment_refs` (argument, array, optional) - Signed upload references
  Type: array
  
  Signed upload references
  
  maxItems: 10
  
  Items:
    Type: string

Declared MCP annotations:

```json
{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_inbox",
    "arguments": {
        "command": "list_queue",
        "action_item_id": 0,
        "conversation_id": 0,
        "before_occurred_at": "string",
        "before_message_id": 0,
        "message_id": 0,
        "attachment_id": 0,
        "acknowledge_unscanned": true,
        "offset": 0,
        "state": "quarantine",
        "status": "open",
        "query": "string",
        "inbox_id": 0,
        "sender": "string",
        "reason_code": "string",
        "since": "string",
        "sort": "queue",
        "view": "compact",
        "include_counts": true,
        "purpose": "reply",
        "page": 0,
        "per": 0,
        "brand_context_ref": "string",
        "reply_context_digest": "string",
        "subject": "string",
        "body": "string",
        "html": "string",
        "cc": [
          "string"
        ],
        "bcc": [
          "string"
        ],
        "reply_all": false,
        "attachment_refs": [
          "string"
        ]
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_inbox",
  "arguments": {
    "command": "list_queue",
    "action_item_id": 0,
    "conversation_id": 0,
    "before_occurred_at": "string",
    "before_message_id": 0,
    "message_id": 0,
    "attachment_id": 0,
    "acknowledge_unscanned": true,
    "offset": 0,
    "state": "quarantine",
    "status": "open",
    "query": "string",
    "inbox_id": 0,
    "sender": "string",
    "reason_code": "string",
    "since": "string",
    "sort": "queue",
    "view": "compact",
    "include_counts": true,
    "purpose": "reply",
    "page": 0,
    "per": 0,
    "brand_context_ref": "string",
    "reply_context_digest": "string",
    "subject": "string",
    "body": "string",
    "html": "string",
    "cc": [
      "string"
    ],
    "bcc": [
      "string"
    ],
    "reply_all": false,
    "attachment_refs": [
      "string"
    ]
  }
});
```

### Python

```python
result = await session.call_tool("nitro_inbox", arguments={
  "command": "list_queue",
  "action_item_id": 0,
  "conversation_id": 0,
  "before_occurred_at": "string",
  "before_message_id": 0,
  "message_id": 0,
  "attachment_id": 0,
  "acknowledge_unscanned": true,
  "offset": 0,
  "state": "quarantine",
  "status": "open",
  "query": "string",
  "inbox_id": 0,
  "sender": "string",
  "reason_code": "string",
  "since": "string",
  "sort": "queue",
  "view": "compact",
  "include_counts": true,
  "purpose": "reply",
  "page": 0,
  "per": 0,
  "brand_context_ref": "string",
  "reply_context_digest": "string",
  "subject": "string",
  "body": "string",
  "html": "string",
  "cc": [
    "string"
  ],
  "bcc": [
    "string"
  ],
  "reply_all": false,
  "attachment_refs": [
    "string"
  ]
})
```


## nitro_inbox_action

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Request body: application/json (required)

Type: object

- `command` (required)
  Type: string
  
  enum: ["compose","send_reply","send_reply_test","mark_handled","request_human","release_to_agent","mark_quarantine","classify_spam","set_sender_policy","set_read_state","set_contact","reserve_attachment_upload"]

- `action_item_id` (optional)
  Type: integer
  
  Queue item id

- `action_item_ids` (optional)
  Type: array
  
  Triage: many items
  
  minItems: 1
  
  maxItems: 100
  
  Items:
    Type: integer

- `filter` (optional)
  Type: object
  
  Triage: list_queue filters; needs expected_count
  
  Additional properties: true

- `expected_count` (optional)
  Type: integer
  
  minimum: 0

- `conversation_id` (optional)
  Type: integer
  
  Mailbox thread id for reply commands

- `subject` (optional)
  Type: string
  
  Compose or reply subject

- `body` (optional)
  Type: string
  
  Plain text compose or reply body

- `html` (optional)
  Type: string
  
  HTML reply body

- `attachment_refs` (optional)
  Type: array
  
  Signed upload references
  
  maxItems: 10
  
  Items:
    Type: string

- `upload` (optional)
  Type: object
  
  File metadata for reserve_attachment_upload
  
  - `filename` (required)
    Type: string
  
  - `content_type` (required)
    Type: string
  
  - `byte_size` (required)
    Type: integer
    
    minimum: 1
    
    maximum: 6291456
  
  - `checksum` (required)
    Type: string
    
    Base64 MD5
  
  Additional properties: false

- `reply_context_digest` (optional)
  Type: string
  
  From nitro_inbox get_item/get_thread; required for reply commands

- `to` (optional)
  Type: array
  
  Compose recipients, or test recipients for send_reply_test (first 5)
  
  maxItems: 10
  
  Items:
    Type: string

- `cc` (optional)
  Type: array
  
  Overrides reply-all Cc
  
  maxItems: 10
  
  Items:
    Type: string

- `bcc` (optional)
  Type: array
  
  maxItems: 10
  
  Items:
    Type: string

- `reply_all` (optional)
  Type: boolean
  
  Copy visible thread participants, excluding self
  
  default: false

- `idempotency_key` (optional)
  Type: string
  
  Required

- `dry_run` (optional)
  Type: boolean
  
  Validate compose or reply without sending
  
  default: false

- `classification` (optional)
  Type: string
  
  enum: ["spam","not_spam"]

- `inbox_id` (optional)
  Type: integer
  
  For compose or set_sender_policy

- `matcher_type` (optional)
  Type: string
  
  enum: ["address","domain"]

- `matcher_value` (optional)
  Type: string

- `decision` (optional)
  Type: string
  
  enum: ["allow","block","handle"]

- `read` (optional)
  Type: boolean

- `last_read_message_id` (optional)
  Type: integer

- `contact_id` (optional)
  Type: integer
  
  For set_contact

- `create_contact` (optional)
  Type: boolean
  
  default: false

- `first_name` (optional)
  Type: string

- `last_name` (optional)
  Type: string

Additional properties: false

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_inbox_action",
    "arguments": {
        "command": "compose",
        "action_item_id": 0,
        "action_item_ids": [
          0
        ],
        "filter": {},
        "expected_count": 0,
        "conversation_id": 0,
        "subject": "string",
        "body": "string",
        "html": "string",
        "attachment_refs": [
          "string"
        ],
        "upload": {
          "filename": "string",
          "content_type": "string",
          "byte_size": 1,
          "checksum": "string"
        },
        "reply_context_digest": "string",
        "to": [
          "string"
        ],
        "cc": [
          "string"
        ],
        "bcc": [
          "string"
        ],
        "reply_all": false,
        "idempotency_key": "string",
        "dry_run": false,
        "classification": "spam",
        "inbox_id": 0,
        "matcher_type": "address",
        "matcher_value": "string",
        "decision": "allow",
        "read": true,
        "last_read_message_id": 0,
        "contact_id": 0,
        "create_contact": false,
        "first_name": "string",
        "last_name": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_inbox_action",
  "arguments": {
    "command": "compose",
    "action_item_id": 0,
    "action_item_ids": [
      0
    ],
    "filter": {},
    "expected_count": 0,
    "conversation_id": 0,
    "subject": "string",
    "body": "string",
    "html": "string",
    "attachment_refs": [
      "string"
    ],
    "upload": {
      "filename": "string",
      "content_type": "string",
      "byte_size": 1,
      "checksum": "string"
    },
    "reply_context_digest": "string",
    "to": [
      "string"
    ],
    "cc": [
      "string"
    ],
    "bcc": [
      "string"
    ],
    "reply_all": false,
    "idempotency_key": "string",
    "dry_run": false,
    "classification": "spam",
    "inbox_id": 0,
    "matcher_type": "address",
    "matcher_value": "string",
    "decision": "allow",
    "read": true,
    "last_read_message_id": 0,
    "contact_id": 0,
    "create_contact": false,
    "first_name": "string",
    "last_name": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_inbox_action", arguments={
  "command": "compose",
  "action_item_id": 0,
  "action_item_ids": [
    0
  ],
  "filter": {},
  "expected_count": 0,
  "conversation_id": 0,
  "subject": "string",
  "body": "string",
  "html": "string",
  "attachment_refs": [
    "string"
  ],
  "upload": {
    "filename": "string",
    "content_type": "string",
    "byte_size": 1,
    "checksum": "string"
  },
  "reply_context_digest": "string",
  "to": [
    "string"
  ],
  "cc": [
    "string"
  ],
  "bcc": [
    "string"
  ],
  "reply_all": false,
  "idempotency_key": "string",
  "dry_run": false,
  "classification": "spam",
  "inbox_id": 0,
  "matcher_type": "address",
  "matcher_value": "string",
  "decision": "allow",
  "read": true,
  "last_read_message_id": 0,
  "contact_id": 0,
  "create_contact": false,
  "first_name": "string",
  "last_name": "string"
})
```


## nitro_request_support

`TOOL nitro_request_support`

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

Authentication: no security requirement declared for this operation.

Parameters:

- `subject` (argument, string, required) - Brief summary of the issue
  Type: string
  
  Brief summary of the issue

- `message` (argument, string, required) - Complete, self-contained summary of the issue. Must fit within 1500 characters; do not rely on truncation.
  Type: string
  
  Complete, self-contained summary of the issue. Must fit within 1500 characters; do not rely on truncation.

Declared MCP annotations:

```json
{
  "readOnlyHint": false,
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_request_support",
    "arguments": {
        "subject": "string",
        "message": "string"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_request_support",
  "arguments": {
    "subject": "string",
    "message": "string"
  }
});
```

### Python

```python
result = await session.call_tool("nitro_request_support", arguments={
  "subject": "string",
  "message": "string"
})
```


## nitro_search_docs

`TOOL nitro_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.

Authentication: no security requirement declared for this operation.

Parameters:

- `query` (argument, string, required) - e.g. 'verify sending domain' or 'cli install'
  Type: string
  
  e.g. 'verify sending domain' or 'cli install'

- `limit` (argument, integer, optional) - Max 10.
  Type: integer
  
  Max 10.
  
  default: 6

Declared MCP annotations:

```json
{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}
```

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nitro_search_docs",
    "arguments": {
        "query": "string",
        "limit": 6
      }
  }
}
```

### TypeScript

```typescript
const result = await client.callTool({
  "name": "nitro_search_docs",
  "arguments": {
    "query": "string",
    "limit": 6
  }
});
```

### Python

```python
result = await session.call_tool("nitro_search_docs", arguments={
  "query": "string",
  "limit": 6
})
```


## guide

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://guide"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://guide"
});
```

### Python

```python
result = await session.read_resource("nitro://guide")
```


## account

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://account"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://account"
});
```

### Python

```python
result = await session.read_resource("nitro://account")
```


## schema

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://schema"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://schema"
});
```

### Python

```python
result = await session.read_resource("nitro://schema")
```


## brand-kit

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://brand-kit"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://brand-kit"
});
```

### Python

```python
result = await session.read_resource("nitro://brand-kit")
```


## providers

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://providers"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://providers"
});
```

### Python

```python
result = await session.read_resource("nitro://providers")
```


## config

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://config"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://config"
});
```

### Python

```python
result = await session.read_resource("nitro://config")
```


## email-design

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://email-design"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://email-design"
});
```

### Python

```python
result = await session.read_resource("nitro://email-design")
```


## email-marketing

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://email-marketing"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://email-marketing"
});
```

### Python

```python
result = await session.read_resource("nitro://email-marketing")
```


## lifecycle

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://lifecycle"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://lifecycle"
});
```

### Python

```python
result = await session.read_resource("nitro://lifecycle")
```


## docs

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://docs"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://docs"
});
```

### Python

```python
result = await session.read_resource("nitro://docs")
```


## example-email

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://examples/email"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://examples/email"
});
```

### Python

```python
result = await session.read_resource("nitro://examples/email")
```


## example-flow

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://examples/flow"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://examples/flow"
});
```

### Python

```python
result = await session.read_resource("nitro://examples/flow")
```


## example-campaign

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://examples/campaign"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://examples/campaign"
});
```

### Python

```python
result = await session.read_resource("nitro://examples/campaign")
```


## knowledge-index

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://knowledge/index"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://knowledge/index"
});
```

### Python

```python
result = await session.read_resource("nitro://knowledge/index")
```


## memory

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://memory"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://memory"
});
```

### Python

```python
result = await session.read_resource("nitro://memory")
```


## history

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://history"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://history"
});
```

### Python

```python
result = await session.read_resource("nitro://history")
```


## fields

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://fields"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://fields"
});
```

### Python

```python
result = await session.read_resource("nitro://fields")
```


## campaign-review

`RESOURCE ui://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.

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "ui://nitrosend/campaign-review/v2.2.0.html"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "ui://nitrosend/campaign-review/v2.2.0.html"
});
```

### Python

```python
result = await session.read_resource("ui://nitrosend/campaign-review/v2.2.0.html")
```


## authoring-context

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

Parameters:

- `ref` (path, string, required)
  Type: string

- `?cursor` (path, string, required)
  Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://authoring-context/{ref}{?cursor}"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://authoring-context/{ref}{?cursor}"
});
```

### Python

```python
result = await session.read_resource("nitro://authoring-context/{ref}{?cursor}")
```


## knowledge-topic

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

Parameters:

- `slug` (path, string, required)
  Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://knowledge/{slug}"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://knowledge/{slug}"
});
```

### Python

```python
result = await session.read_resource("nitro://knowledge/{slug}")
```


## prompt

`RESOURCE nitro://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.

Authentication: no security requirement declared for this operation.

Parameters:

- `name` (path, string, required)
  Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "resources/read",
  "params": {
    "uri": "nitro://prompts/{name}"
  }
}
```

### TypeScript

```typescript
const result = await client.readResource({
  "uri": "nitro://prompts/{name}"
});
```

### Python

```python
result = await session.read_resource("nitro://prompts/{name}")
```


## audience-analysis

`PROMPT audience-analysis`

Analyse audience segments and engagement

Authentication: no security requirement declared for this operation.

Parameters:

- `goal` (argument, string, required) - What you want to learn or achieve, e.g. 'find disengaged subscribers', 'segment by purchase history', 'identify VIP customers'
  Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "prompts/get",
  "params": {
    "name": "audience-analysis",
    "arguments": {
        "goal": "<goal>"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.getPrompt({
  "name": "audience-analysis",
  "arguments": {
    "goal": "<goal>"
  }
});
```

### Python

```python
result = await session.get_prompt("audience-analysis", arguments={
    "goal": "<goal>",
})
```


## build-email

`PROMPT build-email`

Compose a marketing email

Authentication: no security requirement declared for this operation.

Parameters:

- `goal` (argument, string, required) - What the email is for, e.g. 'announce our spring sale', 'weekly newsletter', 'event invitation', 'product launch'
  Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "prompts/get",
  "params": {
    "name": "build-email",
    "arguments": {
        "goal": "<goal>"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.getPrompt({
  "name": "build-email",
  "arguments": {
    "goal": "<goal>"
  }
});
```

### Python

```python
result = await session.get_prompt("build-email", arguments={
    "goal": "<goal>",
})
```


## build-flow

`PROMPT build-flow`

Create an automated email flow from scratch

Authentication: no security requirement declared for this operation.

Parameters:

- `goal` (argument, string, required) - What the flow should achieve, e.g. 'welcome series for new signups', 'abandoned cart recovery', 're-engage inactive subscribers'
  Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "prompts/get",
  "params": {
    "name": "build-flow",
    "arguments": {
        "goal": "<goal>"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.getPrompt({
  "name": "build-flow",
  "arguments": {
    "goal": "<goal>"
  }
});
```

### Python

```python
result = await session.get_prompt("build-flow", arguments={
    "goal": "<goal>",
})
```


## diagnose-deliverability

`PROMPT diagnose-deliverability`

Diagnose and fix email deliverability issues

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "prompts/get",
  "params": {
    "name": "diagnose-deliverability",
    "arguments": {}
  }
}
```

### TypeScript

```typescript
const result = await client.getPrompt({
  "name": "diagnose-deliverability"
});
```

### Python

```python
result = await session.get_prompt("diagnose-deliverability")
```


## flow-review

`PROMPT flow-review`

Review and optimise an existing flow

Authentication: no security requirement declared for this operation.

Parameters:

- `flow_id` (argument, string, optional) - ID of the flow to review. If omitted, lists active flows for the user to choose.
  Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "prompts/get",
  "params": {
    "name": "flow-review",
    "arguments": {
        "flow_id": "<flow_id>"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.getPrompt({
  "name": "flow-review",
  "arguments": {
    "flow_id": "<flow_id>"
  }
});
```

### Python

```python
result = await session.get_prompt("flow-review", arguments={
    "flow_id": "<flow_id>",
})
```


## lifecycle-setup

`PROMPT lifecycle-setup`

Review a brand site and draft the key lifecycle automation flows

Authentication: no security requirement declared for this operation.

Parameters:

- `website_url` (argument, string, optional) - Brand website to review and scrape, e.g. https://example.com
  Type: string

- `test_recipient` (argument, string, optional) - Email address that should receive flow test messages
  Type: string

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "prompts/get",
  "params": {
    "name": "lifecycle-setup",
    "arguments": {
        "website_url": "<website_url>",
        "test_recipient": "<test_recipient>"
      }
  }
}
```

### TypeScript

```typescript
const result = await client.getPrompt({
  "name": "lifecycle-setup",
  "arguments": {
    "website_url": "<website_url>",
    "test_recipient": "<test_recipient>"
  }
});
```

### Python

```python
result = await session.get_prompt("lifecycle-setup", arguments={
    "website_url": "<website_url>",
    "test_recipient": "<test_recipient>",
})
```


## onboard-brand-kit

`PROMPT onboard-brand-kit`

Set up Brand Kit identity for a new brand

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "prompts/get",
  "params": {
    "name": "onboard-brand-kit",
    "arguments": {}
  }
}
```

### TypeScript

```typescript
const result = await client.getPrompt({
  "name": "onboard-brand-kit"
});
```

### Python

```python
result = await session.get_prompt("onboard-brand-kit")
```


## weekly-report

`PROMPT weekly-report`

Generate a weekly performance report

Authentication: no security requirement declared for this operation.

## Examples

### JSON-RPC

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "prompts/get",
  "params": {
    "name": "weekly-report",
    "arguments": {}
  }
}
```

### TypeScript

```typescript
const result = await client.getPrompt({
  "name": "weekly-report"
});
```

### Python

```python
result = await session.get_prompt("weekly-report")
```
