# Configuration
Configure Hyperion MCP Server via environment variables and runtime options.
## Quick Start (.env)
Create a `.env` file in the project root:
```ini
# Hyperion Network
HYPERION_RPC_URL=https://hyperion-testnet.metisdevops.link
HYPERION_CHAIN_ID=133717
HYPERION_NETWORK_NAME=Hyperion Testnet
HYPERION_EXPLORER_URL=https://hyperion-testnet-explorer.metisdevops.link
HYPERION_CURRENCY_SYMBOL=tMETIS
# Wallets (comma-separated private keys, 64 hex chars without 0x)
# Example placeholder only — put your own keys here
HYPERION_PRIVATE_KEYS=<your_64_hex_private_key>[,<another_key>]
# Optional: Pre-declared addresses (derived if omitted)
HYPERION_ADDRESSES=0xYourWalletAddressHere
# Optional: Default active wallet address
HYPERION_CURRENT_ADDRESS=0xYourWalletAddressHere
# API & Runtime
HYPERION_API_TIMEOUT=30000
HYPERION_MAX_RETRIES=3
NODE_ENV=production
DEBUG=false
```
Notes:
- RPC URL and Explorer URL above match the defaults used by the project. If your deployment uses different endpoints, override here.
- Never commit real private keys. Keep .env in .gitignore.
## All Environment Variables
- HYPERION_RPC_URL (string, required)
- RPC endpoint for Hyperion testnet
- Default: https://hyperion-testnet.metisdevops.link
- HYPERION_CHAIN_ID (number, optional)
- Chain ID for the network
- Default: 133717
- HYPERION_NETWORK_NAME (string, optional)
- Human-readable network name
- Default: "Hyperion Testnet"
- HYPERION_EXPLORER_URL (string, optional)
- Block explorer base URL
- Default: https://hyperion-testnet-explorer.metisdevops.link
- HYPERION_CURRENCY_SYMBOL (string, optional)
- Native currency symbol
- Default: tMETIS
- HYPERION_PRIVATE_KEYS (string, required for write ops)
- One or more wallet private keys, comma-separated
- Each is 64 hex chars (no 0x prefix)
- Used for signing transactions, deployments, minting
- HYPERION_ADDRESSES (string, optional)
- Comma-separated addresses corresponding to HYPERION_PRIVATE_KEYS
- If omitted, addresses are derived from private keys
- HYPERION_CURRENT_ADDRESS (string, optional)
- Sets the default active wallet
- If omitted, the first wallet is used
- HYPERION_API_TIMEOUT (number, optional)
- Request timeout in ms (default: 30000)
- HYPERION_MAX_RETRIES (number, optional)
- Retry count for transient failures (default: 3)
- NODE_ENV (string, optional)
- "production" | "development" (default: production)
- DEBUG (boolean|string, optional)
- Enable debug logs (e.g., "true" or namespace like "hyperion:*")
## MCP Client Configuration
### Claude Desktop
Add the Hyperion MCP server to Claude configuration:
```json
{
"mcpServers": {
"hyperion": {
"command": "node",
"args": ["/absolute/path/to/hyperion-mcp-server/build/index.js"]
}
}
}
```
### Cline (VS Code)
```json
{
"mcpServers": {
"hyperion": {
"command": "node",
"args": ["./build/index.js"],
"cwd": "/absolute/path/to/hyperion-mcp-server"
}
}
}
```
## Smithery Configuration
When deploying with Smithery, set these environment variables in the dashboard (never commit secrets):
```
HYPERION_RPC_URL=https://hyperion-testnet.metisdevops.link
HYPERION_PRIVATE_KEYS=<your_64_hex_private_key>
HYPERION_CHAIN_ID=133717
```
## Security Recommendations
- Keep .env files out of version control (.gitignore)
- Prefer secret managers in production (AWS Secrets Manager, Vault, Azure Key Vault)
- Rotate private keys regularly; never share mnemonics/keys
- Limit funded keys in test environments; use least privilege
## Validation
On startup, the server validates required variables. If missing:
- Read error message, add the missing variables to .env
- Ensure private keys match the 64-hex format without 0x
## Example: Minimal .env for Read-Only
```ini
HYPERION_RPC_URL=https://hyperion-testnet.metisdevops.link
HYPERION_CHAIN_ID=133717
```
## Example: Full .env for Write Operations
```ini
HYPERION_RPC_URL=https://hyperion-testnet.metisdevops.link
HYPERION_CHAIN_ID=133717
HYPERION_PRIVATE_KEYS=<your_64_hex_private_key>
HYPERION_API_TIMEOUT=30000
HYPERION_MAX_RETRIES=3
```
