# wp_test_auth

Tests the authentication and connectivity for a configured WordPress site with detailed connection diagnostics.
**Usage Examples:** • Test connection: `wp_test_auth` • Multi-site test: `wp_test_auth --site="my-site"` • Verify setup:
Use this after configuring new credentials • Troubleshoot: Run when experiencing connection issues • Health check:
Regular verification of WordPress connectivity
## Parameters
_No parameters required._
## Examples
### Basic auth Usage
Simple example of using wp_test_auth
**Command:**
```bash
wp_test_auth
```
**Response:**
```json
{
"success": true,
"data": {},
"message": "wp_test_auth executed successfully"
}
```
**Error Example (Authentication failure):**
```json
{
"error": "Authentication failed",
"message": "Invalid credentials or insufficient permissions"
}
```
## Response Format
**Return Type:** `object`
```json
{
"success": true,
"data": {
// object response data
},
"metadata": {
"timestamp": "2024-01-01T00:00:00.000Z",
"tool": "wp_test_auth",
"site": "site1"
}
}
```
## Error Handling
### AUTHENTICATION_FAILED
**Message:** Authentication failed **Description:** Invalid credentials or insufficient permissions **Resolution:**
Check your authentication credentials and user permissions
### VALIDATION_ERROR
**Message:** Parameter validation failed **Description:** One or more required parameters are missing or invalid
**Resolution:** Review the required parameters and their formats
### NOT_FOUND
**Message:** Resource not found **Description:** The requested resource does not exist **Resolution:** Verify the
resource ID and ensure it exists
### PERMISSION_DENIED
**Message:** Insufficient permissions **Description:** The user does not have permission to perform this action
**Resolution:** Contact an administrator to grant the necessary permissions
---
_Generated automatically from tool definitions - Do not edit manually_