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.0

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.0
File Size Uploaded Provenance Actions
vaper_club_mcp-1.0.0.tar.gz 7.8 kB Without provenance Details for vaper_club_mcp-1.0.0.tar.gz

Built distribution (wheel)

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

Total release size: 16.7 kB

Release files / vaper_club_mcp-1.0.0.tar.gz

Download URL vaper_club_mcp-1.0.0.tar.gz
Size 7.8 kB
Tags Source
SHA-256 checksum
How to use checksums
b4d0069d0eb9ba7f28e57f3e77d3d2dfa5c45a966a5b2fc7e55527736b3df7c5
BLAKE2b-256 checksum
How to use checksums
6e1c7ca29d76741ee4da39fc1fc5a7c0e8ede0a8d144af242a0e5a0481b9614d
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.0-py3-none-any.whl

Download URL vaper_club_mcp-1.0.0-py3-none-any.whl
Size 8.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1f3ada02b1d8e6e6fa7161585cf7f3e7c3341bbf26a5cf1083ca5223b794b2e4
BLAKE2b-256 checksum
How to use checksums
6e3b73d5e5d915d6097ecbee7a3cf80927b61c54dd75aa3f97a0ee6d03f5994e
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.0

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.0 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