list_post_ideas

List post ideas

Page generated ideas for a workspace source.

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": {
    "limit": {
      "default": 20,
      "description": "Limit.",
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Offset.",
      "minimum": 0,
      "type": "integer"
    },
    "source_id": {
      "description": "Public content-source sqid.",
      "maxLength": 32,
      "minLength": 1,
      "type": "string"
    },
    "team_id": {
      "description": "Consented workspace ID.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "team_id",
    "source_id"
  ],
  "type": "object"
}

Result schema

{
  "additionalProperties": false,
  "properties": {
    "has_more": {
      "description": "Has more.",
      "type": "boolean"
    },
    "ideas": {
      "description": "Ideas.",
      "items": {
        "additionalProperties": false,
        "description": "Ideas item.",
        "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"
      },
      "type": "array"
    }
  },
  "required": [
    "ideas",
    "has_more"
  ],
  "type": "object"
}

Example arguments

{
  "limit": 20,
  "offset": 0,
  "source_id": "S4n8Qp2L",
  "team_id": 42
}

Example result

{
  "has_more": false,
  "ideas": [
    {
      "content": "Ten customer interviews revealed that onboarding friction starts before the first login.",
      "id": 381,
      "order": 0,
      "post_id": null
    },
    {
      "content": "The best onboarding questions focus on the customer's last real attempt, not their ideal workflow.",
      "id": 382,
      "order": 1,
      "post_id": "R8m3Nk2V"
    }
  ]
}

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_content_source