MCP servers

MCP servers can be saved organization integrations or inline portable definitions attached to an eval.

Command

List MCP servers

lightsage mcp-servers list --output-format json

The response includes transport metadata without exposing credentials, environment values, or OAuth secrets. Use a saved MCP server ID in an eval or configuration:

lightsage evals create \
  --name "Test MCP auth" \
  --prompt "List available tools." \
  --judge "Tools are listed." \
  --agent codex:gpt-5-4 \
  --mcp 550e8400-e29b-41d4-a716-446655440000

lightsage evals configurations create --eval-id eval_123 \
  --mcp-server-ids mcp_support_123 \
  --name "With supporting tools"

For an inline server, pass JSON or an @file containing one server definition:

lightsage evals run \
  --prompt "List the available Lightsage tools." \
  --judge "The tools are listed." \
  --agent codex:gpt-5-4 \
  --mcp '{
    "name": "lightsage",
    "type": "http",
    "url": "https://mcp.lightsage.com/mcp",
    "headers": {
      "X-Lightsage-Api-Key": "${LIGHTSAGE_API_KEY}"
    }
  }' \
  --env LIGHTSAGE_API_KEY="$LIGHTSAGE_API_KEY"

Inline definitions support http, sse, and stdio. Lightsage validates the definition and adapts it to the selected agent harness before queuing the run.