@minpakux/mcp-server

MCP server for MinpakuX — search properties, check availability, and book accommodation in Japan, Korea, and Taiwan.

Tools

| Tool | Description | |------|-------------| | search_properties | Search minpaku/minsu properties by region, city | | get_property | Get property details with rooms and pricing | | check_availability | Check room availability calendar (max 90 days) | | get_pricing | Calculate total price for a room and date range | | create_booking | Create a reservation | | search_guides | Find local area guides near a property |

Setup

1. Get an API Key

Register at the MinpakuX Developer Portal.

2. Configure

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "minpakux": {
      "command": "npx",
      "args": ["@minpakux/mcp-server"],
      "env": {
        "MINPAKUX_API_KEY": "mop_live_your_key_here"
      }
    }
  }
}

Cursor

Add to Cursor Settings > MCP Servers:

{
  "minpakux": {
    "command": "npx",
    "args": ["@minpakux/mcp-server"],
    "env": {
      "MINPAKUX_API_KEY": "mop_live_your_key_here"
    }
  }
}

Windsurf

Add to ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "minpakux": {
      "command": "npx",
      "args": ["@minpakux/mcp-server"],
      "env": {
        "MINPAKUX_API_KEY": "mop_live_your_key_here"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | MINPAKUX_API_KEY | Yes | Your MOP API key (mop_live_*) | | MINPAKUX_API_URL | No | API base URL (default: https://minpakux.solanalink.jp/api/v1) |

Example Usage

Once configured, your AI assistant can:

• "Find available properties in Tokyo for next weekend"
• "Check pricing for room X from April 1-5 for 2 guests"
• "Book a room at property Y for John Doe"
• "Find restaurant recommendations near my property"