Simplicate MCP Server

Instructions

Implementation Reference

• src/mcp/server-full.ts:406-408 (handler)

  MCP CallToolRequestSchema handler case for 'create_project' tool. Delegates execution to SimplicateServiceExtended.createProject with tool arguments and formats response as MCP content.

  case 'create_project': {
    const data = await this.simplicateService.createProject(toolArgs);
    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };

• src/mcp/server-full.ts:64-78 (registration)

  Tool registration in ListToolsRequestSchema handler. Defines name, description, and input schema validation for 'create_project'.

  {
    name: 'create_project',
    description: 'Create a new project',
    inputSchema: {
      type: 'object',
      properties: {
        name: { type: 'string', description: 'Project name' },
        organization_id: { type: 'string', description: 'Organization ID' },
        project_manager_id: { type: 'string', description: 'Project manager employee ID' },
        start_date: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
        budget: { type: 'number', description: 'Project budget' },
      },
      required: ['name'],
    },
  },

• src/simplicate/services-extended.ts:256-259 (helper)

  Supporting utility method in SimplicateServiceExtended that performs the actual HTTP POST request to Simplicate API endpoint '/projects/project' to create the project.

  async createProject(data: Partial<SimplicateProject>): Promise<SimplicateProject> {
    const response = await this.client.post('/projects/project', data);
    return response.data;
  }

• src/simplicate/services-extended.ts:9-19 (schema)

  TypeScript interface defining the SimplicateProject structure used for input/output typing in createProject method.

  export interface SimplicateProject {
    id: string;
    name: string;
    project_number: string;
    organization?: { id: string; name: string };
    project_manager?: { id: string; name: string };
    start_date?: string;
    end_date?: string;
    budget?: number;
    status?: string;
  }