Math & Numbers
Convert illuminance between lux (lx = lm/m², SI base), kilolux (1 = 1000 lx), footcandle (1 = 10.7639104 lx), phot (1 = 10000 lx), and nox (1 = 0.001 lx). Converts via lux to the target unit and lists the equivalent value in all five units for reference. Reference values: full moon ≈ 0.25, office lighting ≈ 300–500, overcast day ≈ 1000, direct sunlight ≈ 100000 lux.
Call this tool from your code in three languages.
curl -X POST 'https://api.elysiatools.com/en/api/tools/illuminance-converter' \
-H 'Content-Type: application/json' \
-d '{"inputUnit":"lux","value":500,"outputUnit":"footcandle","decimalPlaces":6}'Send a POST request with your inputs as JSON. File parameters require a separate upload first.
POST https://api.elysiatools.com/en/api/tools/illuminance-converter| Name | Type | Required | Description |
|---|---|---|---|
| inputUnit | select | No | — |
| value | number | Yes | Illuminance in the selected Input unit. Must be non-negative. |
| outputUnit | select | No | — |
| decimalPlaces | number | No | — |
JSON result
{
"key": {...},
"metadata": {
"key": "value"
},
"error": "Error message (optional)",
"message": "Notification message (optional)"
}Add this tool to your Model Context Protocol server so AI agents can list and call it.
Add this block to your MCP client configuration:
{
"mcpServers": {
"elysiatools-illuminance-converter": {
"name": "illuminance-converter",
"description": "Convert illuminance between lux (lx = lm/m², SI base), kilolux (1 = 1000 lx), footcandle (1 = 10.7639104 lx), phot (1 = 10000 lx), and nox (1 = 0.001 lx). Converts via lux to the target unit and lists the equivalent value in all five units for reference. Reference values: full moon ≈ 0.25, office lighting ≈ 300–500, overcast day ≈ 1000, direct sunlight ≈ 100000 lux.",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=illuminance-converter",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}After connecting to the SSE endpoint, list the exposed tools:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Invoke the tool by its id, passing arguments built from its parameters:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "illuminance-converter",
"arguments": {
"inputUnit": "lux",
"value": 500,
"outputUnit": "footcandle",
"decimalPlaces": 6
}
}
}Questions or issues? Contact [email protected]