neuron_create_sms_campaign
Create a draft SMS campaign. Choose the audience via sourceType: 'all_contacts' or 'contact_list' (your own contacts), 'phones' (bring your own list — raw numbers you pass in), 'platform' (the wider Neuron audience — budget required, sent over the bulk campaign route), or 'curated' (SMS-opted-in ...
This record as markdown: /tools/io-github-conquext-neuron/neuron-create-sms-campaign.md
What neuron_create_sms_campaign does on Neuron
AI agents use neuron_create_sms_campaign to create or update resources in Neuron, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Neuron environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | — | 'blast' sends to everyone at once (default); 'drip' sends in scheduled batches |
title | string | Yes | Internal campaign title |
budget | number | — | Budget in kobo (required for sourceType 'platform'; caps how many messages send) |
phones | array | — | Raw phone numbers to text (required when sourceType is 'phones'); normalized + de-duplicated server-side, invalid ones dropped |
message | string | Yes | The SMS text to send. Include an opt-out (e.g. 'Reply STOP'). |
sourceType | string | Yes | Audience source |
countryCodes | array | — | Restrict to these country calling codes (e.g. ['234']). Omit for all. |
poolEntryIds | array | — | SMS-enabled list-pool entry UUIDs (required when sourceType is 'curated'; find them with neuron_browse_list_pool { smsEnabled: true }) |
smsChannelId | string | — | BYOK SMS channel UUID to send through instead of the platform provider |
sourceListIds | array | — | Contact list UUIDs (required when sourceType is 'contact_list') |
Parameters from the server's own tool schema.
Why neuron_create_sms_campaign is rated Medium
An AI agent can call neuron_create_sms_campaign faster than any human can review: one bad instruction and it creates or modifies resources in Neuron by the hundred, each call as confident as the last.
Risk signalsHigh parameter count (10 properties) · Admin/system-level operation
Attacks that exploit this kind of access
The rule that runs neuron_create_sms_campaign safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Neuron, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For neuron_create_sms_campaign, this is the rule to start with:
neuron_create_sms_campaign stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Neuron, apply this rule, and every neuron_create_sms_campaign call is checked against it from then on.
Questions about neuron_create_sms_campaign
Create a draft SMS campaign. Choose the audience via sourceType: 'all_contacts' or 'contact_list' (your own contacts), 'phones' (bring your own list — raw numbers you pass in), 'platform' (the wider Neuron audience — budget required, sent over the bulk campaign route), or 'curated' (SMS-opted-in marketplace lists via poolEntryIds; the list owner earns ₦2/contact). After creating, call neuron_estimate_sms_campaign to price it, then neuron_send_sms_campaign. Requires SMS to be enabled by an admin and a configured provider. It is categorised as a Write tool in the Neuron MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
neuron_create_sms_campaign accepts 10 parameters: type, title, budget, phones, message, sourceType, countryCodes, poolEntryIds, smsChannelId, sourceListIds. Required: title, message, sourceType. The full parameter table on this page comes from the server's own tool schema.
Register the Neuron MCP server in PolicyLayer and add a rule for neuron_create_sms_campaign: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Neuron. Nothing to install.
neuron_create_sms_campaign is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the neuron_create_sms_campaign rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for neuron_create_sms_campaign. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
neuron_create_sms_campaign is provided by the Neuron MCP server (neuron-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Neuron, and thousands of servers like it.
This server
Across the catalogue