Activity Reporting MCP Server

Instructions

Implementation Reference

• src/server.ts:362-423 (registration)

  Registration of the 'submit_product_feedback' tool in the ListToolsRequestSchema handler, including detailed input schema definition.
  { name: "submit_product_feedback", description: "Submit a product feedback activity draft", inputSchema: { type: "object", properties: { title: { type: "string", description: "Title", minLength: 3, maxLength: 200, }, description: { type: "string", description: "Description", maxLength: 2000, }, activityDate: { type: "string", pattern: "^\\d{4}-\\d{2}-\\d{2}$", description: "Participation Date (YYYY-MM-DD format)", }, contentType: { type: "string", enum: Object.values(ProductFeedbackContentType), description: "Content type", }, productDescription: { type: "string", maxLength: 500, description: "What product was it about?", }, tags: { type: "array", items: { type: "string" }, description: "Tags (optional)", minItems: 0, }, metrics: { type: "object", properties: { timeSpent: { type: "integer", minimum: 1, description: "Time spent (in minutes)", }, }, required: ["timeSpent"], }, additionalInfo: { type: "string", maxLength: 2000, description: "Additional information (optional)", }, private: { type: "boolean", description: "Do you want to make this activity private? (optional)", }, }, required: ["title", "description", "activityDate", "contentType", "productDescription", "metrics"], }, },
• src/server.ts:584-585 (handler)

  Handler dispatch in the CallToolRequestSchema switch statement, mapping the tool call to the shared submitActivityDraft method with specific endpoint 'product-feedback-given'.
  case "submit_product_feedback": return await this.submitActivityDraft("product-feedback-given", args as unknown as ProductFeedbackDraft);
• src/server.ts:609-682 (helper)

  Shared helper function that executes the core logic: POSTs the product feedback draft to the 'product-feedback-given' endpoint on the Advocu GDE API, handles responses and errors.
  private async submitActivityDraft( endpoint: string, data: | ContentCreationDraft | PublicSpeakingDraft | WorkshopDraft | MentoringDraft | ProductFeedbackDraft | GooglerInteractionDraft | StoryDraft, ): Promise<{ content: Array<{ type: string; text: string; }>; }> { const url = `${this.baseUrl}/activity-drafts/${endpoint}`; try { const response = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json", Authorization: `Bearer ${this.accessToken}`, }, body: JSON.stringify(data), }); if (!response.ok) { const errorText = await response.text(); let errorMessage = `GDE API error (${response.status})`; if (response.status === 401) { errorMessage = "❌ GDE authentication failed. Your ADVOCU_ACCESS_TOKEN may be expired or invalid.\n\nPlease check your Advocu access token configuration."; } else if (response.status === 400) { errorMessage = `❌ GDE API rejected the request:\n\n${errorText}\n\nPlease check:\n- All required fields are present\n- Field values match expected formats\n- Tags are valid\n- Date format is correct (YYYY-MM-DD)`; } else if (response.status === 429) { errorMessage = "⏱️ GDE API rate limit exceeded (30 requests/minute). Please wait and try again."; } else { errorMessage = `❌ GDE API error (${response.status}):\n\n${errorText}`; } // Return error as content instead of throwing return { content: [ { type: "text", text: errorMessage, }, ], }; } const result = (await response.json()) as Record<string, unknown>; return { content: [ { type: "text", text: `✅ GDE Activity draft submitted successfully!\n\nEndpoint: ${endpoint}\nStatus: ${response.status}\nResponse: ${JSON.stringify(result, null, 2)}`, }, ], }; } catch (error) { if (error instanceof McpError) { throw error; } const errorMsg = this.getErrorMessage(error); throw new McpError( ErrorCode.InternalError, `❌ Failed to submit GDE activity:\n\n${errorMsg}\n\nEndpoint: ${endpoint}` ); } }
• src/interfaces/ProductFeedbackDraft.ts:13-23 (schema)

  Type definition for ProductFeedbackDraft, providing structure and validation types for the tool's input parameters.
  export interface ProductFeedbackDraft extends ActivityDraftBase { /** Type of product feedback content */ contentType: ProductFeedbackContentType; /** Description of what product the feedback was about */ productDescription: string; /** Metrics related to time investment */ metrics: { /** Time spent providing feedback (in minutes) */ timeSpent: number; }; }
• src/types/ProductFeedbackContentType.ts:10-13 (schema)

  Enum defining valid values for the 'contentType' field in the product feedback tool schema.
  export enum ProductFeedbackContentType { EARLY_ACCESS_PROGRAM = "Early access program", PRODUCT_FEEDBACK_SESSION = "Product feedback session", }