Skip to main content

Vaper.club MCP Server (Python, local STDIO adapter)

vaper-club-mcp is a lightweight Model Context Protocol server that runs locally over STDIO and forwards every tool call to the Vaper.club Public API. It is functionally identical to the npm package of the same name.

Vaper.club also runs a hosted MCP server at https://api.vaper.club/mcp/.

Tools

All tools are read-only and return the unmodified Public API response. Cite the sourceUrl of each result.

search_products, compare_products, get_product_reviews, search_brands, get_brand_details, get_product_categories, get_latest_posts, search_posts, search_shops, get_shop_details.

Installation and usage

Requires Python 3.10 or newer.

uvx vaper-club-mcp
# or
pip install vaper-club-mcp && vaper-club-mcp

MCP client configuration:

{
  "mcpServers": {
    "vaper-club": {
      "command": "uvx",
      "args": ["vaper-club-mcp"]
    }
  }
}

Configuration

Variable Default Description
VAPER_CLUB_API_BASE_URL https://api.vaper.club/public-api/v1/ Public API base URL
VAPER_CLUB_API_TIMEOUT 15 Request timeout in seconds (0–300)
VAPER_CLUB_API_KEY (none) Optional bearer token

Development and publishing

pip install -e ".[dev]"
pytest
python -m build
twine upload dist/*   # username: __token__, password: your PyPI API token

Releases are published by the publish-pypi GitHub workflow on tags named mcp-server-python-v<version> (PyPI Trusted Publishing). Keep version in pyproject.toml and src/vaper_club_mcp/__init__.py in sync.

Prices and stock may lag the shop websites. The data is for adults only.

License

MIT

Metadata

Release files for vaper-club-mcp 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for vaper-club-mcp 1.0.1
File Size Uploaded Provenance Actions
vaper_club_mcp-1.0.1.tar.gz 7.8 kB Without provenance Details for vaper_club_mcp-1.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for vaper-club-mcp 1.0.1
File Interpreter ABI Platform Actions
vaper_club_mcp-1.0.1-py3-none-any.whl Python 3 none any Details for vaper_club_mcp-1.0.1-py3-none-any.whl

Total release size: 16.7 kB

Release files / vaper_club_mcp-1.0.1.tar.gz

Download URL vaper_club_mcp-1.0.1.tar.gz
Size 7.8 kB
Tags Source
SHA-256 checksum
How to use checksums
ace4926b0cd02faf5c0aa40d459657cb2d5c6a8103231a922da5f1466147e1a9
BLAKE2b-256 checksum
How to use checksums
22da2b0d52ea11e30a9cbadbe4a319248d0aa267fc0cb5ffa859f146515e1047
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.9

Release files / vaper_club_mcp-1.0.1-py3-none-any.whl

Download URL vaper_club_mcp-1.0.1-py3-none-any.whl
Size 8.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cf9a75200c1b91a48c5d7635301fd9451cf0e3b6e198d9d0bb32ebaebbac65e7
BLAKE2b-256 checksum
How to use checksums
a19d633055527bd85cc0561d696f4d5b6074b8e677eb00de23970a8d92f2a167
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.9

Security for vaper-club-mcp 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page