# Supplement

Local NIH Dietary Supplement Label Database (CC0) products with declared ingredients mapped to compound_id. Every non-status response includes a medical / label disclaimer.

**Service id:** `supplement`  
**Version:** `0.1.0`  
**Status:** `available`

## Authentication

MCP endpoint: `https://mcp.glc-rag.hu/mcp` (streamable HTTP)

**Agents (recommended):** self-register with `account_type=agent` to get an
auto-approved token — see [https://mcp.glc-rag.hu/guide/agent](https://mcp.glc-rag.hu/guide/agent).

Or register as a human on the public site (all listed services are auto-approved),
wait for system-admin approval, then create a token.

```http
Authorization: Bearer mcp_...
```

Cursor `mcp.json` example:

```json
{
  "mcpServers": {
    "supplement": {
      "url": "https://mcp.glc-rag.hu/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_TOKEN"
      }
    }
  }
}
```

## Tools

### `supplement_resolve`

Resolve product name, brand, or barcode to DSLD product candidates.

**Input schema:**

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}
```

**Examples:**

```json
{
  "query": "vitamin d"
}
```

```json
{
  "query": "magnesium glycinate"
}
```

### `supplement_lookup`

Lookup one product by product_id or dsld_id; returns full declared ingredient list with compound_id links.

**Input schema:**

```json
{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "e.g. supp:dsld:82118"
    },
    "dsld_id": {
      "type": "string",
      "description": "Numeric DSLD id"
    }
  },
  "additionalProperties": false
}
```

**Examples:**

```json
{
  "dsld_id": "82118"
}
```

```json
{
  "product_id": "supp:dsld:82118"
}
```

### `supplement_search_by_compound`

Find products that declare a hatóanyag (compound_id or name query).

**Input schema:**

```json
{
  "type": "object",
  "properties": {
    "compound_id": {
      "type": "string"
    },
    "query": {
      "type": "string",
      "maxLength": 200
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    }
  },
  "additionalProperties": false
}
```

**Examples:**

```json
{
  "query": "magnesium",
  "limit": 10
}
```

```json
{
  "compound_id": "cmpd:citral"
}
```

### `supplement_status`

Supplement DB counts, dump import runs, compound link coverage (free).

**Input schema:**

```json
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
```

**Examples:**

```json
{}
```

## Usage notes

Flow: supplement_resolve → supplement_lookup; or supplement_search_by_compound(compound_id|query). Hatóanyag törzs: compound MCP. supplement_status is free.

## Errors / limits

Empty query → empty. Unknown id → found=false. DB unavailable → is_error.

## Agent discovery

- Agent registration: `https://mcp.glc-rag.hu/guide/agent`
- Markdown: `https://mcp.glc-rag.hu/guide/supplement.md`
- Index: `https://mcp.glc-rag.hu/llms.txt`
- MCP resource: `docs://supplement`