MCP server for the Suppevo supplement-tracking platform API
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"suppevo-data-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Suppevo MCP Server An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that exposes the Suppevo supplement-tracking platform API as tools for AI assistants. ## Features | Category | Description | |----------|-------------| | **Profile** | Manage user profiles and preferences | | **Products** | CRUD, bulk operations, search (admin + public) | | **Supplements** | Track user supplement routines | | **Schedules** | Dosing schedules with reminders | | **Doses** | Log and query dose history | | **Reviews** | Create, moderate, and browse reviews | | **Rewards** | Points, badges, streaks, challenges | | **Brands** | Brand management and discovery | | **Brand Owners** | Brand owner portal tools | | **Ingredients** | CRUD, search, bulk ops, intelligence | | **Ingredient Intelligence** | Alternatives, interactions, dosing guides, effectiveness | | **Biomarkers** | Admin and public biomarker data | | **Evidence Links** | Scientific evidence management | | **Benefits** | Health benefit categories | | **Scoring** | Product and ingredient scoring | | **Stack Analysis** | Analyze supplement stacks | | **Suggestions** | User and admin suggestion workflows | | **News** | Public news feed | | **Exports** | Data export tools | | **Admin** | User groups, brand assignments | ## Quick Start ### Prerequisites - Python 3.11+ - A Suppevo API token (JWT from Cognito) ### Install from PyPI ```bash pip install suppevo-mcp ``` Or run directly with `uvx` (no install needed): ```bash uvx suppevo-mcp ``` ### Install from source ```bash git clone https://github.com/GomezMera-IO-LLC/suppevo-data-mcp.git cd suppevo-data-mcp pip install -e . ``` ## Configuration The server loads environment variables from `~/.env` (your home directory). This keeps credentials out of project files and version control. ### Setup your `~/.env` Create or edit `~/.env`: ```bash # Suppevo MCP Server SUPPEVO_API_TOKEN=your-jwt-token-here SUPPEVO_REFRESH_TOKEN=your-refresh-token-here …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.