Skip to main content

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.

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

VariableRequiredDescription
WANIWANI_API_KEYYesAPI key for your MCP environment. See API Keys.
WANIWANI_API_URLNoOverride 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:*]):
VariableValuesDescription
WANIWANI_LOG_LEVELdebug | warn | error | noneControls SDK log verbosity. Defaults to none.
WANIWANI_DEBUGAny truthy valueLegacy shorthand. Equivalent to WANIWANI_LOG_LEVEL=debug.
If both are set, WANIWANI_LOG_LEVEL takes precedence.
.env
# Enable debug logs
WANIWANI_LOG_LEVEL=debug
The chat server adapters (toNextJsHandler, toExpressJsHandler) also accept a debug option that overrides the env var for that handler only.

Encryption

VariableRequiredDescription
WANIWANI_ENCRYPTION_KEYNoBase64-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.