get_stay_reviews
Retrieve hotel guest reviews and ratings for specific accommodations to help travelers make informed booking decisions based on previous guest experiences.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stay_id | Yes | Duffel stay/hotel ID (e.g., acc_0000AWr2VsUNIF1Vl91xg0) | |
| after | No | Pagination cursor: after | |
| before | No | Pagination cursor: before | |
| limit | No | Max reviews to return (1-200) |
Implementation Reference
- src/api/duffelStaysClient.ts:86-101 (handler)Core handler function that executes the tool logic by calling the Duffel Stays API to fetch reviews for a given stay_id with optional pagination.async getStayReviews(params: StayReviewRequest): Promise<StayReviewResponse> { const { stay_id, after, before, limit } = params; const query: Record<string, string | number> = {}; if (after) query.after = after; if (before) query.before = before; if (limit) query.limit = limit; const response = await this.client.get(`/accommodation/${stay_id}/reviews`, { params: query, headers: { 'Duffel-Version': 'v2' } }); const meta = response.data.meta || {}; const reviews = (response.data.data?.reviews || []).map((r: any) => ({ text: r.text, score: r.score, reviewer_name: r.reviewer_name, created_at: r.created_at, })); return { meta, reviews }; }
- src/server.ts:205-224 (registration)MCP server registration of the 'get_stay_reviews' tool, providing input schema and delegating to DuffelStaysClient handler.server.tool( 'get_stay_reviews', stayReviewSchema.shape, async (params: StayReviewRequest) => { try { const response = await staysClient.getStayReviews(params); return { content: [ { type: 'text', text: JSON.stringify(response, null, 2) } ] }; } catch (error) { console.error(`Error fetching stay reviews: ${error}`); throw error; } } );
- src/models/stayReview.ts:4-9 (schema)Zod schema defining input parameters for the get_stay_reviews tool (stay_id required, pagination optional).export const stayReviewSchema = z.object({ stay_id: z.string().describe('Duffel stay/hotel ID (e.g., acc_0000AWr2VsUNIF1Vl91xg0)'), after: z.string().optional().describe('Pagination cursor: after'), before: z.string().optional().describe('Pagination cursor: before'), limit: z.number().int().min(1).max(200).optional().describe('Max reviews to return (1-200)'), });