MCPMCP Tools/Post Ideas/create_post_idea

create_post_idea

Writeideas:write

Create (or idempotently upsert) a post idea generated by the agent for a location. Use the same `externalId` on retries to avoid duplicates. `origin` decides review: channel/routine ideas land pending (inbox review); os_button ideas are immediate drafts.

Parameters

locationIdstringrequired

The location's id (from list_locations) this idea belongs to.

titlestringrequired

Short idea title.

contentstringoptional

Post caption / body.

externalIdstringrequired

Stable id from the agent — the idempotency key.

origin"channel" | "routine" | "os_button"required

Where the request came from.

Idea type.

bucket"idea" | "holiday" | "calendar" | "series"optional

Bucket. Default "idea".

platformsstring[]optional

Target platforms, e.g. ["google","facebook"].

imageUrlstringoptional

Pre-generated image URL, if any.

imagePromptstringoptional

Prompt to generate an image later, if any.

seriesIdstringoptional

Series id, if part of a content series.

scheduledDatestringoptional

Suggested date (YYYY-MM-DD).

scheduledTimestringoptional

Suggested time (HH:mm).

generationJobIdstringoptional

Originating brain job/run id, for traceability.

Example request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_post_idea",
    "arguments": {
      "locationId": "string",
      "title": "string",
      "externalId": "string",
      "origin": "channel"
    }
  }
}

Example response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "..."
      }
    ]
  }
}

Response shape shown for illustration — the actual content depends on the tool and your data.