MCP Tools
Projects

list_projects

List all projects visible to you. Projects organize content into workstreams; use a project's ID to fetch its details or to associate new content with it.

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "required": [
    "projects"
  ],
  "properties": {
    "projects": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "link_url"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "Project ID. Pass to get_project or use when creating content."
          },
          "name": {
            "type": "string",
            "description": "Project name."
          },
          "status": {
            "type": "string",
            "description": "Project status (e.g. active, archived)."
          },
          "link_url": {
            "type": "string",
            "format": "uri",
            "description": "Direct URL to view this project in the Marcora app."
          },
          "created_by": {
            "type": "string",
            "description": "Name of the project creator."
          },
          "visibility": {
            "type": "string",
            "description": "Visibility (e.g. team, private)."
          },
          "member_count": {
            "type": "integer",
            "description": "Number of project members."
          },
          "content_count": {
            "type": "integer",
            "description": "Number of content items in this project."
          }
        }
      }
    }
  }
}

Instructions

Returns all projects visible to the current user. Projects organize content into workstreams. Use the 'id' with get_project to retrieve project details, or pass project_id when creating content to associate it with a project.

Clients that previously read the bare array must now read response.projects.

Parameters: none — this tool takes no input.

Links: present link_url to the user exactly as returned — copy it character for character. Never retype, shorten, or rebuild a link or the IDs inside it.

Scroll to Top