# Vaper.club

MCP server for Claude Code and Codex. Connects your AI agent to the Vaper.club public API to retrieve vape hardware offers, retail prices, reviews, and brand directories.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: VaperClub
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/VaperClub/vaper-club-agent/tree/HEAD/mcp-server
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/vaperclub

## What it does

The package acts as a lightweight STDIO bridge or connects straight to the hosted remote endpoint at `https://api.vaper.club/mcp/`. It contains no internal database or custom business logic, forwarding tool calls directly to `https://api.vaper.club/public-api/v1/` and returning unchanged public API payloads in text and `structuredContent`.

All exposed operations are strictly read-only. Available tools query product deals with shop and country filters, rank offers by ascending price, fetch review summaries, and browse brand profiles or guides. The public backend never outputs raw product identifiers, making single-product ID lookups and accessory compatibility queries unavailable.

Running the local adapter requires Node.js 20 or higher. The public API functions without an API token, though providing `VAPER_CLUB_API_KEY` includes it as an authorization bearer header.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.vaper.club/mcp`
- Environment variables: `VAPER_CLUB_API_BASE_URL`, `VAPER_CLUB_API_TIMEOUT`, `VAPER_CLUB_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http vaper-club https://api.vaper.club/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env VAPER_CLUB_API_BASE_URL=<VAPER_CLUB_API_BASE_URL> --env VAPER_CLUB_API_TIMEOUT=<VAPER_CLUB_API_TIMEOUT> --env VAPER_CLUB_API_KEY=<VAPER_CLUB_API_KEY> --transport stdio mcp-server -- npx -y vaper-club-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mcp-server --url https://api.vaper.club/mcp
```

2. **Platform CLI**
```bash
codex mcp add mcp-server --env VAPER_CLUB_API_BASE_URL=<VAPER_CLUB_API_BASE_URL> --env VAPER_CLUB_API_TIMEOUT=<VAPER_CLUB_API_TIMEOUT> --env VAPER_CLUB_API_KEY=<VAPER_CLUB_API_KEY> -- npx -y vaper-club-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "url": "https://api.vaper.club/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "vaper-club-mcp"
            ],
            "env": {
                "VAPER_CLUB_API_BASE_URL": "<VAPER_CLUB_API_BASE_URL>",
                "VAPER_CLUB_API_TIMEOUT": "<VAPER_CLUB_API_TIMEOUT>",
                "VAPER_CLUB_API_KEY": "<VAPER_CLUB_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "http",
            "url": "https://api.vaper.club/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "vaper-club-mcp"
            ],
            "env": {
                "VAPER_CLUB_API_BASE_URL": "<VAPER_CLUB_API_BASE_URL>",
                "VAPER_CLUB_API_TIMEOUT": "<VAPER_CLUB_API_TIMEOUT>",
                "VAPER_CLUB_API_KEY": "<VAPER_CLUB_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp-server https://api.vaper.club/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e VAPER_CLUB_API_BASE_URL=<VAPER_CLUB_API_BASE_URL> -e VAPER_CLUB_API_TIMEOUT=<VAPER_CLUB_API_TIMEOUT> -e VAPER_CLUB_API_KEY=<VAPER_CLUB_API_KEY> mcp-server npx -y vaper-club-mcp
```
Replace <…> with your own values

## When to use it
- search vape product offers across shops with country and brand filters
- compare prices for matching models sorted from cheapest to most expensive
- fetch user review summaries for vape devices
- retrieve brand details by slug or brand name
- browse vape retail shops and recent industry guides

## Example prompts
- Search product offers for a pod mod using vaper-club
- Compare shop prices for the Caliburn G3 device
- Get recent news and buyer guides from Vaper.club

## Similar
- [INITE Club](https://affpapa.org/en/nevibecode/mcp/inite-club.md) — MCP server
- [Stock Price — Real-Time Quotes, US & International](https://affpapa.org/en/nevibecode/mcp/stock-price-real-time-quotes-us-international.md) — MCP server · 5293 installs
- [Well](https://affpapa.org/en/nevibecode/mcp/well.md) — MCP server · 4088 installs
- [UUID Generator — v4, v7, ULID, Nanoid (Batch 100)](https://affpapa.org/en/nevibecode/mcp/uuid-generator-v4-v7-ulid-nanoid-batch-100.md) — MCP server · 3352 installs
- [GribStream.com Historical Weather Forecast API](https://affpapa.org/en/nevibecode/mcp/gribstreamcom-historical-weather-forecast-api.md) — MCP server · 2733 installs
- [LittleSis API Server](https://affpapa.org/en/nevibecode/mcp/littlesis-api-server.md) — MCP server · 1860 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
