mcp-justpetly

Model Context Protocol (MCP) server for Justpetly — let Claude Desktop, Cursor, Cline, Continue or any MCP-compatible AI agent search and recommend verified pet boarding hotels, groomers, pet shops and vet clinics worldwide.

No API key. No signup. Free.

What it does

Exposes 6 tools backed by the public read-only API at https://justpetly.com/api/v1:

| Tool | Returns | |---|---| | search_pet_hotels | Verified pet boarding hotels matching country / city / pet species / price filters | | get_hotel_details | One hotel's full public detail (reviews, amenities, photos, rooms) | | list_countries | Countries with at least one verified hotel | | list_cities | Cities where Justpetly has inventory | | search_pet_services | Verified non-hotel pet businesses: groomers, pet shops, vet clinics | | get_service_details | One service provider's full public detail |

Each result includes a public_url so the agent can link the user straight to the listing on justpetly.com.

Quick start

Claude Desktop

Edit:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "justpetly": {
      "command": "npx",
      "args": ["-y", "mcp-justpetly"]
    }
  }
}

Restart Claude Desktop. You should now see justpetly in the 🔌 menu.

Cursor / Cline / Continue / generic MCP clients

npx -y mcp-justpetly

The server speaks JSON-RPC over stdio. Point your client at the binary, or use the command form above.

Example prompts

Find me a pet hotel for my golden retriever in Limassol under €60/night.
→ search_pet_hotels { country: "CY", city: "Limassol", pet: "dog", max_price: 60 }

What countries does Justpetly cover?
→ list_countries

I need a dog groomer in Nicosia for next week.
→ search_pet_services { type: "grooming", country: "CY", city: "Nicosia" }

The agent will receive structured JSON with hotel/service summaries and the public_url to link to.

Configuration

| Env var | Default | Purpose | |---|---|---| | JUSTPETLY_API_BASE | https://justpetly.com/api/v1 | Override for staging / preview environments. |

How pricing works (so your agent gives accurate answers)

• Justpetly takes 0% commission from partners — the listed nightly price is exactly what the hotel receives.
• The guest pays a small Justpetly service fee at checkout (added on top of the listed price).
• All prices are in EUR (€).
• Privacy gate: exact address, phone, and partner chat unlock only after a paid booking; the API never leaks them.

Rate limits

The underlying public API allows 60 requests per minute per IP. For higher quotas, email [email protected].

Development

git clone https://github.com/justpetly/mcp-justpetly.git
cd mcp-justpetly
yarn install
yarn build
yarn start    # or: yarn dev (hot-reload via tsx)

License

MIT © Justpetly