get_post_idea

Get post idea

Read one generated idea and its existing draft link.

Authorization and permissions

Requires a valid delegated OAuth token and access to the selected workspace.

OAuth scope: mcp:read
Workspace requirement: Authorized workspace and current membership required

Current workspace member.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "idea_id": {
      "description": "Idea id.",
      "minimum": 1,
      "type": "integer"
    },
    "team_id": {
      "description": "Consented workspace ID.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "team_id",
    "idea_id"
  ],
  "type": "object"
}

Result schema

{
  "additionalProperties": false,
  "properties": {
    "idea": {
      "additionalProperties": false,
      "description": "Idea.",
      "properties": {
        "content": {
          "description": "Content.",
          "type": "string"
        },
        "id": {
          "description": "Id.",
          "minimum": 1,
          "type": "integer"
        },
        "order": {
          "description": "Order.",
          "minimum": 0,
          "type": "integer"
        },
        "post_id": {
          "description": "Post id.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "id",
        "content",
        "order",
        "post_id"
      ],
      "type": "object"
    }
  },
  "required": [
    "idea"
  ],
  "type": "object"
}

Example arguments

{
  "idea_id": 381,
  "team_id": 42
}

Example result

{
  "idea": {
    "content": "Ten customer interviews revealed that onboarding friction starts before the first login.",
    "id": 381,
    "order": 0,
    "post_id": null
  }
}

Errors and retry

Requires current workspace membership; conversion also requires draft creation permission or an owned profile. Unknown and cross-workspace source/idea IDs return not found. Source creation accepts public HTTPS HTML only (1 MB maximum); fetch failures appear asynchronously in status=failed and error. AI usage is tracked and mcp:ai creation is limited to 30 calls per user per hour; no additional MCP AI quota is enforced.

Reads are safe to retry and pending/processing sources should be polled with get_content_source. Before retrying source creation after an ambiguous response, list sources to avoid duplicate jobs. Idea conversion is atomic and returns the existing draft on retry; read state before retrying deletion.

Effects, limits, and source

Workspace roles, subscription and AI usage limits, approval rules, and server rate limits are enforced at call time. Rate-limit responses identify when to retry; scheduled work returns state rather than holding the request open.

services.repurposing.get_idea