JobGPT MCP Server

Instructions

Implementation Reference

• src/tools/applications.ts:19-37 (handler)

  The registration and implementation handler for the 'list_applications' MCP tool. It takes optional filters, calls the client's listApplications method, and formats the output.

  server.tool(
    'list_applications',
    'List your job applications, optionally filtered by job hunt or status',
    {
      jobHuntId: z.string().optional().describe('Filter by job hunt ID'),
      status: z.string().optional().describe('Filter by status (e.g., "PENDING", "APPLIED", "INTERVIEW", "OFFER", "REJECTED")'),
      page: z.number().optional().describe('Page number (default: 1)'),
      limit: z.number().optional().describe('Number of results per page (default: 20, max: 50)'),
    },
    async (args) => {
      const result = await client.listApplications({
        jobHuntId: args.jobHuntId,
        status: args.status,
        page: args.page || 1,
        limit: args.limit || 20,
      });
      return { content: [{ type: 'text' as const, text: JSON.stringify({ count: result.count, applications: result.applications.map(formatApplication) }, null, 2) }] };
    }
  );