curl "https://api.agent-corex.com/mcp_servers" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "servers": [
    {
      "name": "github-mcp",
      "display_name": "GitHub",
      "description": "GitHub API and Git operations",
      "url": "https://github.com",
      "enabled": true,
      "installed": true,
      "tools_count": 12,
      "icon": "github",
      "category": "version-control"
    },
    {
      "name": "aws-mcp",
      "display_name": "AWS",
      "description": "Amazon Web Services",
      "url": "https://aws.amazon.com",
      "enabled": false,
      "installed": true,
      "tools_count": 28,
      "icon": "aws",
      "category": "infrastructure"
    }
  ],
  "total": 25,
  "enabled_count": 12
}

curl -X POST "https://api.agent-corex.com/mcp_servers/toggle" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "server": "aws-mcp",
    "enabled": true
  }'

curl -X POST "https://api.agent-corex.com/mcp_servers/toggle" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "server": "aws-mcp",
    "enabled": false
  }'

{
  "server": "aws-mcp",
  "enabled": true,
  "status": "activated",
  "tools_enabled": 28
}

{
  "error": {
    "code": "SERVER_NOT_FOUND",
    "message": "Server 'aws-mcp' not found"
  }
}

curl "https://api.agent-corex.com/tools/installed" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "tools": [
    {
      "name": "create_pull_request",
      "server": "github-mcp",
      "description": "Create a new pull request",
      "enabled": true
    }
  ],
  "total": 40
}

curl "https://api.agent-corex.com/mcp_registry"

{
  "servers": [
    {
      "name": "github-mcp",
      "display_name": "GitHub",
      "description": "GitHub API and Git operations",
      "version": "1.0.0",
      "tools_count": 12,
      "category": "version-control",
      "tags": ["git", "github", "pr", "issues"],
      "url": "https://github.com",
      "icon": "github"
    }
  ],
  "total": 25
}

curl "https://api.agent-corex.com/mcp_registry/github-mcp"

{
  "name": "github-mcp",
  "display_name": "GitHub",
  "description": "GitHub API and Git operations",
  "version": "1.0.0",
  "url": "https://github.com",
  "icon": "github",
  "category": "version-control",
  "tags": ["git", "github", "pr", "issues"],
  "tools": [
    {
      "name": "create_pull_request",
      "description": "Create a new pull request"
    },
    {
      "name": "create_issue",
      "description": "Create a new GitHub issue"
    }
  ],
  "tools_count": 12,
  "authentication": {
    "type": "token",
    "required": true,
    "env_var": "GITHUB_TOKEN"
  },
  "rate_limit": {
    "requests_per_hour": 60
  },
  "supported_platforms": ["linux", "macos", "windows"]
}

curl -X POST "https://api.agent-corex.com/admin/mcp_registry" \
  -H "Authorization: Bearer ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "custom-mcp",
    "display_name": "Custom Server",
    "description": "My custom MCP server",
    "url": "https://my-server.com",
    "icon": "custom",
    "category": "custom",
    "tools_count": 5
  }'

curl -X PATCH "https://api.agent-corex.com/admin/mcp_registry/github-mcp" \
  -H "Authorization: Bearer ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated description",
    "tools_count": 15
  }'

curl -X DELETE "https://api.agent-corex.com/admin/mcp_registry/github-mcp" \
  -H "Authorization: Bearer ADMIN_KEY"

curl -X POST "https://api.agent-corex.com/admin/mcp_registry/sync-to-supabase" \
  -H "Authorization: Bearer ADMIN_KEY"

{
  "status": "success",
  "synced_count": 25,
  "timestamp": "2024-01-15T10:30:00Z"
}

{
  "server": "github-mcp",
  "authentication": {
    "type": "token",
    "required": true,
    "env_var": "GITHUB_TOKEN",
    "setup_url": "https://github.com/settings/tokens"
  }
}

{
  "server": "aws-mcp",
  "authentication": {
    "type": "credentials",
    "required": true,
    "env_vars": ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_REGION"],
    "setup_url": "https://aws.amazon.com/iam"
  }
}

// ✅ Good - Enable specific servers
await toggleServer('github-mcp', true);
await toggleServer('aws-mcp', true);

// ❌ Bad - Enable all servers
const servers = await listServers();
servers.forEach(s => toggleServer(s.name, true));

async function installServer(serverName) {
  const server = await getServerFromRegistry(serverName);
  
  // Check if authentication is available
  if (server.authentication.required) {
    const token = process.env[server.authentication.env_var];
    if (!token) {
      throw new Error(`Set ${server.authentication.env_var} environment variable`);
    }
  }
  
  return toggleServer(serverName, true);
}

async function checkServerHealth() {
  const servers = await listServers();
  
  const health = servers.map(s => ({
    name: s.name,
    enabled: s.enabled,
    tools: s.tools_count,
    status: s.enabled ? 'active' : 'inactive'
  }));
  
  return health;
}

// Device 1: Save state
async function pushServerState() {
  const servers = await listServers();
  const enabled = servers.filter(s => s.enabled).map(s => s.name);
  
  return await pushUserServers({
    enabled_servers: enabled
  });
}

// Device 2: Load state
async function pullServerState() {
  const user = await getUserServers();
  
  for (const server of user.enabled_servers) {
    await toggleServer(server, true);
  }
}