{
  "markdown": "# hostex-mcp\n\n[![Release](https://github.com/keithah/hostex-mcp/actions/workflows/release.yml/badge.svg)](https://github.com/keithah/hostex-mcp/actions/workflows/release.yml)\n[![Check hostex-ts Updates](https://github.com/keithah/hostex-mcp/actions/workflows/check-npm-updates.yml/badge.svg)](https://github.com/keithah/hostex-mcp/actions/workflows/check-npm-updates.yml)\n[![Smithery](https://smithery.ai/badge/@keithah/hostex-mcp)](https://smithery.ai/server/@keithah/hostex-mcp)\n\nModel Context Protocol server for the Hostex property management API. Manage your vacation rental properties, reservations, guest communications, and more through Claude and other MCP clients.\n\nBuilt on [hostex-ts](https://www.npmjs.com/package/hostex-ts) - TypeScript client library for Hostex API v3.0.0.\n\n## Features\n\n- 🏠 **Properties** - Property and room type management\n- 📅 **Reservations** - CRUD operations, custom fields, lock codes\n- 📊 **Availability** - Property availability calendars\n- 📋 **Listings** - Channel listings, pricing, inventory\n- 💬 **Messaging** - Guest communication and messaging\n- ⭐ **Reviews** - Review management and responses\n- 🔗 **Webhooks** - Real-time event notifications\n- ⚙️ **Utilities** - Custom channels and income methods\n\n### Available Tools (25+)\n\n- `hostex_list_properties` - List all properties\n- `hostex_list_room_types` - List room types\n- `hostex_list_reservations` - Search and filter reservations\n- `hostex_create_reservation` - Create direct bookings\n- `hostex_cancel_reservation` - Cancel reservations\n- `hostex_update_lock_code` - Update stay lock codes\n- `hostex_get_custom_fields` - Get custom field values\n- `hostex_update_custom_fields` - Update custom fields\n- `hostex_list_availabilities` - Check property availability\n- `hostex_update_availabilities` - Block/open dates\n- `hostex_list_conversations` - List guest conversations\n- `hostex_get_conversation` - Get conversation details\n- `hostex_send_message` - Send messages to guests\n- `hostex_list_reviews` - Query reviews\n- `hostex_create_review` - Leave reviews or replies\n- `hostex_list_webhooks` - List configured webhooks\n- `hostex_create_webhook` - Register new webhooks\n- `hostex_delete_webhook` - Remove webhooks\n- `hostex_get_listing_calendar` - Get listing calendars\n- `hostex_update_listing_prices` - Update channel prices\n- `hostex_list_custom_channels` - List custom channels\n- `hostex_list_income_methods` - List income methods\n\n## Installation\n\n### Option 1: Via Smithery (Recommended)\n\nInstall directly from Smithery:\n\n```bash\nnpx -y @smithery/cli install @keithah/hostex-mcp --client claude\n```\n\nOr add the hosted server URL to your MCP client:\n\n```\nhttps://server.smithery.ai/@keithah/hostex-mcp/mcp\n```\n\nWhen prompted, provide your Hostex API access token.\n\n### Option 2: MCPB Package\n\n1. Download the latest `.mcpb` file from [Releases](https://github.com/keithah/hostex-mcp/releases)\n2. Double-click the file to install in your MCP client\n3. Configure your Hostex API token when prompted\n\n### Option 3: Manual Installation (Claude Desktop)\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS or `~/.config/Claude/claude_desktop_config.json` on Linux):\n\n```json\n{\n  \"mcpServers\": {\n    \"hostex\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"hostex-mcp\"],\n      \"env\": {\n        \"HOSTEX_ACCESS_TOKEN\": \"your_hostex_api_token\"\n      }\n    }\n  }\n}\n```\n\nOr use the Smithery hosted server:\n\n```json\n{\n  \"mcpServers\": {\n    \"hostex\": {\n      \"url\": \"https://server.smithery.ai/@keithah/hostex-mcp/mcp\",\n      \"env\": {\n        \"HOSTEX_ACCESS_TOKEN\": \"your_hostex_api_token\"\n      }\n    }\n  }\n}\n```\n\n## Configuration\n\nYou need a Hostex API access token. Get yours from your Hostex account settings at https://www.hostex.io/\n\nThe server accepts configuration through the `configSchema`:\n\n- `accessToken` (required): Your Hostex API access token\n\n## Usage Examples\n\nOnce installed, you can ask Claude natural language questions like:\n\n- \"Show me all my Hostex properties\"\n- \"List reservations checking in this week\"\n- \"Block property 12345 for next weekend\"\n- \"Send a welcome message to the guest in conversation ABC123\"\n- \"What reviews have I received this month?\"\n- \"Create a direct booking for property XYZ\"\n\n## Development\n\n### Prerequisites\n\n- Node.js >= 18\n- npm\n\n### Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/keithah/hostex-mcp.git\ncd hostex-mcp\n\n# Install dependencies\nnpm install\n\n# Build for stdio transport\nnpm run build:stdio\n\n# Build for streamable HTTP transport\nnpm run build:shttp\n\n# Build both transports\nnpm run build:all\n```\n\n### Testing Locally\n\n```bash\n# Start dev server with Smithery\nnpm run dev\n```\n\n## Architecture\n\nThis MCP server uses:\n\n- **[@modelcontextprotocol/sdk](https://www.npmjs.com/package/@modelcontextprotocol/sdk)** - MCP protocol implementation\n- **[@smithery/sdk](https://www.npmjs.com/package/@smithery/sdk)** - Multi-transport support\n- **[hostex-ts](https://www.npmjs.com/package/hostex-ts)** - Hostex API client library\n- **[zod](https://www.npmjs.com/package/zod)** - Schema validation\n\n### Transports\n\nThe server supports two transport protocols:\n\n- **stdio** - Standard input/output (for local MCP clients like Claude Desktop)\n- **shttp** - Streamable HTTP (for remote/web-based MCP clients)\n\nBoth are built using [Smithery](https://smithery.ai) for seamless multi-transport support.\n\n## Automatic Updates\n\nThis repository includes a GitHub Actions workflow that:\n\n1. Checks hourly for new releases of `hostex-ts` on npm\n2. Automatically creates a PR to update the dependency\n3. Bumps the patch version\n4. Rebuilds the MCP bundles\n\nWhen you merge the PR and create a new release tag, the MCPB package is automatically built and attached to the GitHub release.\n\n## Requirements\n\n- Node.js >= 18\n- MCP-compatible client (Claude Desktop v0.10.0+, or any MCP client)\n- Hostex account with API access\n\n## Documentation\n\n- [Hostex API Documentation](https://docs.hostex.io/)\n- [hostex-ts npm package](https://www.npmjs.com/package/hostex-ts)\n- [Model Context Protocol](https://modelcontextprotocol.io/)\n\n## License\n\nMIT\n\n## Author\n\nKeith Hadfield\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/keithah/hostex-mcp/issues)\n- **Hostex API**: https://docs.hostex.io/\n- **MCP Documentation**: https://modelcontextprotocol.io/\n\n---\n\n**Note**: This is an unofficial community project and is not officially supported by Hostex.",
  "bytes": 6469,
  "sha": "a67ddda6d137b7a8c3705891ce1e91ee2d4afe3d2ae22c9e0e4d5ee8cec88e3a",
  "repo_slug": "keithah/hostex-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_smithery_keithah_hostex_mcp_9680c064/readme"
}