feat(gupy): list candidate professional experiences for a job

- add fields param to list_applications (name|id|code|all)
- add list_application_experiences tool that queries applications with
  fields=all and returns a clean per-candidate work experience summary

Author: Joao208

packages/gupy/src/server.ts

@@ -8,6 +8,7 @@ import {
   GetJobParamsSchema,
   UpdateJobStatusParamsSchema,
   ListApplicationsParamsSchema,
+  ListApplicationExperiencesParamsSchema,
   MoveApplicationParamsSchema,
   CreateApplicationCommentParamsSchema,
   ListApplicationCommentsParamsSchema,
@@ -100,7 +101,7 @@ export class GupyMCPServer {
       {
         title: "List Applications",
         description:
-          "List candidate applications for a specific job, with optional step/status filters",
+          "List candidate applications for a specific job, with optional step/status filters. Use fields='all' to include candidate details such as work experience, education and languages.",
         inputSchema: ListApplicationsParamsSchema.shape,
       },
       async (params) => {
@@ -110,6 +111,21 @@ export class GupyMCPServer {
       }
     );
 
+    this.server.registerTool(
+      "list_application_experiences",
+      {
+        title: "List Application Professional Experiences",
+        description:
+          "List the professional (work) experiences of candidates who applied to a specific job. Returns each candidate's name, email, schooling and a clean list of work experiences (role, company, activities, period). Internally queries the applications endpoint with fields=all.",
+        inputSchema: ListApplicationExperiencesParamsSchema.shape,
+      },
+      async (params) => {
+        return this.tools.listApplicationExperiences(
+          ListApplicationExperiencesParamsSchema.parse(params)
+        );
+      }
+    );
+
     this.server.registerTool(
       "move_application",
       {

packages/gupy/src/tools.ts

@@ -5,6 +5,7 @@ import {
   GetJobParams,
   UpdateJobStatusParams,
   ListApplicationsParams,
+  ListApplicationExperiencesParams,
   MoveApplicationParams,
   CreateApplicationCommentParams,
   ListApplicationCommentsParams,
@@ -92,6 +93,7 @@ export class GupyMCPTools {
         offset: params.offset,
         currentStep: params.currentStep,
         status: params.status,
+        fields: params.fields,
       });
       const data = await this.client.request<unknown>(
         "GET",
@@ -105,6 +107,29 @@ export class GupyMCPTools {
     }
   }
 
+  async listApplicationExperiences(
+    params: ListApplicationExperiencesParams
+  ): Promise<McpToolResult> {
+    try {
+      const query = this.cleanQuery({
+        limit: params.limit,
+        offset: params.offset,
+        currentStep: params.currentStep,
+        status: params.status,
+        fields: "all",
+      });
+      const data = await this.client.request<unknown>(
+        "GET",
+        `/api/v1/jobs/${params.jobId}/applications`,
+        undefined,
+        query
+      );
+      return this.ok(this.extractExperiences(data));
+    } catch (error) {
+      return this.formatError(error);
+    }
+  }
+
   async moveApplication(
     params: MoveApplicationParams
   ): Promise<McpToolResult> {
@@ -260,6 +285,53 @@ export class GupyMCPTools {
     }
   }
 
+  private extractExperiences(data: unknown): unknown {
+    const root = data as Record<string, unknown> | null;
+    const list = Array.isArray(root?.data)
+      ? (root?.data as unknown[])
+      : Array.isArray(data)
+        ? (data as unknown[])
+        : [];
+
+    const applications = list.map((item) => {
+      const application = item as Record<string, unknown>;
+      const candidate =
+        (application.candidate as Record<string, unknown> | undefined) ?? {};
+      const rawExperiences = Array.isArray(candidate.workExperience)
+        ? (candidate.workExperience as Record<string, unknown>[])
+        : [];
+
+      const workExperience = rawExperiences.map((experience) => ({
+        role: experience.role ?? null,
+        companyName: experience.companyName ?? null,
+        activitiesPerformed: experience.activitiesPerformed ?? null,
+        startMonth: experience.startMonth ?? null,
+        startYear: experience.startYear ?? null,
+        endMonth: experience.endMonth ?? null,
+        endYear: experience.endYear ?? null,
+      }));
+
+      return {
+        applicationId: application.id ?? null,
+        candidateName: candidate.name ?? null,
+        candidateEmail: candidate.email ?? null,
+        schooling: candidate.schooling ?? null,
+        schoolingStatus: candidate.schoolingStatus ?? null,
+        workExperience,
+      };
+    });
+
+    return {
+      summary: {
+        total: applications.length,
+        withExperience: applications.filter(
+          (application) => application.workExperience.length > 0
+        ).length,
+      },
+      applications,
+    };
+  }
+
   private cleanQuery(
     obj: Record<string, string | number | boolean | undefined>
   ): Record<string, string | number | boolean> {

packages/gupy/src/types.ts

@@ -72,6 +72,25 @@ export const ListApplicationsParamsSchema = z.object({
     .string()
     .optional()
     .describe("Filter by application status"),
+  fields: z
+    .enum(["name", "id", "code", "all"])
+    .optional()
+    .describe(
+      "Controls which application fields are returned. Use 'all' to include candidate details such as workExperience, academicQualification and languages. Defaults to Gupy's standard response when omitted."
+    ),
+});
+
+export const ListApplicationExperiencesParamsSchema = z.object({
+  jobId: z.union([z.string(), z.number()]).describe("Job ID"),
+  ...Pagination,
+  currentStep: z
+    .string()
+    .optional()
+    .describe("Filter applications by current step name"),
+  status: z
+    .string()
+    .optional()
+    .describe("Filter by application status"),
 });
 
 export const MoveApplicationParamsSchema = z.object({
@@ -161,6 +180,9 @@ export type UpdateJobStatusParams = z.infer<typeof UpdateJobStatusParamsSchema>;
 export type ListApplicationsParams = z.infer<
   typeof ListApplicationsParamsSchema
 >;
+export type ListApplicationExperiencesParams = z.infer<
+  typeof ListApplicationExperiencesParamsSchema
+>;
 export type MoveApplicationParams = z.infer<typeof MoveApplicationParamsSchema>;
 export type CreateApplicationCommentParams = z.infer<
   typeof CreateApplicationCommentParamsSchema