Vaper.club

Official registry Search and web

Read-only vape industry data: posts, brands, shops, product search, comparison and reviews.

What can you do with Vaper.club?

  • Reading the latest vape industry posts and searching articles.
  • Searching brands and shops, and reading their profiles.
  • Searching products and comparing prices and stock of the same model across retailers.
  • Summarizing product ratings and the newest user reviews.
  • Building applications that consume structured vaping industry data.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http vaper-club 'https://api.vaper.club/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "vaper-club": {
            "type": "http",
            "url": "https://api.vaper.club/mcp"
        }
    }
}
NPM package vaper-club-mcp
Claude Code
claude mcp add vaper-club -e 'VAPER_CLUB_API_BASE_URL=https://api.vaper.club/public-api/v1/' -e 'VAPER_CLUB_API_TIMEOUT=15' -e 'VAPER_CLUB_API_KEY=<your vaper_club_api_key>' -- npx -y vaper-club-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "vaper-club": {
            "command": "npx",
            "args": [
                "-y",
                "vaper-club-mcp@1.0.1"
            ],
            "env": {
                "VAPER_CLUB_API_BASE_URL": "https://api.vaper.club/public-api/v1/",
                "VAPER_CLUB_API_TIMEOUT": "15",
                "VAPER_CLUB_API_KEY": "<your vaper_club_api_key>"
            }
        }
    }
}

Environment variables

  • VAPER_CLUB_API_BASE_URL Vaper.club Public API base URL.
  • VAPER_CLUB_API_TIMEOUT API request timeout in seconds (0-300).
  • VAPER_CLUB_API_KEY secret Optional bearer token for the Vaper.club Public API.
PYPI package vaper-club-mcp
Claude Code
claude mcp add vaper-club -e 'VAPER_CLUB_API_BASE_URL=https://api.vaper.club/public-api/v1/' -e 'VAPER_CLUB_API_TIMEOUT=15' -e 'VAPER_CLUB_API_KEY=<your vaper_club_api_key>' -- uvx vaper-club-mcp==1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "vaper-club": {
            "command": "uvx",
            "args": [
                "vaper-club-mcp==1.0.1"
            ],
            "env": {
                "VAPER_CLUB_API_BASE_URL": "https://api.vaper.club/public-api/v1/",
                "VAPER_CLUB_API_TIMEOUT": "15",
                "VAPER_CLUB_API_KEY": "<your vaper_club_api_key>"
            }
        }
    }
}

Environment variables

  • VAPER_CLUB_API_BASE_URL Vaper.club Public API base URL.
  • VAPER_CLUB_API_TIMEOUT API request timeout in seconds (0-300).
  • VAPER_CLUB_API_KEY secret Optional bearer token for the Vaper.club Public API.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Vaper Club Agent
  2. What is Vaper Club?
  3. Integration Options
  4. Available Skills
  5. Getting Started
  6. Use Cases
  7. Documentation
  8. Contributing
  9. License

Vaper Club Agent

Official AI Agent integration resources for Vaper Club, providing MCP connectivity, Agent Skills, and public API documentation for vape product, brand, model, and store data.

Vaper Club provides structured product catalog information to help AI agents and developers discover, search, and understand vaping products and related brands.

What is Vaper Club?

Vaper Club is a product discovery and information platform focused on the global vaping industry.

It provides structured information about:

  • Products – Product names, descriptions, specifications, categories, and images.
  • Brands – Brand profiles, official websites, and product portfolios.
  • Models – Normalized product model information and identification.
  • Listings – Product listings from different online vape retailers.
  • Stores – Retailer information and product availability.
  • Market Data – Product pricing and other available catalog information.

Integration Options

1. MCP Server

Connect AI agents and MCP-compatible applications directly to Vaper Club.

PropertyValue
ServiceVaper Club MCP
Endpointhttps://api.vaper.club/mcp
ProtocolModel Context Protocol (MCP)
TransportStreamable HTTP
AuthenticationNone (rate limited per IP)
DocumentationMCP Documentation · mcp/README.md

The server exposes read-only tools: get_latest_posts, search_posts, search_brands, get_brand_details, search_shops, get_shop_details, search_products, compare_products and get_product_reviews, plus reference resources under vaper://site/*.

A local STDIO adapter is also available as the npm package vaper-club-mcp (npx -y vaper-club-mcp); see mcp-server/README.md.

2. Public API

Developers can integrate Vaper Club data into their own applications using the public API.

PropertyValue
API Base URLhttps://api.vaper.club/public-api/v1
DocumentationPublic API Documentation · docs/api.md
FormatJSON
ProtocolHTTPS
AuthenticationNone (rate limited per IP)

Refer to the API documentation for endpoints, parameters, response schemas and error codes.

3. Agent Skills

This repository provides reusable Agent Skills to help AI agents understand Vaper Club's data structure and use its services correctly.

Skills are designed to work with compatible AI agent environments and can be extended independently. They are also published for discovery at https://vaper.club/.well-known/agent-skills/index.json.

Available Skills

SkillDescription
vaper-club-discoverySearch posts (news, reviews, guides), brands and retail shops.
vaper-club-product-researchFind and identify products, see prices and stock across shops, compare offers of the same model.
vaper-club-brand-researchBuild a brand profile: background, website, company, aliases, categories and models.
vaper-club-product-reviewsSummarize user reviews, ratings, and common praise and complaints of a product.

See skills/index.json and the skills/ directory for individual skill instructions.

Getting Started

Connect through MCP

Add the following MCP server configuration to an MCP-compatible client:

{
  "mcpServers": {
    "vaper-club": {
      "url": "https://api.vaper.club/mcp"
    }
  }
}

No authentication is required.

Use Agent Skills

Clone this repository:

git clone https://github.com/VaperClub/vaper-club-agent.git

Copy the required directories from skills/ (for example skills/vaper-club-product-research) into the skill directory supported by your AI agent. The skills call the MCP server above, so connect it first.

Use the Public API
curl "https://api.vaper.club/public-api/v1/products/search?q=disposable&pageSize=5"

See docs/api.md for all endpoints.

Use Cases

Vaper Club integrations can help developers and AI agents with:

  • Reading the latest vape industry posts and searching articles.
  • Searching brands and shops, and reading their profiles.
  • Searching products and comparing prices and stock of the same model across retailers.
  • Summarizing product ratings and the newest user reviews.
  • Building applications that consume structured vaping industry data.

Actual capabilities and data availability depend on the API and MCP tools currently exposed by Vaper Club. Vaper Club is intended for adults only and provides no guidance on circumventing age verification or legal restrictions.

Documentation

Contributing

Contributions, suggestions, and improvements are welcome.

You can contribute by:

  • Improving Agent Skills and documentation.
  • Adding integration examples.
  • Reporting incorrect instructions or technical issues.
  • Suggesting additional AI agent use cases.

Please open an issue or submit a pull request.

License

The source files, code examples, and original Agent Skills in this repository are licensed under the MIT License.

This license does not grant rights to Vaper Club trademarks, third-party trademarks, product images, or data accessed through Vaper Club services.

Use of Vaper Club APIs and data is subject to the applicable Vaper Club terms and policies.


Vaper Club
Website: https://vaper.club

Frequently asked questions

What is Vaper.club?

Read-only vape industry data: posts, brands, shops, product search, comparison and reviews.

How do I install Vaper.club?

It runs as a remote server. In Claude Code: claude mcp add --transport http vaper-club 'https://api.vaper.club/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Vaper.club need an API key?

Yes. It expects VAPER_CLUB_API_KEY, which you set in its configuration.

Is Vaper.club open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Vaper.club?

It is published by VaperClub. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.