open-index/open-npm huggingface dataset:
npm package: @minpakux/mcp-server
Description: MCP server for MinpakuX — search properties, check availability, and book accommodation in East Asia
Latest version: 1.0.0

# @minpakux/mcp-server

MCP server for [MinpakuX](https://minpakux.solanalink.jp) — 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](https://minpakux.solanalink.jp/en/developer).

### 2. Configure

#### Claude Code

Add to your project's `.mcp.json`:

```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:

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

#### Windsurf

Add to `~/.windsurf/mcp.json`:

```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"