Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | Server host binding | |
| PORT | No | Server port | 8000 |
| AUTH_TYPE | No | Authentication type (jwt/oauth) | |
| LOG_LEVEL | No | Logging level | INFO |
| DEBUG_MODE | No | Enable debug mode | false |
| JWT_ISSUER | No | JWT issuer | vivint-mcp-server |
| AUTH_SECRET | No | Strong secret for HMAC JWT signing | |
| ENVIRONMENT | No | Environment (development/production) | development |
| AUTH_ENABLED | No | Enable authentication | true |
| JWT_AUDIENCE | No | JWT audience | vivint-mcp-client |
| JWT_ALGORITHM | No | JWT algorithm (HS256/RS256) | |
| JWT_PUBLIC_KEY | No | Public key for RSA JWT verification | |
| JWT_PRIVATE_KEY | No | Private key for RSA JWT signing | |
| OAUTH_CLIENT_ID | No | OAuth client ID | |
| VIVINT_MFA_CODE | No | 6-digit MFA code for 2FA/MFA setup | |
| VIVINT_PASSWORD | Yes | Your Vivint password | |
| VIVINT_USERNAME | Yes | Your Vivint email address | |
| VIVINT_SYSTEM_ID | No | Specific system ID if you have multiple systems | |
| RATE_LIMIT_ENABLED | No | Enable rate limiting for login endpoints | true |
| TOKEN_EXPIRY_HOURS | No | Token expiry hours | 24 |
| OAUTH_CLIENT_SECRET | No | OAuth client secret | |
| OAUTH_REDIRECT_URIS | No | OAuth redirect URIs (comma-separated) | https://claude.ai/api/mcp/auth_callback,http://localhost:3000/callback,http://localhost:8080/callback |
| VIVINT_MFA_AUTO_WAIT | No | Auto wait for MFA | false |
| CLOUDFLARE_TUNNEL_URL | No | Cloudflare tunnel URL | |
| TOKEN_REFRESH_INTERVAL | No | Token refresh interval in seconds | 18000 |
| RATE_LIMIT_MAX_ATTEMPTS | No | Maximum rate limit attempts | 1 |
| SESSION_REFRESH_INTERVAL | No | Session refresh interval in seconds | 900 |
| OAUTH_DISABLE_NEW_CLIENTS | No | Disable new OAuth clients | false |
| VIVINT_REFRESH_TOKEN_FILE | No | File path for storing refresh tokens | .vivint_tokens.json |
| RATE_LIMIT_LOCKOUT_MINUTES | No | Rate limit lockout duration in minutes | 5 |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |