# Test MCP Connection

Test the connection to an MCP server and verify that it is reachable and responding correctly.

#### Path Parameters

**`config_id`** string required
The MCP configuration ID (mcp_ prefixed string).

## Returns

Connection test result including health status and available tools.

Request

```bash
curl -X POST "https://api.aitronos.com/v1/mcp-configurations/mcp_abc123xyz/test" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.post(
    "https://api.aitronos.com/v1/mcp-configurations/mcp_abc123xyz/test",
    headers={"X-API-Key": api_key}
)

response.raise_for_status()
result = response.json()
print(f"Connection Status: {result['data']['connectionStatus']}")
```


```javascript
const response = await fetch(
  "https://api.aitronos.com/v1/mcp-configurations/mcp_abc123xyz/test",
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.FREDDY_API_KEY
    }
  }
);

if (!response.ok) {
  throw new Error("Request failed");
}

const result = await response.json();
console.log(`Connection Status: ${result.data.connectionStatus}`);
```

200 OK

```json
{
  "success": true,
  "status": "connected",
  "message": "Successfully connected to MCP server",
  "availableTools": [
    "get_workspace_hierarchy",
    "create_task",
    "get_task_details",
    "update_task",
    "delete_task",
    "get_lists_in_folder",
    "get_tasks_in_list"
  ]
}
```

404 Not Found

```json
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "MCP configuration with ID 'mcp_abc123xyz' not found.",
    "system_message": "Resource not found",
    "type": "not_found_error",
    "status": 404,
    "trace_id": "req_mno345",
    "timestamp": "2025-11-13T10:30:00Z"
  }
}
```