Simplicate MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Implementation Reference

• src/mcp/server-full.ts:45-54 (registration)

  Registration of the 'get_projects' tool including input schema definition
  name: 'get_projects', description: 'Retrieve a list of all projects', inputSchema: { type: 'object', properties: { limit: { type: 'number', description: 'Maximum number to return (default: 10)' }, offset: { type: 'number', description: 'Number to skip for pagination' }, }, }, },
• src/mcp/server-full.ts:394-400 (handler)

  Handler logic for executing the 'get_projects' tool, delegates to SimplicateServiceExtended.getProjects and formats response as MCP content
  case 'get_projects': { const data = await this.simplicateService.getProjects({ limit: (toolArgs.limit as number) || 10, offset: (toolArgs.offset as number) || 0, }); return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] }; }
• src/simplicate/services-extended.ts:246-249 (helper)

  Core helper function that performs the API call to retrieve projects from Simplicate backend
  async getProjects(params?: { limit?: number; offset?: number }): Promise<SimplicateProject[]> { const response = await this.client.get('/projects/project', params); return response.data || []; }
• src/simplicate/services-extended.ts:9-19 (schema)

  TypeScript interface defining the structure of a SimplicateProject, used for type safety in getProjects response
  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; }
• src/mcp/server.ts:193-206 (handler)

  Alternative handler in basic server variant, identical logic delegating to SimplicateService.getProjects
  case 'get_projects': { const projects = await this.simplicateService.getProjects({ limit: (toolArgs.limit as number) || 10, offset: (toolArgs.offset as number) || 0, }); return { content: [ { type: 'text', text: JSON.stringify(projects, null, 2), }, ], }; }