Rezdy Agent

A Model Context Protocol (MCP) server for integrating with the Rezdy Agent API. This server provides tools for travel agents to search marketplace products, manage bookings, handle customer relationships, and process payments through Claude.

- Marketplace Product Search: Search products from all suppliers with advanced filtering
- Availability & Pricing: Real-time availability search with agent commission calculations
- Booking Management: Quote, create, update, and cancel bookings with 2-step process support
- Customer Management: Agent-owned customer database with full CRUD operations
- Payment Processing: Support for both manual and automated payment workflows
- Commission Calculations: Built-in agent pricing and commission handling
- Rate Limiting: Automatic rate limiting (100 calls/minute) with intelligent queuing
- Environment Support: Both staging and production environments

git clone https://github.com/jezweb/rezdy-agent-mcp.git cd rezdy-agent-mcp npm install npm run build

Add the server to your Claude Desktop configuration:

On macOS:~/Library/Application Support/Claude/claude_desktop_config.jsonOn Windows:%APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "rezdy-agent": { "command": "node", "args": ["/path/to/rezdy-agent-mcp/build/index.js"] } } }

{ "mcp": { "servers": { "rezdy-agent": { "command": "node", "args": ["/path/to/rezdy-agent-mcp/build/index.js"] } } } }

- Install the Cline extension in VS Code
- Open VS Code settings (Cmd/Ctrl + ,)
- Search for "Cline MCP"
- Add server configuration:

{ "cline.mcp.servers": { "rezdy-agent": { "command": "node", "args": ["/path/to/rezdy-agent-mcp/build/index.js"] } } }

- Open Cursor Settings
- Navigate to Extensions > MCP
- Add server:

{ "mcpServers": { "rezdy-agent": { "command": "node", "args": ["/path/to/rezdy-agent-mcp/build/index.js"] } } }

For containerized deployment, you can use Docker:

git clone https://github.com/jezweb/rezdy-agent-mcp.git cd rezdy-agent-mcp

REZDY_API_KEY=your-agent-api-key-here REZDY_ENVIRONMENT=production

- For Claude Desktop, use the Docker container path:

{ "mcpServers": { "rezdy-agent": { "command": "docker", "args": [ "exec", "rezdy-agent-mcp", "node", "build/index.js" ] } } }

# Build the Docker image npm run docker:build # Run the container docker run --rm -it \ -e REZDY_API_KEY=your-api-key \ -e REZDY_ENVIRONMENT=production \ rezdy-agent-mcp

# Start services npm run docker:compose:up # Stop services npm run docker:compose:down # View logs npm run docker:compose:logs # Rebuild container npm run docker:compose:build

- Log into your Rezdy Agent account
- Go to Settings > API Keys
- Create a new Agent API key
- Copy the API key for configuration

Once connected, configure the server with your Rezdy Agent credentials:

Use the rezdy_agent_configure tool with: - apiKey: "your-agent-api-key" - environment: "staging" or "production"

Example: "Configure Rezdy Agent with my API key abc123 for staging environment"

rezdy_agent_configure({ apiKey: "abc123", environment: "staging" })

- rezdy_agent_configure- Configure API key and environment

- rezdy_agent_search_products- Search marketplace products with filters
- rezdy_agent_get_product- Get detailed product information
- rezdy_agent_get_product_pickups- Get pickup locations for products

- rezdy_agent_search_availability- Search availability with agent pricing

- rezdy_agent_quote_booking- Get booking quotes with commission details
- rezdy_agent_create_booking- Create confirmed bookings
- rezdy_agent_get_booking- Get booking details
- rezdy_agent_update_booking- Update existing bookings
- rezdy_agent_cancel_booking- Cancel bookings

- rezdy_agent_search_customers- Search agent customer database
- rezdy_agent_create_customer- Create new customer profiles
- rezdy_agent_get_customer- Get customer details

- rezdy_agent_get_categories- Get product categories
- rezdy_agent_get_locations- Get marketplace locations
- rezdy_agent_get_suppliers- Get marketplace suppliers

