{
  "mcpServers": {
    "failsafe": {
      "command": "npx",
      "args": ["-y", "failsafe-mcp-server"]
    }
  }
}

claude mcp add failsafe -- npx -y failsafe-mcp-server

npm install -g failsafe-mcp-server
failsafe-mcp-server

> failsafe_store provider:"openai" key:"sk-abc123" backup_key:"sk-xyz789"

✓ Credential stored for openai. Backup configured.

> failsafe_get provider:"openai"

{
  "key": "sk-abc123",
  "source": "primary",
  "status": "healthy"
}

> failsafe_get provider:"openai"

{
  "key": "sk-xyz789",
  "source": "backup",
  "warnings": ["Primary credential is unhealthy. Using backup."]
}

> failsafe_list

{
  "summary": { "total": 4, "healthy": 3, "unhealthy": 1, "expired": 0 },
  "credentials": [
    { "provider": "openai", "status": "healthy", "has_backup": true },
    { "provider": "anthropic", "status": "healthy", "has_backup": false },
    { "provider": "github", "status": "unhealthy", "has_backup": true },
    { "provider": "stripe", "status": "healthy", "has_backup": false }
  ]
}

> failsafe_health

{
  "summary": { "total": 4, "healthy": 3, "unhealthy": 1 },
  "results": [
    { "provider": "openai", "status": "healthy", "latency_ms": 245 },
    { "provider": "anthropic", "status": "healthy", "latency_ms": 189 },
    { "provider": "github", "status": "unhealthy", "response_code": 401 },
    { "provider": "stripe", "status": "healthy", "latency_ms": 312 }
  ]
}

> failsafe_store provider:"my-saas" key:"token_abc" health_check_url:"https://api.my-saas.com/health"

Agent requests credential for "openai"
  ↓
Failsafe checks primary key status
  ↓
├─ Healthy? → return primary key
├─ Unhealthy/Expired? → check for backup
│   ├─ Backup exists? → return backup key + warning
│   └─ No backup? → return primary key + warning

~/.failsafe/
├── master.key         # Encryption key (auto-generated)
└── credentials.json   # Encrypted credential store