campaignPlanGetReturns an owned AI plan, its exact version, conversation, saved image ideas, current planning job and available/reserved AI credits. Image job access depends on the current connection permissions and visible tools.
| Name | Required | Description | Default |
|---|---|---|---|
| planPublicId | Yes |
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Changes observed during successful MCP inspections.
Output schema / $defs / __schema22 / descriptionAdded value: +"Provider identifier returned by the account's integrations or integrationSchema. Availability is checked for the current account."Output schema / $defs / __schema22 / enumRemoved value: -[
- "bluesky",
- "devto",
- "discord",
- "discourse",
- "facebook",
- "ghost",
- "hashnode",
- "instagram-standalone",
- "linkedin",
- "linkedin-page",
- "listmonk",
- "mastodon",
- "matrix",
- "mattermost",
- "misskey",
- "nostr",
- "peertube",
- "pinterest",
- "pixelfed",
- "plurk",
- "slack",
- "teams",
- "telegram",
- "threads",
- "tiktok",
- "tumblr",
- "twitch",
- "wordpress",
- "wrapcast",
- "x",
- "youtube"
-]Output schema / $defs / __schema28 / properties / providerKey / descriptionAdded value: +"Provider identifier returned by the account's integrations or integrationSchema. Availability is checked for the current account."Output schema / $defs / __schema28 / properties / providerKey / enumRemoved value: -[
- "x",
- "linkedin",
- "linkedin-page",
- "reddit",
- "instagram",
- "instagram-standalone",
- "facebook",
- "threads",
- "youtube",
- "gmb",
- "tiktok",
- "pinterest",
- "dribbble",
- "discord",
- "slack",
- "kick",
- "twitch",
- "mastodon",
- "bluesky",
- "lemmy",
- "wrapcast",
- "telegram",
- "signal",
- "nostr",
- "vk",
- "devto",
- "hashnode",
- "wordpress",
- "ghost",
- "discourse",
- "listmonk",
- "moltbook",
- "whop",
- "mewe",
- "tumblr",
- "pixelfed",
- "plurk",
- "misskey",
- "mattermost",
- "matrix",
- "teams",
- "peertube"
-]Output schema / $defs / __schema48 / descriptionAdded value: +"Provider identifier returned by the account's integrations or integrationSchema. Availability is checked for the current account."Output schema / $defs / __schema48 / enumRemoved value: -[
- "x",
- "linkedin",
- "linkedin-page",
- "reddit",
- "instagram",
- "instagram-standalone",
- "facebook",
- "threads",
- "youtube",
- "gmb",
- "tiktok",
- "pinterest",
- "dribbble",
- "discord",
- "slack",
- "kick",
- "twitch",
- "mastodon",
- "bluesky",
- "lemmy",
- "wrapcast",
- "telegram",
- "signal",
- "nostr",
- "vk",
- "devto",
- "hashnode",
- "wordpress",
- "ghost",
- "discourse",
- "listmonk",
- "moltbook",
- "whop",
- "mewe",
- "tumblr",
- "pixelfed",
- "plurk",
- "misskey",
- "mattermost",
- "matrix",
- "teams",
- "peertube"
-]Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "ok": {
- "const": true,
- "type": "boolean"
- },
- "output": {
- "additionalProperties": false,
- "properties": {
- "availableCredits": {
- "minimum": 0,
- "type": "number"
- },
- "enabled": {
- "type": "boolean"
- },
- "generationCreditHold": {
- "minimum": 0,
- "type": "number"
- },
- "imageGenerationEnabled": {
- "type": "boolean"
- },
- "latestRun": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "createdAt": {
- "$ref": "#/$defs/__schema0"
- },
- "deadline": {
- "$ref": "#/$defs/__schema0"
- },
- "errorCode": {
- "maxLength": 128,
- "type": "string"
- },
- "planPublicId": {
- "$ref": "#/$defs/__schema1"
- },
- "publicId": {
- "$ref": "#/$defs/__schema1"
- },
- "status": {
- "enum": [
- "queued",
- "running",
- "completed",
- "failed",
- "canceled"
- ],
- "type": "string"
- }
- },
- "required": [
- "createdAt",
- "deadline",
- "planPublicId",
- "publicId",
- "status"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "reservedCredits": {
- "minimum": 0,
- "type": "number"
- },
- "selected": {
- "additionalProperties": false,
- "properties": {
- "context": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "brandProfileRevisionPublicId": {
- "anyOf": [
- {
- "$ref": "#/$defs/__schema2"
- },
- {
- "type": "null"
- }
- ]
- },
- "brandProfileSha256": {
- "anyOf": [
- {
- "maxLength": 128,
- "minLength": 1,
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "companyIdentity": {
- "maxLength": 2048,
- "minLength": 1,
- "type": "string"
- },
- "guidelines": {
- "additionalProperties": false,
- "properties": {
- "approvedClaims": {
- "$ref": "#/$defs/__schema3"
- },
- "companyDescription": {
- "$ref": "#/$defs/__schema5"
- },
- "companyName": {
- "$ref": "#/$defs/__schema6"
- },
- "examples": {
- "$ref": "#/$defs/__schema3"
- },
- "preferences": {
- "$ref": "#/$defs/__schema3"
- },
- "voiceRules": {
- "$ref": "#/$defs/__schema3"
- }
- },
- "required": [
- "approvedClaims",
- "companyDescription",
- "companyName",
- "examples",
- "preferences",
- "voiceRules"
- ],
- "type": "object"
- },
- "guidelinesVersion": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "brandProfileRevisionPublicId",
- "brandProfileSha256",
- "companyIdentity",
- "guidelines",
- "guidelinesVersion"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "contextStale": {
- "type": "boolean"
- },
- "conversation": {
- "items": {
- "$ref": "#/$defs/__schema7"
- },
- "maxItems": 40,
- "type": "array"
- },
- "conversationMediaAssetIds": {
- "items": {
- "$ref": "#/$defs/__schema1"
- },
- "maxItems": 6,
- "type": "array"
- },
- "conversationTargets": {
- "items": {
- "$ref": "#/$defs/__schema28"
- },
- "maxItems": 24,
- "type": "array"
- },
- "conversationWhatsAppTargets": {
- "items": {
- "$ref": "#/$defs/__schema32"
- },
- "maxItems": 24,
- "type": "array"
- },
- "document": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "brief": {
- "maxLength": 4000,
- "type": "string"
- },
- "defaultTargets": {
- "items": {
- "$ref": "#/$defs/__schema46"
- },
- "maxItems": 24,
- "type": "array"
- },
- "defaultWhatsAppTargets": {
- "items": {
- "$ref": "#/$defs/__schema32"
- },
- "maxItems": 24,
- "type": "array"
- },
- "groups": {
- "items": {
- "$ref": "#/$defs/__schema49"
- },
- "maxItems": 12,
- "minItems": 1,
- "type": "array"
- },
- "timezone": {
- "maxLength": 100,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "brief",
- "groups",
- "timezone"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "preferences": {
- "additionalProperties": false,
- "properties": {
- "composition": {
- "enum": [
- "post",
- "campaign"
- ],
- "type": "string"
- },
- "optimizePerDestination": {
- "type": "boolean"
- },
- "useBrandContext": {
- "type": "boolean"
- }
- },
- "required": [
- "composition",
- "optimizePerDestination",
- "useBrandContext"
- ],
- "type": "object"
- },
- "publicId": {
- "$ref": "#/$defs/__schema1"
- },
- "receipt": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "approvedAt": {
- "$ref": "#/$defs/__schema0"
- },
- "campaigns": {
- "items": {
- "$ref": "#/$defs/__schema53"
- },
- "maxItems": 12,
- "type": "array"
- }
- },
- "required": [
- "approvedAt",
- "campaigns"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "status": {
- "enum": [
- "draft",
- "approved"
- ],
- "type": "string"
- },
- "title": {
- "maxLength": 200,
- "type": "string"
- },
- "version": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "context",
- "contextStale",
- "document",
- "preferences",
- "publicId",
- "receipt",
- "status",
- "title",
- "version"
- ],
- "type": "object"
- }
- },
- "required": [
- "availableCredits",
- "enabled",
- "generationCreditHold",
- "imageGenerationEnabled",
- "latestRun",
- "reservedCredits",
- "selected"
- ],
- "type": "object"
- },
- "toolName": {
- "const": "campaignPlanGet",
- "type": "string"
- }
- },
- "required": [
- "ok",
- "output",
- "toolName"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "error": {
- "additionalProperties": false,
- "properties": {
- "code": {
- "enum": [
- "INVALID_INPUT",
- "FORBIDDEN",
- "NOT_FOUND",
- "CONFLICT",
- "FEATURE_DISABLED",
- "CONFIRMATION_REQUIRED",
- "CONFIRMATION_INVALID",
- "UPSTREAM_FAILED",
- "NEEDS_REVIEW",
- "INTERNAL"
- ],
- "type": "string"
- },
- "message": {
- "maxLength": 2048,
- "minLength": 1,
- "type": "string"
- },
- "retryable": {
- "type": "boolean"
- }
- },
- "required": [
- "code",
- "message",
- "retryable"
- ],
- "type": "object"
- },
- "ok": {
- "const": false,
- "type": "boolean"
- },
- "toolName": {
- "const": "campaignPlanGet",
- "type": "string"
- }
- },
- "required": [
- "error",
- "ok",
- "toolName"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "ok": {
+ "const": true,
+ "type": "boolean"
+ },
+ "output": {
+ "additionalProperties": false,
+ "properties": {
+ "availableCredits": {
+ "minimum": 0,
+ "type": "number"
+ },
+ "enabled": {
+ "type": "boolean"
+ },
+ "generationCreditHold": {
+ "minimum": 0,
+ "type": "number"
+ },
+ "imageGenerationEnabled": {
+ "type": "boolean"
+ },
+ "latestRun": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "createdAt": {
+ "$ref": "#/$defs/__schema0"
+ },
+ "deadline": {
+ "$ref": "#/$defs/__schema0"
+ },
+ "errorCode": {
+ "maxLength": 128,
+ "type": "string"
+ },
+ "planPublicId": {
+ "$ref": "#/$defs/__schema1"
+ },
+ "publicId": {
+ "$ref": "#/$defs/__schema1"
+ },
+ "status": {
+ "enum": [
+ "queued",
+ "running",
+ "completed",
+ "failed",
+ "canceled"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "createdAt",
+ "deadline",
+ "planPublicId",
+ "publicId",
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "reservedCredits": {
+ "minimum": 0,
+ "type": "number"
+ },
+ "selected": {
+ "additionalProperties": false,
+ "properties": {
+ "aiSchedulingAllowance": {
+ "additionalProperties": false,
+ "properties": {
+ "limit": {
+ "anyOf": [
+ {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "nextAvailableAt": {
+ "anyOf": [
+ {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "remaining": {
+ "anyOf": [
+ {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "required": [
+ "limit",
+ "nextAvailableAt",
+ "remaining"
+ ],
+ "type": "object"
+ },
+ "context": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "brandProfileRevisionPublicId": {
+ "anyOf": [
+ {
+ "$ref": "#/$defs/__schema2"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "brandProfileSha256": {
+ "anyOf": [
+ {
+ "maxLength": 128,
+ "minLength": 1,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "companyIdentity": {
+ "maxLength": 2048,
+ "minLength": 1,
+ "type": "string"
+ },
+ "guidelines": {
+ "additionalProperties": false,
+ "properties": {
+ "approvedClaims": {
+ "$ref": "#/$defs/__schema3"
+ },
+ "companyDescription": {
+ "$ref": "#/$defs/__schema5"
+ },
+ "companyName": {
+ "$ref": "#/$defs/__schema6"
+ },
+ "examples": {
+ "$ref": "#/$defs/__schema3"
+ },
+ "preferences": {
+ "$ref": "#/$defs/__schema3"
+ },
+ "voiceRules": {
+ "$ref": "#/$defs/__schema3"
+ }
+ },
+ "required": [
+ "approvedClaims",
+ "companyDescription",
+ "companyName",
+ "examples",
+ "preferences",
+ "voiceRules"
+ ],
+ "type": "object"
+ },
+ "guidelinesVersion": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "brandProfileRevisionPublicId",
+ "brandProfileSha256",
+ "companyIdentity",
+ "guidelines",
+ "guidelinesVersion"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "contextStale": {
+ "type": "boolean"
+ },
+ "conversation": {
+ "items": {
+ "$ref": "#/$defs/__schema7"
+ },
+ "maxItems": 40,
+ "type": "array"
+ },
+ "conversationMediaAssetIds": {
+ "items": {
+ "$ref": "#/$defs/__schema1"
+ },
+ "maxItems": 6,
+ "type": "array"
+ },
+ "conversationTargets": {
+ "items": {
+ "$ref": "#/$defs/__schema28"
+ },
+ "maxItems": 24,
+ "type": "array"
+ },
+ "conversationWhatsAppTargets": {
+ "items": {
+ "$ref": "#/$defs/__schema32"
+ },
+ "maxItems": 24,
+ "type": "array"
+ },
+ "document": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "brief": {
+ "maxLength": 4000,
+ "type": "string"
+ },
+ "defaultTargets": {
+ "items": {
+ "$ref": "#/$defs/__schema46"
+ },
+ "maxItems": 24,
+ "type": "array"
+ },
+ "defaultWhatsAppTargets": {
+ "items": {
+ "$ref": "#/$defs/__schema32"
+ },
+ "maxItems": 24,
+ "type": "array"
+ },
+ "groups": {
+ "items": {
+ "$ref": "#/$defs/__schema49"
+ },
+ "maxItems": 12,
+ "minItems": 1,
+ "type": "array"
+ },
+ "timezone": {
+ "maxLength": 100,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "brief",
+ "groups",
+ "timezone"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "preferences": {
+ "additionalProperties": false,
+ "properties": {
+ "composition": {
+ "enum": [
+ "post",
+ "campaign"
+ ],
+ "type": "string"
+ },
+ "optimizePerDestination": {
+ "type": "boolean"
+ },
+ "useBrandContext": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "composition",
+ "optimizePerDestination",
+ "useBrandContext"
+ ],
+ "type": "object"
+ },
+ "publicId": {
+ "$ref": "#/$defs/__schema1"
+ },
+ "receipt": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "approvedAt": {
+ "$ref": "#/$defs/__schema0"
+ },
+ "campaigns": {
+ "items": {
+ "$ref": "#/$defs/__schema53"
+ },
+ "maxItems": 12,
+ "type": "array"
+ }
+ },
+ "required": [
+ "approvedAt",
+ "campaigns"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "status": {
+ "enum": [
+ "draft",
+ "approved"
+ ],
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 200,
+ "type": "string"
+ },
+ "version": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "context",
+ "contextStale",
+ "document",
+ "preferences",
+ "publicId",
+ "receipt",
+ "status",
+ "title",
+ "version"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "availableCredits",
+ "enabled",
+ "generationCreditHold",
+ "imageGenerationEnabled",
+ "latestRun",
+ "reservedCredits",
+ "selected"
+ ],
+ "type": "object"
+ },
+ "toolName": {
+ "const": "campaignPlanGet",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ok",
+ "output",
+ "toolName"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "error": {
+ "additionalProperties": false,
+ "properties": {
+ "code": {
+ "enum": [
+ "AI_SCHEDULING_LIMIT_REACHED",
+ "AI_SCHEDULING_UNAVAILABLE",
+ "INVALID_INPUT",
+ "FORBIDDEN",
+ "NOT_FOUND",
+ "CONFLICT",
+ "FEATURE_DISABLED",
+ "CONFIRMATION_REQUIRED",
+ "CONFIRMATION_INVALID",
+ "UPSTREAM_FAILED",
+ "NEEDS_REVIEW",
+ "INTERNAL"
+ ],
+ "type": "string"
+ },
+ "message": {
+ "maxLength": 2048,
+ "minLength": 1,
+ "type": "string"
+ },
+ "retryable": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "code",
+ "message",
+ "retryable"
+ ],
+ "type": "object"
+ },
+ "ok": {
+ "const": false,
+ "type": "boolean"
+ },
+ "toolName": {
+ "const": "campaignPlanGet",
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "ok",
+ "toolName"
+ ],
+ "type": "object"
+ }
+]Output schema / $defs / __schema31 / anyOfPrevious value: -[
- {
- "maxLength": 8192,
- "type": "string"
- },
- {
- "type": "number"
- },
- {
- "type": "boolean"
- },
- {
- "type": "null"
- },
- {
- "items": {
- "$ref": "#/$defs/__schema31"
- },
- "maxItems": 512,
- "type": "array"
- },
- {
- "additionalProperties": {
- "$ref": "#/$defs/__schema31"
- },
- "propertyNames": {
- "$ref": "#/$defs/__schema30"
- },
- "type": "object"
- }
-]New value: +[
+ {
+ "maxLength": 8192,
+ "type": "string"
+ },
+ {
+ "type": "number"
+ },
+ {
+ "type": "boolean"
+ },
+ {
+ "type": "null"
+ },
+ {
+ "items": {
+ "$ref": "#/$defs/__schema31"
+ },
+ "maxItems": 2000,
+ "type": "array"
+ },
+ {
+ "additionalProperties": {
+ "$ref": "#/$defs/__schema31"
+ },
+ "propertyNames": {
+ "$ref": "#/$defs/__schema30"
+ },
+ "type": "object"
+ }
+]Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare read-only, idempotent, non-destructive, and closed-world behavior, so the description does not need to restate safety. It adds useful behavioral context by listing the returned artifacts and warning that image job access depends on connection permissions and visible tools.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two focused sentences, front-loaded with what the tool returns. The second sentence adds a relevant permission caveat without unnecessary detail.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the output schema and rich read-only annotations, the description is sufficiently complete about return contents and permission sensitivity. The main remaining gap is that the sole input parameter is not described anywhere, and sibling usage is not clarified.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 0% description coverage, so the description must compensate for the lone required parameter. It never mentions planPublicId or explains what identifier is expected, leaving parameter meaning only inferable from the name and schema constraints.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a clear read verb and names the specific resource: an owned AI plan, with exact version, conversation, image ideas, planning job, and credits. It distinguishes the tool as a getter in practice, but it does not explicitly contrast it with siblings such as campaignPlanGenerate or campaignGet.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It implies the tool retrieves plan details by ID, but it gives no explicit when-to-use guidance or alternatives. The note about image job access depending on connection permissions and visible tools is a caveat, not usage direction.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.