Simplicate MCP Server

Instructions

Implementation Reference

• src/mcp/server-full.ts:262-269 (registration)

  Registration of the 'get_task' tool in the ListTools handler, including name, description, and input schema definition

    name: 'get_task',
    description: 'Get specific task by ID',
    inputSchema: {
      type: 'object',
      properties: { task_id: { type: 'string' } },
      required: ['task_id'],
    },
  },

• src/mcp/server-full.ts:500-503 (handler)

  Handler for the 'get_task' tool call: validates task_id parameter and delegates to SimplicateServiceExtended.getTaskById, returning JSON stringified response

  case 'get_task': {
    if (!toolArgs.task_id) throw new Error('task_id is required');
    const data = await this.simplicateService.getTaskById(toolArgs.task_id);
    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };

• src/simplicate/services-extended.ts:516-519 (helper)

  Core helper method that performs the actual API call to retrieve a task by ID from Simplicate /projects/task/{taskId} endpoint

  async getTaskById(taskId: string): Promise<SimplicateTask> {
    const response = await this.client.get(`/projects/task/${taskId}`);
    return response.data;
  }

• src/simplicate/services-extended.ts:166-174 (schema)

  TypeScript interface defining the structure of a SimplicateTask object returned by getTaskById

  export interface SimplicateTask {
    id: string;
    title: string;
    description?: string;
    project?: { id: string; name: string };
    assignee?: { id: string; name: string };
    status: string;
    due_date?: string;
  }