PRIMARY tool for connection sanity-check: returns 'pong: '. DISTINCT from weeek_get_me — ping makes NO Weeek API call (no token required, no network), so it stays green even when WEEEK_ACCESS_TOKEN is missing or expired. Use when the agent first connects to verify the MCP transport itself is alive before reaching for any weeek_* tool.

PRIMARY tool for confirming WEEEK_ACCESS_TOKEN works against the live API. Returns {id, email, name} for the Weeek account that owns the configured token. DISTINCT from ping (which never reaches the network) — a successful weeek_get_me proves both transport AND credentials. Use when an agent is about to run weeek_list_* / weeek_get_* and wants a one-shot token sanity-check first.

PRIMARY tool for project discovery: returns every Weeek project visible to the configured token ({id, title, color, isPrivate} per project). No filters; pagination is not exposed by this endpoint. Use when the agent needs a project_id to feed into weeek_list_tasks or to surface the project picker to the user.

PRIMARY tool for fetching a single Weeek project's full detail by id, including description ({id, title, description, color, isPrivate}). DISTINCT from weeek_list_projects, which returns summaries only ({id, title, color, isPrivate}) without descriptions and without support for fetching by id. Use when you already know the project id (from weeek_list_projects or the Weeek UI) and need the description or want to confirm a single project still exists. Unknown ids surface as weeek_get_project failed (weeek_not_found).

PRIMARY tool for task discovery and filtering: returns one page of Weeek tasks filtered by project_id / board_id / board_column_id / assignee_id / completed, paginated by offset+per_page (default 20, max 100). Use the filters to locate the card a write tool is about to act on instead of paging a whole project. DISTINCT from weeek_get_task — this returns task summaries (no description / details); fetch a single full task via weeek_get_task. Use when the agent needs a list view; follow hasMore for the next page.

PRIMARY tool for fetching a single Weeek task by task_id ({id, title, description, completed, projectId, priority, type}). DISTINCT from weeek_list_tasks — this is the only tool that returns the full description field. Use when an agent already has a specific id and needs full details; unknown ids surface as weeek_get_task failed (weeek_not_found): ….

PRIMARY tool for member discovery: returns every member of the configured Weeek workspace ({id, email, firstName, lastName} per member). DISTINCT from weeek_get_me — that returns the caller; this returns every workspace participant. Member id is a string (unlike most Weeek resources). Use when an agent needs to resolve a name/email to a member id.

PRIMARY tool for tag discovery: returns every tag defined in the configured Weeek workspace ({id, title, color} per tag). No pagination. Use when an agent needs to map a user-supplied tag name to a stable tag id (Weeek tasks reference tags by id).

PRIMARY tool for board discovery within a project: returns every Weeek board in the given project ({id, name, projectId, isPrivate} per board). project_id is required; pagination is not exposed by this endpoint. Use when the agent needs a board_id to feed into weeek_list_board_columns, or to surface the board picker for a project.

PRIMARY tool for board-column discovery: returns every column of a Weeek board ({id, name, boardId} per column) in upstream sort order (preserved verbatim — the array order is the signal). board_id is required. Use when the agent needs a board's column/stage layout, e.g. to interpret a task's status or drive a board view.