# Carrier CLI Every fleet command in `carrier`. 137 commands. Generated from the CLI command registry. Do not edit this file by hand. Install: `npm i -g @carrierllc/mcp` or `brew install carrier`. Write commands preview first. Add `--commit` to apply a change. Add `--json` for a raw response on stdout. # subscribers Look up, inspect and change subscribers. ## carrier subscribers list --account-id --iccid --msisdn --imsi --activation-code --status --limit --offset List subscribers. With no filter, uses your default account (lowest-id account under your reseller). Calls MCP tool `list_subscribers`. - `--account-id ` (optional): Filter by account ID - `--iccid ` (optional): Filter by ICCID - `--msisdn ` (optional): Filter by MSISDN - `--imsi ` (optional): Filter by IMSI - `--activation-code ` (optional): Filter by eSIM activation code - `--status ` (optional): Filter by status, e.g. ACTIVE - `--limit ` (optional): Max rows to return - `--offset ` (optional): Pagination offset ## carrier subscribers get --iccid --msisdn --gz-counter Full record for one subscriber by ICCID or MSISDN. Calls MCP tool `get_subscriber`. - `--iccid ` (optional): Subscriber ICCID - `--msisdn ` (optional): Subscriber MSISDN - `--gz-counter` (optional): Include the green-zone byte counter ## carrier subscribers location --iccid Last-known location from the most recent cell tower usage. Calls MCP tool `get_subscriber_location`. - `--iccid ` (required): Subscriber ICCID ## carrier subscribers usage --iccid --start --end Daily data, voice and SMS usage over a window of up to 7 days. Calls MCP tool `subscriber_usage`. - `--iccid ` (required): Subscriber ICCID - `--start ` (optional): Start date YYYY-MM-DD (default: 7 days ago) - `--end ` (optional): End date YYYY-MM-DD, max 7 days from start (default: today) ## carrier subscribers events --iccid --start --end Network attach/detach events over a window of up to 7 days. Calls MCP tool `subscriber_network_events`. - `--iccid ` (required): Subscriber ICCID - `--start ` (optional): Start date YYYY-MM-DD (default: 7 days ago) - `--end ` (optional): End date YYYY-MM-DD, max 7 days from start (default: today) ## carrier subscribers active-period --iccid First and last usage dates for one subscriber. Calls MCP tool `subscriber_active_period`. - `--iccid ` (required): Subscriber ICCID ## carrier subscribers esim-status --account-id --reseller-id eSIM state counts per account: active, suspended, inventory. Calls MCP tool `esim_status_per_account`. - `--account-id ` (optional): Report on a single account - `--reseller-id ` (optional): Reseller ID (omit for the token owner's reseller) ## carrier subscribers set-status --iccid --status Change a subscriber's status. Calls MCP tool `modify_subscriber_status`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--status ` (required): New status, e.g. ACTIVE or SUSPENDED ## carrier subscribers set-balance --iccid --amount --mode Add to or replace a subscriber's balance. Calls MCP tool `modify_subscriber_balance`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--amount ` (required): Amount to add (adapt) or set to (set) - `--mode ` (required): 'adapt' adds or subtracts, 'set' replaces ## carrier subscribers sim-status show --iccid SIM/eSIM status at the SIM provider level, distinct from OCS status. Calls MCP tool `get_sim_provider_status`. - `--iccid ` (required): Subscriber ICCID ## carrier subscribers sim-status set --iccid --status Change the SIM/eSIM status at the SIM provider level. ENABLED and DISABLED map to OCS Affected and Free. Calls MCP tool `change_sim_status`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--status ` (required): New SIM status: ENABLED or DISABLED ## carrier subscribers phone-number set --iccid --phone-number --phone-type Assign a phone number (MSISDN) to a subscriber. Calls MCP tool `affect_subscriber_phone_number`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--phone-number ` (required): E.164 phone number to assign, e.g. +31612345678 - `--phone-type ` (required): 'fake' for test/dev MSISDNs, 'real' for production ## carrier subscribers contact set --iccid --first-name --last-name --company --email --phone-number Update contact details on a subscriber. Omitted fields stay unchanged. Calls MCP tool `modify_subscriber_contact_info`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--first-name ` (optional): First name - `--last-name ` (optional): Last name - `--company ` (optional): Company name - `--email ` (optional): Email address - `--phone-number ` (optional): Phone number ## carrier subscribers mobile-plan set --iccid --plan-id Change the mobile pricing plan a subscriber is billed under. Calls MCP tool `modify_subscriber_mobile_plan`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--plan-id ` (required): Mobile pricing plan ID ## carrier subscribers voip-plan set --iccid --plan-id Change the VoIP pricing plan assigned to a subscriber. Calls MCP tool `modify_subscriber_voip_plan`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--plan-id ` (required): VoIP pricing plan ID ## carrier subscribers traffic set --iccid --data --moc --mtc --sms Enable or disable data, calls and SMS per traffic type. Omit a flag to leave it unchanged. Calls MCP tool `set_subscriber_traffic_restrictions`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--data ` (optional): Allow data traffic (true or false) - `--moc ` (optional): Allow outbound calls (true or false) - `--mtc ` (optional): Allow inbound calls (true or false) - `--sms ` (optional): Allow outbound SMS (true or false) ## carrier subscribers bitrate show --iccid Current HLR-level bandwidth cap for a subscriber. Calls MCP tool `hlr_get_bitrate`. - `--iccid ` (required): Subscriber ICCID ## carrier subscribers bitrate set --iccid --bitrate --bitrate-string Set an HLR-level bandwidth cap. Bits per second are mapped onto the OCS KB_ enum. Calls MCP tool `hlr_set_bitrate`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--bitrate ` (optional): Max bitrate in bits per second. 256000 is KB_256. 0 is UNLIMITED. - `--bitrate-string ` (optional): OCS bitrate level, e.g. KB_256, KB_1024, UNLIMITED (instead of --bitrate) ## carrier subscribers greenzone reset --iccid Reset the Green Zone byte counter to zero. Irreversible. Calls MCP tool `reset_subscriber_gz_counter`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID ## carrier subscribers cell-location --radio-type --mcc --mnc --lac --cell-id --signal-strength Resolve a raw cell tower tuple to coordinates (Bridge4IP GeoSense). Calls MCP tool `get_subscriber_location_by_cell_id`. - `--radio-type ` (required): Radio type: 2G, 3G, 4G, 5G or NB-IoT - `--mcc ` (required): Mobile Country Code - `--mnc ` (required): Mobile Network Code - `--lac ` (required): Location Area Code - `--cell-id ` (optional): Cell tower ID (strongly recommended) - `--signal-strength ` (optional): Signal strength in dBm, e.g. -89 (improves accuracy) # packages Packages assigned to a subscriber. ## carrier packages list --iccid Packages on one subscriber, with allowance and expiry. Calls MCP tool `list_subscriber_packages`. - `--iccid ` (required): Subscriber ICCID ## carrier packages assign --iccid --template-id --account-id --request-key --start-date --end-date --validity-period --business-kind --business-id --business-line --business-verb Assign a one-time package from a template. Calls MCP tool `assign_package`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (optional): Subscriber ICCID - `--template-id ` (required): Package template ID from `carrier templates list` - `--account-id ` (optional): Issue from inventory through the authenticated Carrier API; requires --request-key; preserve it after unknown outcomes - `--request-key ` (optional): Required stable inventory key (1–200 safe characters); preserved after unknown outcomes - `--start-date ` (optional): Inventory package start date - `--end-date ` (optional): Inventory package end date - `--validity-period ` (optional): Inventory package validity period - `--business-kind ` (optional): Authorized reference kind: storefront_order - `--business-id ` (optional): Existing API-authorized order ID - `--business-line ` (optional): Authorized reference line: esim - `--business-verb ` (optional): Authorized reference verb: issue ## carrier packages set-status --iccid --package-id --status Activate or deactivate one package without deleting it. Calls MCP tool `modify_package_status`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--package-id ` (required): Package ID from `carrier packages list` - `--status ` (required): New package status, e.g. ACTIVE or INACTIVE ## carrier packages set-expiry --iccid --package-id --expires --validity-days Move a package's expiry date. Pass an absolute date or a day count. Calls MCP tool `modify_package_expiry`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--package-id ` (required): Package ID from `carrier packages list` - `--expires ` (optional): Absolute expiry, ISO 8601 (e.g. 2026-06-01) - `--validity-days ` (optional): Days from now until expiry (instead of --expires) ## carrier packages set-limits --iccid --package-id --limits Change data, voice or SMS ceilings on an assigned package. Calls MCP tool `modify_package_limits`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--package-id ` (required): Package ID from `carrier packages list` - `--limits ` (required): New limits as JSON, e.g. '{"dataLimit":5368709120}' ## carrier packages assign-recurring --iccid --template-id --activate-at-first-use --start-time Assign an auto-renewing package from a recurring-enabled template. Calls MCP tool `assign_recurring_package`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--template-id ` (required): Recurring package template ID from `carrier templates list` - `--activate-at-first-use` (optional): Activate on first network usage (instead of --start-time) - `--start-time ` (optional): Scheduled activation, ISO 8601 UTC (instead of --activate-at-first-use) ## carrier packages recurring set --iccid --package-id --action Pause or restart the auto-renewal of a recurring package. Calls MCP tool `stop_resume_recurring_package`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--package-id ` (required): Package ID from `carrier packages list` - `--action ` (required): 'stop' halts future renewals, 'resume' re-enables them ## carrier packages active-period set --iccid --package-id --start --end --comment Move the start and/or end of a package's active period. Calls MCP tool `modify_subscriber_package_active_period`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--package-id ` (required): Package ID from `carrier packages list` - `--start ` (optional): New start date, ISO 8601 (e.g. 2026-09-01) - `--end ` (optional): New end date, ISO 8601 (e.g. 2026-09-30) - `--comment ` (optional): Audit note stored on the package (OCS requires one; a default is sent) ## carrier packages clean --iccid Remove ALL packages from a subscriber. Irreversible. Calls MCP tool `clean_all_packages`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID ## carrier packages delete --iccid --package-id Permanently remove one package from a subscriber. Calls MCP tool `delete_subscriber_package`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--package-id ` (required): Package ID from `carrier packages list` # templates The package template catalog. ## carrier templates list Browse package templates available for assignment. Calls MCP tool `list_package_templates`. ## carrier templates create --template Create a package template from a JSON configuration. Calls MCP tool `create_package_template`. Write. Dry-run unless you pass `--commit`. - `--template ` (required): Template config as JSON, e.g. '{"name":"Europe 5GB","dataLimit":5368709120}' ## carrier templates set-core --template-id --changes Change name, limits, cost, validity or zone on a template. Calls MCP tool `modify_template_core`. Write. Dry-run unless you pass `--commit`. - `--template-id ` (required): Template ID from `carrier templates list` - `--changes ` (required): Core fields as JSON, e.g. '{"name":"Europe 5GB"}' ## carrier templates set-recurring --template-id --changes Change auto-renewal settings on a template. Calls MCP tool `modify_template_recurring`. Write. Dry-run unless you pass `--commit`. - `--template-id ` (required): Template ID from `carrier templates list` - `--changes ` (required): Recurring fields as JSON, e.g. '{"recurringPeriodicityType":2,"nbOccurrence":12}' ## carrier templates set-throttling --template-id --changes Change throttling thresholds. Applies to existing packages too. Calls MCP tool `modify_template_throttling`. Write. Dry-run unless you pass `--commit`. - `--template-id ` (required): Template ID from `carrier templates list` - `--changes ` (required): Throttling fields as JSON, e.g. '{"throttlingActive":true}' # zones Location zones and destination lists. ## carrier zones list --reseller-id --verbose Location zones with countries and operators. Prefer this over `elements`. Calls MCP tool `list_detailed_location_zones`. - `--reseller-id ` (optional): Reseller ID (omit for the token owner's reseller) - `--verbose ` (optional): Return the full OCS zone shape instead of the compact projection ## carrier zones elements --zone-id Raw zone elements. Upstream OCS returns malformed rows for some zones. Calls MCP tool `list_location_zones`. - `--zone-id ` (required): Filter to one location zone ## carrier zones create --zone Create a location zone from a JSON configuration. Calls MCP tool `create_location_zone`. Write. Dry-run unless you pass `--commit`. - `--zone ` (required): Zone config as JSON, e.g. '{"locationZoneName":"Europe","tadigList":["AZER1","QWER1"],"networkProfileId":79}' ## carrier zones network-profile set --zone-id --network-profile-id Attach or change the network profile on an existing location zone. Calls MCP tool `change_network_profile_of_location_zone`. Write. Dry-run unless you pass `--commit`. - `--zone-id ` (required): Location zone ID from `carrier zones list` - `--network-profile-id ` (required): Network profile ID from `carrier network-profiles list` ## carrier zones destinations --reseller-id Destination list catalog for voice and SMS packages. Calls MCP tool `list_destination_lists`. - `--reseller-id ` (optional): Reseller ID (omit for the token owner's reseller) ## carrier zones prefixes --destination-list-id Dialling prefixes inside one destination list. Calls MCP tool `list_destination_prefixes`. - `--destination-list-id ` (required): Destination list ID from `carrier zones destinations` # steering Network steering lists and operator preference. ## carrier steering list --reseller-id Steering lists configured for this reseller. Calls MCP tool `list_steering_lists`. - `--reseller-id ` (optional): Reseller ID (omit for the token owner's reseller) ## carrier steering assign --iccid --list-id Assign a steering list to a subscriber. Follow with `push`. Calls MCP tool `modify_subscriber_steering_list`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--list-id ` (required): Steering list ID from `carrier steering list` ## carrier steering push --iccid Push the assigned operator preference list to the device now. Calls MCP tool `push_steering_to_subscriber`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID # network-default Which networks a SIM gets per country. Default: the cheapest available. ## carrier network-default show Show the org network default (cheapest_available, all or custom) and what applies today. New assignments only. Calls MCP tool `get_network_default`. ## carrier network-default set --mode --list-id Store the org network default. Changes no SIM and writes nothing to OCS; applies to new assignments. Calls MCP tool `set_network_default`. Write. Dry-run unless you pass `--commit`. - `--mode ` (required): cheapest_available | all | custom - `--list-id ` (optional): Steering list ID from `carrier steering list`. Required when --mode is custom. ## carrier network-default plan --countries --sim-mode --sim-list-id --package-mode --package-list-id --reseller-id Show which networks a SIM would get in the given countries. Read only. Falls back to all networks with a loud warning when the tariff is missing. Calls MCP tool `plan_network_default`. - `--countries ` (required): Comma-separated ISO-3166 alpha-2 codes, e.g. CA,US - `--sim-mode ` (optional): Override for this SIM: cheapest_available | all | custom - `--sim-list-id ` (optional): Steering list ID when --sim-mode is custom - `--package-mode ` (optional): Override for this package: cheapest_available | all | custom - `--package-list-id ` (optional): Steering list ID when --package-mode is custom - `--reseller-id ` (optional): Reseller ID (omit for the token owner's reseller) # accounts Reseller accounts: balances and subscriber moves. ## carrier accounts list --reseller-id Accounts under a reseller with name, balance and type. Calls MCP tool `list_reseller_accounts`. - `--reseller-id ` (optional): Reseller ID (omit for the token owner's reseller) ## carrier accounts balance set --account-id --amount --mode Add to or replace an account's monetary balance. Calls MCP tool `modify_account_balance`. Write. Dry-run unless you pass `--commit`. - `--account-id ` (required): Account ID from `carrier accounts list` - `--amount ` (required): Amount to add (adapt) or set to (set) - `--mode ` (required): 'adapt' adds or subtracts, 'set' replaces ## carrier accounts move-subscribers --src-account-id --dest-account --range-type --range-start --range-end Move a contiguous IMSI or ICCID range of subscribers to another account. Calls MCP tool `move_subscriber_range_to_account`. Write. Dry-run unless you pass `--commit`. - `--src-account-id ` (required): Source account ID from `carrier accounts list` - `--dest-account ` (required): Destination account ID from `carrier accounts list` - `--range-type ` (required): Whether --range-start/--range-end are IMSI or ICCID ('IMSI' | 'ICCID') - `--range-start ` (required): Inclusive start of the identifier range - `--range-end ` (required): Inclusive end of the identifier range # reseller The reseller the token belongs to. ## carrier reseller show --reseller-id Full reseller record: balance, pricing plans, contact and traffic config. Calls MCP tool `get_reseller_info`. - `--reseller-id ` (optional): Reseller ID (omit for the token owner's reseller) # tariff Wholesale tariffs: mobile and VoIP rates. ## carrier tariff show --reseller-id --country --traffic-type --verbose Per-country wholesale rates for data, voice and SMS. Calls MCP tool `get_tariff`. - `--reseller-id ` (optional): Reseller ID (omit for the token owner's reseller) - `--country ` (optional): Filter to one country: ISO2 ("nl") or name ("Netherlands") - `--traffic-type ` (optional): Filter to data, voice or sms - `--verbose ` (optional): Return the full OCS rule shape instead of the compact projection ## carrier tariff voip --reseller-id VoIP tariff catalog for a reseller. Calls MCP tool `list_subscriber_voip_tariff`. - `--reseller-id ` (optional): Reseller ID (omit for the token owner's reseller) ## carrier tariff voip-rules --voip-plan-id Rate rules inside one VoIP plan. Calls MCP tool `list_voip_tariff_rule`. - `--voip-plan-id ` (required): VoIP plan ID from `carrier tariff voip` # sms Mobile-terminated SMS to subscribers. ## carrier sms send --iccid --msisdn --message --sender Send an MT SMS to one subscriber. Calls MCP tool `send_sms`. Write. Dry-run unless you pass `--commit`. - `--iccid ` (required): Subscriber ICCID - `--msisdn ` (required): Target MSISDN in E.164 format - `--message ` (required): SMS text (160 chars GSM-7; 70 with emoji or non-Latin scripts) - `--sender ` (optional): Sender ID or number shown on the device # sponsors Sponsor networks backing the eSIM profiles. ## carrier sponsors list --reseller-id Sponsor carriers available to this reseller. Calls MCP tool `list_sponsors`. - `--reseller-id ` (optional): Reseller ID (omit for the token owner's reseller) # network-profiles Roaming configuration profiles for zones and provisioning. ## carrier network-profiles list Network profiles available to this reseller. Calls MCP tool `list_network_profiles`. # webhooks Bridge4IP webhook and relay flag status. ## carrier webhooks show --reseller-id Current relay flags (LU, Gy, VoIP, calls+SMS) and notification webhooks. Calls MCP tool `carrier_webhook_config`. - `--reseller-id ` (optional): Reseller ID (omit for the token owner's reseller) # intelligence Composite reports over the fleet. ## carrier intelligence fleet-health --account-id eSIM counts, low-balance accounts and what needs attention. Calls MCP tool `fleet_health`. - `--account-id ` (optional): Report on a single account ## carrier intelligence diagnose --iccid Why one subscriber is offline, throttled or failing to attach. Calls MCP tool `diagnose_subscriber`. - `--iccid ` (required): Subscriber ICCID ## carrier intelligence anomalies --iccid Usage spikes and burn rates that exhaust the package early. Calls MCP tool `detect_usage_anomalies`. - `--iccid ` (required): Subscriber ICCID ## carrier intelligence churn --iccid Churn risk score with contributing factors. Calls MCP tool `churn_risk`. - `--iccid ` (required): Subscriber ICCID ## carrier intelligence optimize --iccid Better-fitting package for one subscriber, with the saving. Calls MCP tool `optimize_package`. - `--iccid ` (required): Subscriber ICCID ## carrier intelligence coverage --account-id --limit Networks subscribers actually attach to, against your steering lists. Calls MCP tool `audit_network_coverage`. - `--account-id ` (optional): Report on a single account - `--limit ` (optional): Subscribers to sample (default 50) ## carrier intelligence high-cost --account-id --limit --threshold-pct Subscribers whose consumption erodes the margin. Calls MCP tool `high_cost_subscribers`. - `--account-id ` (optional): Report on a single account - `--limit ` (optional): Subscribers to analyse (default 100) - `--threshold-pct ` (optional): Usage percentage that flags a subscriber (default 80) ## carrier intelligence marketing --account-id Where subscribers and revenue concentrate, and which markets grow. Calls MCP tool `marketing_intelligence`. - `--account-id ` (optional): Report on a single account ## carrier intelligence country-entry --iccid --expected-country Country a subscriber is in now, optionally diffed against the last known one. Calls MCP tool `detect_country_entry`. - `--iccid ` (required): Subscriber ICCID - `--expected-country ` (optional): Last known ISO 3166-1 alpha-2 country, e.g. NL # api-keys Mint Carrier API keys (ak_…) for headless and CI use ## carrier api-keys create --name --description --seconds-until-expiration Create an org API key. The secret is shown once and never stored by the CLI. Calls `POST /v1/api-keys`. - `--name ` (required): Label for the key, max 64 characters - `--description ` (optional): Optional note, max 256 characters - `--seconds-until-expiration ` (optional): Expiry in seconds, 60 to 31536000. Omit for a key that does not expire. # onboard Connect a new account to OCS without opening a browser ## carrier onboard status Show how far onboarding has got. Same state the console renders. Calls `GET /v1/onboarding`. ## carrier onboard org --name --website --country --operator-type Record who the operator is (step 1). Calls `POST /v1/onboarding/org`. - `--name ` (required): Operator name, max 128 characters - `--website ` (optional): Public site, if there is one - `--country ` (optional): ISO 3166-1 alpha-2 country, e.g. NL - `--operator-type ` (optional): How the operator describes itself, e.g. mvno ## carrier onboard connect --token Connect your own eSIMVault token (step 2, BYO). Verified against OCS, then stored encrypted; the token is never echoed back. Calls `POST /v1/onboarding/ocs-connect`. - `--token ` (required): eSIMVault API token. A flag lands in shell history — prefer a leading space, or run this once from a fresh shell. ## carrier onboard managed Let Carrier provision the OCS sub-account instead (step 2, the primary path). Idempotent, and clears any BYO token. Calls `POST /v1/onboarding/managed-account`. ## carrier onboard plan --template-id --display-name Record the starting plan template (step 3). Calls `POST /v1/onboarding/plan`. - `--template-id ` (required): Package template to start from - `--display-name ` (required): What customers will see the plan called ## carrier onboard plan-skip Skip the plan step and come back to it later (step 3). Calls `POST /v1/onboarding/plan/skip`. ## carrier onboard test-esim Read back one eSIM from the connected fleet (step 4). Nothing is provisioned; a demo ICCID with a reason comes back if OCS has nothing to show. Calls `POST /v1/onboarding/test-esim`. ## carrier onboard complete Mark onboarding done (step 5). Calls `POST /v1/onboarding/complete`. # affiliate Carrier affiliate program: profile, referral link and commissions ## carrier affiliate status Read-only: returns the affiliate profile, referral code, link, counts, money owed and paid, and Connect payouts status for the authenticated operator. Calls MCP tool `affiliate_status`. ## carrier affiliate commissions --limit Read-only: returns the list of commission records for the authenticated operator. Calls MCP tool `affiliate_commissions`. - `--limit ` (optional): Maximum number of commission records to return (1-200, default: 50). Default 50. ## carrier affiliate join Join the Carrier affiliate program and generate a personal referral code and link. Calls MCP tool `affiliate_join`. # billing Carrier plan credits, spend thresholds and rate-limit state ## carrier billing events --limit View recent billing threshold events: notifications, invoice triggers, hard cap alerts, and overage pauses. Calls MCP tool `billing_events`. - `--limit ` (optional): Maximum number of events to return (default: 20, max: 50). ## carrier billing configure --overages-enabled --billing-threshold-cents --hard-cap-cents --auto-pause-on-cap --notify-at-pct --notification-email --notification-phone --webhook-url Configure your billing preferences: enable/disable overages, set billing thresholds (bill shock prevention), configure notification percentages, and set hard spending caps. Calls MCP tool `configure_billing`. - `--overages-enabled ` (optional): Enable or disable auto-billed overages when monthly credits are exhausted. - `--billing-threshold-cents ` (optional): Amount in cents at which an invoice is automatically generated (e.g., 10000 = $100). - `--hard-cap-cents ` (optional): Maximum overage spend in cents before overages are paused (0 = no cap). - `--auto-pause-on-cap ` (optional): Whether to automatically pause overages when hard cap is reached. - `--notify-at-pct ` (optional): Percentage thresholds at which to send notifications (e.g., [50, 80, 95, 100]). Comma-separated. - `--notification-email ` (optional): Email address for billing threshold notifications. - `--notification-phone ` (optional): E.164 phone number for SMS billing threshold notifications via Twilio (e.g. +14155552671). - `--webhook-url ` (optional): Webhook URL for billing threshold events. ## carrier billing credits Read how much of this Carrier MCP plan is left: credits remaining, daily free credits, overage state, volume discount tier, and billing threshold state. Calls MCP tool `credit_balance`. ## carrier billing plans View all available Carrier MCP pricing plans with credit allotments, features, overage rates, and volume discount tiers. Calls MCP tool `pricing_plans`. ## carrier billing projection --days-to-project Project your credit usage and costs for the remainder of the billing period based on current consumption rate. Calls MCP tool `usage_projection`. - `--days-to-project ` (optional): Number of days to project forward (default: remaining days in month). ## carrier billing rate-limit --endpoint Inspect Bridge4IP OCS rate-limit governor state — bucket fill levels, per-endpoint limits, and 80% alert thresholds. Calls MCP tool `rate_limit_status`. - `--endpoint ` (optional): OCS method name in camelCase (e.g. 'subscriberUsageOverPeriod'). # wallet The Carrier prepaid wallet: balance and top-ups ## carrier wallet balance Read the caller organisation's Carrier prepaid wallet: current balance and auto-top-up settings. Calls MCP tool `wallet_balance`. ## carrier wallet topup --pack Create a Stripe Checkout link so a human can top up the Carrier prepaid wallet by card. Calls MCP tool `wallet_topup_checkout`. - `--pack ` (optional): Pack id (pack_25/pack_50/pack_100/pack_500/pack_1000/pack_2500/pack_5000) or exact EUR-cents amount. ## carrier wallet auto-topup --pack-cents Charge the organisation's saved card off-session, right now, and credit the Carrier prepaid wallet with the pack. Calls MCP tool `wallet_auto_topup`. - `--pack-cents ` (optional): Override pack amount in EUR cents (must match a catalog pack). # stripe Money in the operator's connected Stripe account ## carrier stripe balance Read the money sitting in the operator's connected Stripe account: available and pending, split per currency. Calls MCP tool `stripe_connect_balance`. ## carrier stripe payouts --limit --status List money Stripe has already sent from the operator's connected account to their bank, newest first. Calls MCP tool `stripe_connect_payouts`. - `--limit ` (optional): Number of payouts to return. Default 10. - `--status ` (optional): Filter by payout status. One of: pending, paid, failed, canceled, in_transit. ## carrier stripe charges --limit --starting-after List recent payments (charges) on the operator's connected Stripe account, e.g. storefront purchases. Calls MCP tool `stripe_connect_charges_list`. - `--limit ` (optional): Number of charges to return. Default 20. - `--starting-after ` (optional): Charge id to page after. ## carrier stripe disputes --limit --status List chargebacks customers have raised with their bank against the operator's connected Stripe account. Calls MCP tool `stripe_connect_dispute_list`. - `--limit ` (optional): limit (number). Default 10. - `--status ` (optional): Filter by dispute status (e.g. needs_response, under_review). ## carrier stripe refund --charge-id --amount-cents --reason --confirm-token Refund money to a customer on one charge in the operator's connected Stripe account. Calls MCP tool `stripe_connect_refund`. - `--charge-id ` (required): Stripe charge ID (ch_...). - `--amount-cents ` (optional): Partial refund amount in cents. - `--reason ` (optional): reason (string). One of: duplicate, fraudulent, requested_by_customer. - `--confirm-token ` (optional): Confirmation token from previous call. # radar Stripe Radar fraud reviews and value lists ## carrier radar reviews --open-only --limit List the Stripe Radar fraud reviews waiting on a manual approve/decline decision, newest first. Calls MCP tool `radar_review_list`. - `--open-only ` (optional): Stripe lists only open (undecided) reviews; kept for compatibility. Default true. - `--limit ` (optional): limit (number). Default 10. ## carrier radar approve --review-id --confirm-token Clear a Stripe Radar fraud review so the held charge is captured and the money is taken. Calls MCP tool `radar_review_approve`. - `--review-id ` (required): Stripe Radar review ID (prv_...). - `--confirm-token ` (optional): confirm token (string). ## carrier radar decline --review-id --confirm-token Always refuses and calls nothing: Stripe has no endpoint to decline a Radar review (its Reviews API only lists, retrieves and approves). Calls MCP tool `radar_review_decline`. - `--review-id ` (required): review id (string). - `--confirm-token ` (optional): confirm token (string). ## carrier radar rule-toggle --rule-id --enabled Report a Stripe Radar rule's state. Stripe exposes no API to change it, so this changes nothing. Calls MCP tool `radar_rule_toggle`. - `--rule-id ` (required): Stripe Radar rule ID. - `--enabled ` (required): true = enable, false = disable. ## carrier radar value-list add --value-list-id --value --confirm-token Add one value to an existing Stripe Radar value list, changing how every future charge is scored. Calls MCP tool `radar_value_list_add`. - `--value-list-id ` (required): Stripe Radar value list ID (rsl_...). - `--value ` (required): The value to add (email, IP address, country code, etc.). - `--confirm-token ` (optional): confirm token (string). # greenzone The Bridge4IP Greenzone whitelist ## carrier greenzone list --from-portal List current Greenzone whitelist entries from the KV cache. Calls MCP tool `greenzone_whitelist_list`. - `--from-portal ` (optional): When true, return Kapture steps to read live portal state instead of KV cache. ## carrier greenzone add --host --ip Add a host or IP to the Greenzone whitelist. Needs Kapture running in the operator's own Chrome — without it the dry run still returns the portal steps to follow by hand. Calls MCP tool `greenzone_whitelist_add`. Write. Dry-run unless you pass `--commit`. - `--host ` (optional): Hostname to whitelist (e.g. 'example.com'). - `--ip ` (optional): IP address or CIDR to whitelist (e.g. '203.0.113.0/24'). ## carrier greenzone remove --host --ip Remove a host or IP from the Greenzone whitelist. Needs Kapture running in the operator's own Chrome — without it the dry run still returns the portal steps to follow by hand. Calls MCP tool `greenzone_whitelist_remove`. Write. Dry-run unless you pass `--commit`. - `--host ` (optional): Hostname to remove from whitelist. - `--ip ` (optional): IP address or CIDR to remove from whitelist. # agent Steel browsing agents: one-off tasks and cron schedules ## carrier agent ask --prompt --max-steps Send a plain-language task to a hosted browsing agent, which drives a real browser on the open web — navigating pages, searching, extracting content, filling forms outside the OCS portal. Calls MCP tool `ui_agent_ask`. Write. Dry-run unless you pass `--commit`. - `--prompt ` (required): Natural-language task description for the browsing agent. - `--max-steps ` (optional): Advisory step budget (1–30, default 15). ## carrier agent status --task-id Poll the status of a browser agent task dispatched by ui_agent_ask or any ui_* tool. Calls MCP tool `ui_agent_status`. - `--task-id ` (required): Task ID returned by ui_agent_ask or any ui_* tool dispatch. ## carrier agent pending Returns all browser automation tasks that are currently paused waiting for human input. Calls MCP tool `ui_agent_list_pending`. ## carrier agent reply --task-id --reply Resumes a browser automation task that paused waiting for input. Calls MCP tool `ui_agent_reply`. - `--task-id ` (required): Task ID to resume (from ui_agent_list_pending). - `--reply ` (required): Your answer to the agent's question (e.g. a 2FA code or confirmation). ## carrier agent usage Returns an estimated Anthropic API cost for Steel agent tasks dispatched this calendar month. Calls MCP tool `ui_agent_usage`. ## carrier agent schedule list Lists all Steel recurring schedules stored in KV. Calls MCP tool `ui_agent_schedule_list`. ## carrier agent schedule create --name --cron --prompt-template