Metadata-Version: 2.4
Name: sudiq-mcp
Version: 0.2.2
Summary: Model Context Protocol server for SudIQ — verified supplement intelligence for AI agents.
Project-URL: Homepage, https://sudiq.com
Project-URL: Documentation, https://sudiq.com/mcp
Project-URL: Issues, https://github.com/jaysentuff/suppguidev2/issues
Author-email: SudIQ <hello@sudiq.com>
License: Proprietary
Keywords: ai-agents,anthropic,claude,ingredient-data,mcp,supplements
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic-settings>=2.1.0
Requires-Dist: pydantic>=2.5.0
Requires-Dist: python-dotenv>=1.0.0
Description-Content-Type: text/markdown

# sudiq-mcp

**Model Context Protocol server for [SudIQ](https://sudiq.com)** — connects your AI agent to label-verified ingredient panels, clinical dose context, and competitive intelligence across 6,200+ supplement products.

## Install

The recommended way to use this server is through [uvx](https://docs.astral.sh/uv/) directly from your agent's MCP config — no manual install required.

### Claude Desktop

Edit `claude_desktop_config.json`:

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "sudiq": {
      "command": "uvx",
      "args": ["--from", "sudiq-mcp", "sudiq-mcp"],
      "env": {
        "SUDIQ_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}
```

Restart Claude Desktop. Try a query: *"Compare the caffeine dosing in Ghost Legend vs C4 Original — which is closer to clinically effective range?"*

### Other agents / manual install

```bash
pip install sudiq-mcp
SUDIQ_API_KEY=sk_live_... sudiq-mcp
```

## Get an API key

Available on every paid SudIQ tier (starting at $99/mo). [Sign up at sudiq.com](https://sudiq.com).

## Tools exposed

| Tool | Purpose |
|------|---------|
| `compare_products` | Aligned diff matrix for 2–5 products: shared, missing, and differently-dosed ingredients |
| `check_dose_safety` | Verify a dose falls within the clinically studied range |
| `find_products_by_ingredient` | Find products containing an ingredient at or above a minimum dose |
| `get_ingredient_info` | Clinical dose ranges, forms, aliases, safety notes for any of 3,180 indexed ingredients |
| `get_product_ingredients` | Full structured ingredient list for a product by name |
| `get_product_label_status` | Verification confidence and label type for a product |
| `find_alternatives` | Alternative products in the same category, ranked by ingredient overlap |
| `search_products` | Keyword search across the catalog |

## License

Proprietary. Licensed for use with valid SudIQ API credentials. See [sudiq.com/terms](https://sudiq.com/terms).
