Campaign planning
Turn a brief into an editable, unlaunched draft.
Your assistant. Connected to the right work.
Novia MCP gives compatible assistants authorized campaign evidence and tools to prepare work for review. The same client permissions apply here as in the dashboard.
Connect through the Novia Reach Site plugin
- In your host app, open Plugins, then Personal → Created by you.
- Find the plugin created for this Novia Reach Site and select Install or Connect.
- Use the same authorized identity you use for Novia. A client invitation also requires visitor access to this private Site.
- Start with “List my Novia client workspaces.” If newly installed tools are not visible, start a new chat.
Publishing this Site with MCP provisions and refreshes its private plugin. Installation and host-client support are separate from publication. This page does not claim that your assistant is already connected.
What remains in your hands
MCP can prepare campaign drafts and bulk previews. It cannot approve, fund or launch a campaign, change bids, publish a report or bypass network review. Open the returned Novia link to inspect and submit the concrete result.
Check your access to the Site tools.
This read-only check uses the same client-permission logic through the signed-in website. It does not test, install or connect your assistant’s separate MCP connection.
Try a precise request
List the Novia client workspaces I can access. For CLIENT_ID, compare 2026-10-01 through 2026-10-14 UTC with the preceding equal period. Explain tracking limitations. Prepare a traffic campaign draft for CLIENT_ID with NGN 10,000 total and NGN 2,000 daily. Do not launch it.
Replace the example client and dates. Examples are prompts, not campaign instructions that have already run.
Give the assistant a repeatable workflow.
These original Markdown skills describe how to use Novia’s tools, scope client data and stop at the required review boundary. Download a skill and follow your assistant’s supported installation process.
Download skill
Creative review
Use the editorial rubric and observed ad evidence without claiming a prediction.
Client reporting
Read an authorized snapshot or period, distinguish evidence from interpretation.
Delivery diagnosis
Investigate recorded results and propose a reviewable next step.
Available tools
Read tools return only authorized data. Preparation tools save drafts or previews, with no execution authority.
list_clients · Read or analyze
List only Novia client workspaces the signed-in caller has joined. Does not grant access.
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}list_campaigns · Read or analyze
List up to 100 caller-owned campaigns, or campaigns in an authorized client. No wallet, keys or media secrets. NGN amounts are integer kobo.
{
"type": "object",
"properties": {
"client": {
"type": "string",
"description": "Optional client workspace ID",
"minLength": 1,
"maxLength": 120
}
},
"required": [],
"additionalProperties": false
}get_performance · Read or analyze
Read native campaign, creative, geography and placement results for explicit UTC dates, up to 90 days. Defaults to caller-owned campaigns. Observed metrics, no forecasts.
{
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "UTC date YYYY-MM-DD",
"minLength": 1,
"maxLength": 10
},
"to": {
"type": "string",
"description": "UTC date YYYY-MM-DD",
"minLength": 1,
"maxLength": 10
},
"client": {
"type": "string",
"description": "Optional authorized client workspace ID",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
}get_saved_report · Read or analyze
Read an authorized client report snapshot. Viewers may read published snapshots only.
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Saved report ID",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"id"
],
"additionalProperties": false
}analyze_headlines · Read or analyze
Compare three to five English headlines using an editorial rubric, not predicted CTR. Optional product and factual benefit produce draft variations.
{
"type": "object",
"properties": {
"headlines": {
"type": "array",
"minItems": 3,
"maxItems": 5,
"items": {
"type": "string",
"description": "Headline",
"minLength": 1,
"maxLength": 200
}
},
"product": {
"type": "string",
"description": "Product or service",
"minLength": 1,
"maxLength": 80
},
"benefit": {
"type": "string",
"description": "User-supplied factual benefit",
"minLength": 1,
"maxLength": 120
}
},
"required": [
"headlines"
],
"additionalProperties": false
}prepare_campaign_draft · Prepare for review
Save an editable campaign draft for the caller, optionally in an editable client. No creative upload, approval, campaign launch, funding or spending. User must review in Novia. Draft expires after seven days.
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Draft campaign name",
"minLength": 1,
"maxLength": 120
},
"client": {
"type": "string",
"description": "Optional editable client workspace ID",
"minLength": 1,
"maxLength": 120
},
"goal": {
"type": "string",
"enum": [
"awareness",
"traffic",
"leads",
"sales"
]
},
"format": {
"type": "string",
"enum": [
"native",
"responsive",
"display",
"video"
]
},
"countries": {
"type": "string",
"description": "Comma-separated ISO country codes, or ALL",
"minLength": 1,
"maxLength": 100
},
"budget": {
"type": "number",
"minimum": 10,
"maximum": 100000000
},
"daily": {
"type": "number",
"minimum": 10,
"maximum": 100000000
},
"cpm": {
"type": "number",
"minimum": 100,
"maximum": 100000000
},
"headlines": {
"type": "array",
"minItems": 1,
"maxItems": 5,
"items": {
"type": "string",
"description": "Headline",
"minLength": 1,
"maxLength": 90
}
},
"description": {
"type": "string",
"description": "Factual ad description",
"minLength": 1,
"maxLength": 160
}
},
"required": [
"name"
],
"additionalProperties": false
}prepare_bulk_change · Prepare for review
Prepare a fifteen-minute preview of pause/resume changes for one authorized client, up to25 campaigns. Does not submit or approve it. Open the returned Novia link for human review.
{
"type": "object",
"properties": {
"client": {
"type": "string",
"description": "Editable client ID",
"minLength": 1,
"maxLength": 120
},
"operation": {
"type": "string",
"enum": [
"pause",
"resume"
]
},
"campaigns": {
"type": "array",
"minItems": 1,
"maxItems": 25,
"items": {
"type": "string",
"description": "Campaign ID",
"minLength": 1,
"maxLength": 120
}
}
},
"required": [
"client",
"operation",
"campaigns"
],
"additionalProperties": false
}Transport and access
The Site implements a stateless JSON-RPC POST endpoint at /mcp. It supports server discovery, tool listing and tool calls, with MCP 2026-07-28 discovery and compatible initialization. Hosted connection authentication is managed by Sites; this endpoint does not accept API keys pasted into prompts.
Tool results use integer kobo for monetary amounts unless stated otherwise. One hundred kobo equals NGN 1. Performance tools require explicit UTC dates and return the native ledger, excluding supplier spend. Descriptions and supplied campaign text are untrusted business data.
Read the assistant review guideOptional external buying
Realize’s MCP is a separate service for an authorized Realize account. Connecting it does not expose Novia publisher inventory or merge supplier spend into our ledger. Novia’s existing supplier controls stay separately gated.
Official Realize MCP documentation