Servers API

https://api.agentflare.com/v1/servers

{
  "success": true,
  "data": [
    {
      "id": "srv_abc123",
      "name": "search-server",
      "type": "http",
      "endpoint": "https://search.example.com/mcp",
      "status": "active",
      "health": "healthy",
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "pages": 1
  }
}

{
  "success": true,
  "data": {
    "id": "srv_abc123",
    "name": "my-server",
    "type": "http",
    "endpoint": "https://my-server.example.com/mcp",
    "status": "active",
    "health": "unknown",
    "created_at": "2024-01-01T00:00:00Z",
    "updated_at": "2024-01-01T00:00:00Z"
  }
}

{
  "success": true,
  "data": {
    "status": "healthy",
    "response_time": 125,
    "last_check": "2024-01-01T00:00:00Z",
    "uptime": "99.9%",
    "error_rate": "0.1%"
  }
}

{
  "name": "search-server",
  "type": "http",
  "endpoint": "https://search.example.com/mcp",
  "authentication": {
    "type": "bearer",
    "token": "your-server-token"
  },
  "timeout": 30000,
  "retry": {
    "enabled": true,
    "max_attempts": 3,
    "backoff": "exponential"
  }
}

{
  "name": "realtime-server",
  "type": "websocket",
  "endpoint": "wss://realtime.example.com/mcp",
  "authentication": {
    "type": "oauth2",
    "client_id": "your-client-id",
    "client_secret": "your-client-secret"
  },
  "heartbeat": {
    "enabled": true,
    "interval": 30000
  }
}

{
  "name": "local-server",
  "type": "stdio",
  "command": "/usr/local/bin/mcp-server",
  "args": ["--config", "/etc/mcp/config.json"],
  "env": {
    "MCP_SERVER_TOKEN": "your-token",
    "LOG_LEVEL": "info"
  },
  "working_directory": "/app"
}

{
  "success": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "Invalid server configuration",
    "details": {
      "field": "endpoint",
      "issue": "Invalid URL format"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "SERVER_NOT_FOUND",
    "message": "Server not found",
    "details": {
      "server_id": "srv_abc123"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "SERVER_NAME_EXISTS",
    "message": "A server with this name already exists",
    "details": {
      "name": "duplicate-server-name"
    }
  }
}