> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waniwani.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Environment Variables

> All environment variables recognized by the Waniwani SDK.

The SDK reads the following environment variables at runtime. None are required at import time; they are checked when the relevant feature is used.

## Authentication

| Variable | Required | Description |
| - | - | - |
| `WANIWANI_API_KEY` | Yes | API key for your MCP environment. See [API Keys](https://docs.waniwani.ai/sdk/configuration/api-key.md). |
| `WANIWANI_API_URL` | No | Override the API base URL. Defaults to `https://app.waniwani.ai`. Use `https://eu.app.waniwani.ai` for the EU region. |

## Logging

By default the SDK is silent. Set one of these to enable internal logs (prefixed `[waniwani:*]`):

| Variable | Values | Description |
| - | - | - |
| `WANIWANI_LOG_LEVEL` | `debug` \| `warn` \| `error` \| `none` | Controls SDK log verbosity. Defaults to `none`. |
| `WANIWANI_DEBUG` | Any truthy value | Legacy shorthand. Equivalent to `WANIWANI_LOG_LEVEL=debug`. |

If both are set, `WANIWANI_LOG_LEVEL` takes precedence.

```bash .env theme={null}
# Enable debug logs
WANIWANI_LOG_LEVEL=debug
```

## Encryption

| Variable | Required | Description |
| - | - | - |
| `WANIWANI_ENCRYPTION_KEY` | No | Base64-encoded 32-byte key for AES-256-GCM encryption of KV store values. When set, all values written through the KV store are encrypted at rest. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.