Otelpuan MCP Server Otelpuan ![Model Context Protocol](/assets/logos/mcp_logo-5491d9a62e32c642cb83f2f0ba7d7d7efcaefa6f44e5d305f7dc3f28b6587cee.svg) # Get Otelpuan hotel data by chatting with AI. Paste one prompt into **Claude Code, Cursor, or your agent** and it installs itself. Your agent then pulls Otelpuan data from plain-English prompts. Same API key, same billing as the REST API. [Install it in your agent](#setup)[Read the MCP docs](/docs/mcp) **50** free requests on signupNo credit cardAny language, no code Trusted by hospitality teams at ![EHL](/assets/logos/ehl-51e6ac832bd7a1b8c1f3c17ea48e7f7464f2aaead02a54b7cab2f2ee05b06c86.png) ![Skyscanner](/assets/logos/skyscanner-47f9fed400d4f828b0499892968e393aa1435240b8a573988d36fceb7f0433ae.png) ![Mews](/assets/logos/mews-e52288ca26c3e8d5e3878b522b92b521916a7df9c07556910102ad7bebbd216b.svg) ![CBRE](/assets/logos/cbre-f38211cf61a47f45d021ab25957f592fb2043bcff716539e3f2f54fd7fde91be.png) ![Ripe](/assets/logos/ripe-9fec989e25c3a18f2fec0357610bc743f12bf0e96cfa4824f457c4aa2c95db60.svg) What you can ask ## Ask in plain English. Get real Otelpuan answers. Whatever you'd ask a junior analyst about a hotel, ask your agent. No syntax to learn. \> Find Turkler on Otelpuan, then check rooms and prices using its hotel URL for October 10–12, 2026, for 2 adults. \> Find Otelpuan hotel suggestions for Turkler, then read reviews using the returned hotel ID. \> Resolve https://www.otelpuan.com/Turkler-Otel to its hotel ID, then summarize guest feedback. \> Read page 2 of the Otelpuan reviews for hotel 25322. Behind the scenes ## You type plain English. Your agent calls the right Otelpuan tool. Real examples. You ask, the agent picks a tool and fills the parameters, you read the answer. These outputs are illustrative. 01Rooms & prices You ask Check Otelpuan rooms for two adults at Türkler Otel from October 10 to 12, 2026. Behind the scenes`otelpuan_hotel_rooms(url="https://www.otelpuan.com/Turkler-Otel", check_in="2026-10-10", check_out="2026-10-12", adults=2)` You see Room offers for the requested stay, including board plans, stay totals, daily amounts, and cancellation terms. 02Search You ask Find Otelpuan hotels matching Turkler and read their guest feedback. Behind the scenes`otelpuan_search_hotels(query="Turkler") -> otelpuan_hotel_reviews(hotel_id="25322", page=1)` You see Hotel name suggestions with IDs for reviews. Search results do not require a URL resolver call. 03Reviews You ask Summarize the guest feedback for https://www.otelpuan.com/Turkler-Otel. Behind the scenes`otelpuan_hotel_url_to_id(url="https://www.otelpuan.com/Turkler-Otel") -> otelpuan_hotel_reviews(hotel_id="25322", page=1)` You see Hotel ratings and guest comments with stay months. Publication dates are unavailable; do not infer review chronology from stay dates. Connect it ## Paste one sentence. Your agent does the rest. Copy the prompt into the agent you already have open. It reads our setup page and wires up the connector itself. Paste into Claude Code ``` Read https://stayapi.com/install and set up the StayAPI MCP server for me. ``` Then open a **new** session and run `claude mcp list` — `stayapi` should read `✓ Connected`. **No key yet?** [Sign up](/users/sign_up) for 50 free requests — the agent asks you for it. **Claude on the web, desktop, or mobile** doesn't need this prompt: add StayAPI under Settings → Connectors and sign in. **ChatGPT** : add it as an MCP app in developer mode and sign in. Other clients: manual setup below. No key ### Claude on the web, desktop & mobile Add StayAPI as a connector and sign in. Nothing to paste. 1. In Claude, open **Settings → Connectors → Add custom connector**. 2. Name it `StayAPI` and set the URL to `https://api.stayapi.com/mcp`. 3. Click **Connect** , sign in to StayAPI, and choose **Allow**. No key ### ChatGPT (developer mode) Add StayAPI as an MCP app and sign in. Plus, Pro, Business, Enterprise, or Edu, on the web. 1. In ChatGPT, turn on **Settings → Security and login → Developer mode**. 2. Open `chatgpt.com/plugins`, click **+** , and choose **Create MCP app**. 3. Name it `StayAPI`, set the URL to `https://api.stayapi.com/mcp`, and pick **OAuth**. Leave the client ID and secret blank. 4. Sign in to StayAPI, choose **Allow** , then install StayAPI from your personal plugins. 5. In a **Work** chat, type `@StayAPI` and ask. #Manual setup — paste the config yourself 01 ### Claude Code One terminal command. bash ``` claude mcp add --scope user --transport http stayapi https://api.stayapi.com/mcp --header "X-API-Key: YOUR_API_KEY" ``` 1. Run the command in any terminal. 2. Open a **new** Claude Code session. 3. Confirm with `claude mcp list`. 02 ### Cursor Edit `~/.cursor/mcp.json`. json ``` { "mcpServers": { "stayapi": { "type": "http", "url": "https://api.stayapi.com/mcp", "headers": { "X-API-Key": "YOUR_API_KEY" } } } } ``` 1. Open or create the file. 2. Paste, swap `YOUR_API_KEY`, save. 3. Restart Cursor. 03 ### Claude Desktop Edit `claude_desktop_config.json`. json ``` { "mcpServers": { "stayapi": { "command": "npx", "args": [ "-y", "mcp-remote@0.1.18", "https://api.stayapi.com/mcp", "--header", "X-API-Key:YOUR_API_KEY" ] } } } ``` 1. Open the config file in your OS. 2. Paste, swap the key, save. 3. Quit Claude with ⌘ Q, relaunch. On Windows, a bare `npx` can fail with `spawn npx ENOENT`. Use the absolute path to `npx.cmd`. [Windows setup notes →](/docs/mcp) Full reference — every tool, error shapes, Windows notes: [MCP documentation →](/docs/mcp) Tools for Otelpuan ## The Otelpuan tools your agent can call. Most agents pick the right tool from your prompt, so you never name it. One tool call counts as one request, the same as a REST request. `otelpuan_hotel_rooms` Get room offers by hotel URL, stay dates, adults, and optional comma-separated child ages. Returns stay totals, board plans, daily prices, and cancellation terms. `otelpuan_search_hotels` Find hotel suggestions by query. Returns IDs, names, URLs, and location labels. Use hotel\_id directly for reviews; no pagination or exhaustive city inventory. `otelpuan_hotel_url_to_id` Resolve an Otelpuan hotel URL to hotel\_id, name, canonical URL, aggregate rating, and review count. Use the returned ID for reviews. `otelpuan_hotel_reviews` Get Otelpuan guest reviews by hotel\_id, with ratings, text, stay dates, and 10-review pagination. Publication dates can be null. Full parameters and response shapes live in the [MCP docs](/docs/mcp). For the same data over REST, see the [Otelpuan API hub](/apis/otelpuan). ## Point your agent at Otelpuan. Sign up, paste one prompt, let your agent install itself. Both paths end with your agent answering Otelpuan questions in plain English. 01 · the fast path ### Get your key 50 free requests on signup. Paste one prompt into your agent, then start asking it for Otelpuan data. [Start free](/users/sign_up)[Read the MCP docs](/docs/mcp) - 50 free requests, no credit card - Same key as the REST API - Any language, no code 02 · talk to us ### Talk through your use case 15 minutes. We screen-share and wire Claude or Cursor to your real properties. Free of charge. [Book a demo](/book-demo) - Working setup on the call - Your properties, your prompts - Engineering, not sales