Once configured, you can interact with the Rezdy marketplace through natural language. Here are some examples:

- "Configure Rezdy Agent with my API key abc123 for production"
- "Show me all marketplace categories"
- "Find suppliers in Sydney"

- "Search for wine tours in Sydney under $200"
- "Find water sports activities for next week"
- "Show me products from supplier ID 456"
- "Get details for product 789 including pickup locations"

- "Check availability for product 123 next week"
- "Show me pricing for 2 adults on product 456 for tomorrow"
- "What's available for product 789 in December?"

- "Get a quote for John Doe (john@example.com) for product 123 with 2 adults"
- "Create a booking for Jane Smith for product 456 tomorrow at 10am"
- "Update booking ABC123 with new customer phone number"
- "Cancel booking DEF456 due to weather conditions"

- "Search for customers with email containing 'gmail'"
- "Create a customer profile for Mike Johnson (mike@email.com)"
- "Show me details for customer ID 789"

rezdy_agent_configure({ apiKey: "your-agent-api-key-here", environment: "production" })

rezdy_agent_search_products({ limit: 20, location: "Sydney", categoryId: 5, minPrice: 50, maxPrice: 200, tags: ["wine", "food"] })

rezdy_agent_search_availability({ productId: 123, startDate: "2024-01-15", endDate: "2024-01-22", quantities: [ { optionId: 1, value: 2 }, // 2 adults { optionId: 2, value: 1 } // 1 child ] })

rezdy_agent_quote_booking({ productId: 123, sessionId: "session-456", quantities: [{ optionId: 1, value: 2 }], customer: { firstName: "John", lastName: "Doe", email: "john@example.com" }, paymentType: "MANUAL", agentReference: "AGENT-REF-001" })

rezdy_agent_create_booking({ productId: 123, sessionId: "session-456", quantities: [{ optionId: 1, value: 2 }], customer: { firstName: "John", lastName: "Doe", email: "john@example.com", phone: "+1234567890", address: { city: "Sydney", country: "Australia" } }, paymentType: "AUTOMATED", agentReference: "BOOKING-001", notes: "Customer has mobility requirements" })

- Search products across all suppliers with comprehensive filtering
- Get detailed product information including descriptions, images, and pricing
- Retrieve pickup locations and meeting points
- Access supplier information and ratings

- Real-time availability checking with capacity information
- Agent-specific pricing with commission calculations
- Support for group bookings and multiple pricing options
- Promotional code validation and discount application

- Two-step booking process (quote → confirm)
- Support for complex booking requirements
- Participant management for group bookings
- Custom field support for supplier-specific requirements

- Agent-owned customer database
- Full customer profile management
- Search and filter capabilities
- Customer history and preferences tracking

The server automatically handles Rezdy's rate limiting (100 calls per minute) by:

- Tracking request counts per minute
- Queuing requests when limit is reached
- Automatically retrying after the rate limit window

The server provides comprehensive error handling:

- Validates all input parameters using Zod schemas
- Handles Rezdy API errors gracefully
- Provides clear error messages for debugging
- Validates customer data and booking requirements
- Checks date formats and business rules

"Rezdy Agent client not configured" Error

- Make sure to run the configuration step first: "Configure Rezdy Agent with my API key..."
- Verify your Agent API key is correct and has proper permissions

- The server automatically handles rate limiting, but if you see this error, wait a minute and try again
- Consider reducing the frequency of requests

- Ensure dates are in the correct format (YYYY-MM-DD for dates, ISO 8601 for date-times)
- Check that booking dates are not in the past
- Verify end date is after start date

- Check that the path in yourclaude_desktop_config.jsonis correct
- Ensure the server was built successfully (npm run build)
- Restart Claude Desktop after making configuration changes

- Make sure thebuild/index.jsfile has execute permissions
- On Unix systems:chmod +x build/index.js
- Check theIssues page
- Review the Rezdy Agent API documentation
- Verify your API key permissions in Rezdy Agent settings

# Install dependencies npm install # Run in development mode npm run dev # Build for production npm run build # Start production server npm start

arXiv paper search and full-text reading