# List Custom MCP Servers

Returns paginated list of custom MCP configurations for the authenticated organization.

#### Query Parameters

**`organization_id`** string required
Organization ID to filter configurations by (org_ prefixed string).

**`type`** string optional
Filter by MCP type. Values: `custom`, `streamline`, `personal_connector`.

**`is_active`** boolean optional
Filter by active status. Only active configurations if true.

## Returns

A list of custom MCP server configurations with authentication type, server details, and connection status.

Request

```bash
curl "https://api.aitronos.com/v1/mcp-configurations?organization_id=org_xyz789&type=custom" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.get(
    "https://api.aitronos.com/v1/mcp-configurations",
    headers={
        "X-API-Key": api_key
    },
    params={
        "organization_id": "org_xyz789",
        "type": "custom",
        "is_active": True
    }
)

response.raise_for_status()
result = response.json()
print(f"Found {result['data']['total_count']} MCP servers")
```


```javascript
const response = await fetch(
  "https://api.aitronos.com/v1/mcp-configurations?organization_id=org_xyz789&type=custom&is_active=true",
  {
    headers: {
      "X-API-Key": process.env.FREDDY_API_KEY
    }
  }
);

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

const result = await response.json();
console.log(`Found ${result.data.total_count} MCP servers`);
```

200 OK

```json
{
  "configurations": [
    {
      "id": "mcp_1234567890abcdef1234567890abcdef",
      "name": "GitHub MCP",
      "type": "custom",
      "organization_id": "org_xyz789",
      "userId": "usr_abc123def456",
      "server_url": "https://github-mcp.example.com",
      "transportType": "sse",
      "authType": "api_key",
      "isActive": true,
      "connectionStatus": "connected",
      "lastConnectedAt": "2025-11-13T10:30:00Z",
      "errorMessage": null,
      "created_at": "2025-11-13T10:00:00Z",
      "updated_at": "2025-11-13T10:30:00Z"
    },
    {
      "id": "mcp_abcdef1234567890abcdef1234567890",
      "name": "ClickUp MCP",
      "type": "personal_connector",
      "organization_id": "org_xyz789",
      "userId": "usr_abc123def456",
      "server_url": "https://clickup-mcp.aitronos.com",
      "transportType": "http",
      "authType": "oauth",
      "isActive": true,
      "connectionStatus": "connected",
      "lastConnectedAt": "2025-11-13T09:15:00Z",
      "errorMessage": null,
      "created_at": "2025-11-12T16:20:00Z",
      "updated_at": "2025-11-13T09:15:00Z"
    }
  ],
  "total": 2
}
```

401 Unauthorized

```json
{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required. Please provide a valid API key.",
    "system_message": "Missing or invalid authorization header",
    "type": "authentication_error",
    "status": 401,
    "trace_id": "req_abc123",
    "timestamp": "2025-11-13T10:30:00Z"
  }
}
```