get-project-list
Retrieve a paginated list of active projects you belong to in Dooray, excluding archived projects, for browsing when no specific project is identified.
Instructions
Get list of active projects that you belong to.
This tool retrieves only active projects where you are a member. Archived projects are excluded.
Note: Returns compact response with essential fields only. For complete project details, use get-project.
IMPORTANT: When the user provides a specific Dooray URL (e.g., "https://nhnent.dooray.com/task/PROJECT_ID"), do NOT use this tool. Instead, extract the PROJECT_ID from the URL and call get-project directly to get information about that specific project.
This tool is for browsing your active projects when no specific project URL or ID is provided.
Examples:
Get all your active projects: {} (empty parameters)
Get second page with 50 items: {"page": 1, "size": 50}
Returns a paginated list with project id and name (project code) for each project.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for pagination (default: 0) | |
| size | No | Number of items per page (default: 20, max: 100) |
Implementation Reference
- The main handler function getProjectListHandler that fetches the project list from the API, filters it, and returns a formatted JSON response or error.
export async function getProjectListHandler(args: GetProjectListInput) { try { const result = await projectsApi.getProjects({ page: args.page, size: args.size, }); // Filter to compact response to reduce token usage const compactResult = filterPaginatedResponse(result, filterProjectForList); return { content: [ { type: 'text', text: JSON.stringify(compactResult, null, 2), }, ], }; } catch (error) { return { content: [ { type: 'text', text: `Error: ${formatError(error)}`, }, ], isError: true, }; } } - Zod schema getProjectListSchema used for input validation in the server.
export const getProjectListSchema = z.object({ page: z.number().min(0).optional().describe('Page number for pagination (default: 0)'), size: z.number().min(1).max(100).optional().describe('Number of items per page (default: 20, max: 100)'), }); - src/index.ts:48-48 (registration)Registration of the tool in the toolRegistry map used by the MCP server for handling tool calls.
'get-project-list': { handler: getProjectListHandler, schema: getProjectListSchema }, - src/index.ts:20-20 (registration)Import statement bringing in the tool components.
import { getProjectListTool, getProjectListHandler, getProjectListSchema } from './tools/projects/get-project-list.js'; - Tool metadata object getProjectListTool with name, description, and JSON inputSchema for tool discovery in list_tools.
export const getProjectListTool = { name: 'get-project-list', description: `Get list of active projects that you belong to. This tool retrieves only active projects where you are a member. Archived projects are excluded. **Note**: Returns compact response with essential fields only. For complete project details, use get-project. **IMPORTANT**: When the user provides a specific Dooray URL (e.g., "https://nhnent.dooray.com/task/PROJECT_ID"), do NOT use this tool. Instead, extract the PROJECT_ID from the URL and call get-project directly to get information about that specific project. This tool is for browsing your active projects when no specific project URL or ID is provided. Examples: - Get all your active projects: {} (empty parameters) - Get second page with 50 items: {"page": 1, "size": 50} Returns a paginated list with project id and name (project code) for each project.`, inputSchema: { type: 'object', properties: { page: { type: 'number', description: 'Page number for pagination (default: 0)', minimum: 0, }, size: { type: 'number', description: 'Number of items per page (default: 20, max: 100)', minimum: 1, maximum: 100, }, }, }, };