# Healthy Aging Atlas

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/RustamIsmail/healthyagingatlas-mcp  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/healthy-aging-atlas

## Description
Evidence-ranked supplement data: search, compare, price history, goal recs. No API key.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "healthy-aging-atlas": {
    "command": "npx",
    "args": ["-y","healthy-aging-atlas"]
  }
}
```

## Documentation & README

# Healthy Aging Atlas — MCP Server

Evidence-ranked supplement data for AI agents. No API key required.

**Live endpoint:** `https://healthyagingatlas.com/api/mcp/`  
**Transport:** Streamable HTTP (JSON-RPC 2.0)  
**Discovery:** `https://healthyagingatlas.com/.well-known/mcp.json`  
**Docs:** `https://healthyagingatlas.com/developers/`

---

## Connect in 30 seconds

### Claude.ai / Claude Desktop
1. Settings → Integrations → MCP Servers
2. Enter: `https://healthyagingatlas.com/api/mcp/`
3. Start a new conversation — 5 tools appear automatically

### Cursor
1. Settings → Tools & Integrations → MCP → Add MCP Server
2. URL: `https://healthyagingatlas.com/api/mcp/`
3. Transport: Streamable HTTP

### curl
```bash
curl -s -X POST https://healthyagingatlas.com/api/mcp/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
```

---

## Tools

| Tool | Description |
|------|-------------|
| `search_supplements` | Search by name, ingredient, or brand. Returns trust-scored products with prices and purchase links. |
| `get_product` | Full product details: trust score, certifications, price, evidence summary. |
| `compare_supplements` | Head-to-head comparison with key differences, best use cases, and verdict. |
| `get_price_history` | 90-day price history and freshness data. |
| `recommend_for_goal` | Evidence-ranked recommendations for a health goal with optional budget/demographic filters. |

All tools are **read-only** (`readOnlyHint: true`). No authentication required.

---

## Example calls

**Search for magnesium products for sleep:**
```bash
curl -s -X POST https://healthyagingatlas.com/api/mcp/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {
      "name": "search_supplements",
      "arguments": { "query": "magnesium", "goal": "sleep", "limit": 3 }
    }
  }'
```

**Compare NMN vs NR:**
```bash
curl -s -X POST https://healthyagingatlas.com/api/mcp/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 2, "method": "tools/call",
    "params": {
      "name": "compare_supplements",
      "arguments": { "supplement_a": "nmn", "supplement_b": "nr" }
    }
  }'
```

**Top sleep supplements under $40:**
```bash
curl -s -X POST https://healthyagingatlas.com/api/mcp/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 3, "method": "tools/call",
    "params": {
      "name": "recommend_for_goal",
      "arguments": { "goal": "sleep", "budget_usd": 40, "limit": 3 }
    }
  }'
```

---

## Troubleshooting

| Issue | Fix |
|-------|-----|
| 308 redirect | Use trailing slash: `/api/mcp/` |
| 405 Method Not Allowed | Use POST only |
| Tool not found | Names are case-sensitive: `search_supplements`, `get_product`, `compare_supplements`, `get_price_history`, `recommend_for_goal` |
| Claude Desktop shows no tools | Start a **new** conversation after adding the server |

---

## Notes

- Responses include Amazon Associates affiliate links (tag: `healthagingat-20`). Rankings are based on evidence quality, not commission rates.
- This repo contains the reference implementation (`server.js`). The live server runs on Vercel at `healthyagingatlas.com`.
- Privacy Policy: `https://healthyagingatlas.com/privacy/`
- Terms of Service: `https://healthyagingatlas.com/terms/`

