MCP Tools
Plans

list_plans

List plans visible to the authenticated user with filters and pagination.

Input Schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "description": "Page number (default 1)."
    },
    "sort": {
      "type": "string",
      "description": "\"due_asc_nulls_last\" (default) | \"created_desc\"."
    },
    "stage": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by stage. Use UNDERSCORE form (e.g. In_Process). Allowed: Suggested, Accepted, In_Process, Complete, Dismissed. Only the first element is honored currently."
    },
    "source": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter by source. Allowed: user_added, cora_proactive, cora_requested, workflow, playbook. Only the first element is honored currently."
    },
    "per_page": {
      "type": "integer",
      "description": "Items per page (default 20, max 100)."
    },
    "due_after": {
      "type": "string",
      "description": "ISO date YYYY-MM-DD. Note: does not apply yet."
    },
    "due_before": {
      "type": "string",
      "description": "ISO date YYYY-MM-DD. Note: does not apply yet."
    },
    "project_id": {
      "type": "string",
      "description": "Filter to plans associated with this project UUID."
    },
    "category_id": {
      "type": "integer",
      "description": "Filter to plans in this content category (integer ID)."
    },
    "search_text": {
      "type": "string",
      "description": "Substring match on plan title. Note: does not apply yet."
    },
    "assignee_scope": {
      "type": "string",
      "description": "Whose plans to return. \"me\" (default) | \"created_by_me\" | \"all_visible\"."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "stage": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "due_date": {
            "type": "string"
          },
          "plan_uuid": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "created_by": {
            "type": "integer"
          },
          "updated_at": {
            "type": "string"
          },
          "assigned_to": {
            "type": "integer"
          },
          "produced_content_id": {
            "type": "string"
          }
        }
      }
    },
    "curPage": {
      "type": "integer"
    },
    "nextPage": {
      "type": "integer"
    },
    "prevPage": {
      "type": "integer"
    },
    "itemsTotal": {
      "type": "integer"
    }
  }
}

Instructions

Returns a paginated list of plans visible to the authenticated user. Use filters to narrow results by stage, source, project, or category.

Stage filter values: Use UNDERSCORE form — In_Process (not In Process). Allowed: Suggested, Accepted, In_Process, Complete, Dismissed. Note: only the first array element is honored currently.

Source filter values: user_added, cora_proactive, cora_requested, workflow, playbook. Note: only the first array element is honored currently.

Assignee scope: me (default — plans assigned to you), created_by_me (plans you created), all_visible (all plans visible to you).

Sorting: due_asc_nulls_last (default — soonest due date first, nulls last) or created_desc (newest first).

Pagination: Use page and per_page (max 100). The response includes nextPage and prevPage for traversal.

Note: due_before, due_after, and search_text filters are accepted but do not apply yet.

Scroll to Top