EVS Meter Tools is an MCP server published by io.github.nicholasohjj, hosted at nusaircon-production.up.railway.app. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 4 tools, including get_meter_balance, get_meter_usage, get_recent_topups, get_topup_link.
Check NUS and SUTD hostel EVS electricity meters and get top-up links. Unofficial.
6 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get the current prepaid credit balance of a meter, in SGD.
| Parameter | Type | Description |
|---|---|---|
| system * | string | The institution the meter belongs to |
| meter_id * | string | The 8-digit EVS meter ID |
{
"name": "get_meter_balance",
"title": "Get meter balance",
"description": "Get the current prepaid credit balance of a meter, in SGD.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"meter_id",
"system"
],
"properties": {
"system": {
"enum": [
"nus",
"sutd"
],
"type": "string",
"description": "The institution the meter belongs to"
},
"meter_id": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "The 8-digit EVS meter ID"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"meterId",
"system",
"balanceSgd",
"checkedAt"
],
"properties": {
"system": {
"enum": [
"nus",
"sutd"
],
"type": "string",
"description": "The institution the meter belongs to"
},
"meterId": {
"type": "string"
},
"checkedAt": {
"type": "string",
"description": "When this was checked, as an ISO 8601 time"
},
"balanceSgd": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Get up to 7 days of usage for an NUS meter, with spending analysis, month-to-date spending, and how long the balance may last. Amounts are in SGD. Dates are as EVS reports them, with no time zone, and recent days may be missing. Not available for SUTD meters.
| Parameter | Type | Description |
|---|---|---|
| meter_id * | string | The 8-digit EVS meter ID |
{
"name": "get_meter_usage",
"title": "Get meter usage",
"description": "Get up to 7 days of usage for an NUS meter, with spending analysis, month-to-date spending, and how long the balance may last. Amounts are in SGD. Dates are as EVS reports them, with no time zone, and recent days may be missing. Not available for SUTD meters.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"meter_id"
],
"properties": {
"meter_id": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "The 8-digit EVS meter ID"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"meterId",
"system",
"balanceSgd",
"checkedAt",
"usage"
],
"properties": {
"usage": {
"type": "object",
"required": [
"requestedDays",
"daysWithData",
"history",
"analysis",
"estimatedDaysLeft",
"rank",
"monthToDateSgd"
],
"properties": {
"rank": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"history": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"amountSgd"
],
"properties": {
"date": {
"type": "string"
},
"amountSgd": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"analysis": {
"type": "object",
"required": [
"avgDailySgd",
"totalSgd",
"lastDaySgd",
"zeroStreak",
"spike",
"warnings"
],
"properties": {
"spike": {
"anyOf": [
{
"type": "object",
"required": [
"lastDaySgd",
"avgDailySgd",
"factor"
],
"properties": {
"factor": {
"type": "number"
},
"lastDaySgd": {
"type": [
"number",
"null"
]
},
"avgDailySgd": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"totalSgd": {
"type": [
"number",
"null"
]
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"lastDaySgd": {
"type": [
"number",
"null"
]
},
"zeroStreak": {
"type": "number"
},
"avgDailySgd": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"daysWithData": {
"type": "number",
"description": "How many days the averages are based on. Can be under requestedDays."
},
"requestedDays": {
"type": "number"
},
"monthToDateSgd": {
"type": [
"number",
"null"
]
},
"estimatedDaysLeft": {
"type": [
"number",
"null"
],
"description": "Balance divided by average daily spending. Null if unknown."
}
},
"additionalProperties": false
},
"system": {
"enum": [
"nus",
"sutd"
],
"type": "string",
"description": "The institution the meter belongs to"
},
"meterId": {
"type": "string"
},
"checkedAt": {
"type": "string",
"description": "When this was checked, as an ISO 8601 time"
},
"balanceSgd": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}Get up to 10 recent top-ups for a meter. To confirm a payment, look for a top-up with the same amount dated after the createdAt of its link, and with no status showing it failed. Earlier top-ups can have the same amount, so always check the date. Dates have no time zone and appear to be Singapore time (UTC+8), while createdAt is ISO 8601. If nothing matches, the payment may not be recorded yet or may have failed: check again later, and have the user check their card statement before paying again.
| Parameter | Type | Description |
|---|---|---|
| system * | string | The institution the meter belongs to |
| meter_id * | string | The 8-digit EVS meter ID |
{
"name": "get_recent_topups",
"title": "Get recent top-ups",
"description": "Get up to 10 recent top-ups for a meter. To confirm a payment, look for a top-up with the same amount dated after the createdAt of its link, and with no status showing it failed. Earlier top-ups can have the same amount, so always check the date. Dates have no time zone and appear to be Singapore time (UTC+8), while createdAt is ISO 8601. If nothing matches, the payment may not be recorded yet or may have failed: check again later, and have the user check their card statement before paying again.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"meter_id",
"system"
],
"properties": {
"system": {
"enum": [
"nus",
"sutd"
],
"type": "string",
"description": "The institution the meter belongs to"
},
"meter_id": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "The 8-digit EVS meter ID"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"meterId",
"system",
"balanceSgd",
"checkedAt",
"topups"
],
"properties": {
"system": {
"enum": [
"nus",
"sutd"
],
"type": "string",
"description": "The institution the meter belongs to"
},
"topups": {
"type": "object",
"required": [
"lookbackDays",
"source",
"history"
],
"properties": {
"source": {
"type": "string"
},
"history": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"amountSgd",
"reference"
],
"properties": {
"date": {
"type": "string"
},
"status": {
"type": "string",
"description": "EVS's status for this top-up, when it gives one"
},
"amountSgd": {
"type": [
"number",
"null"
]
},
"reference": {
"type": "string"
}
},
"additionalProperties": false
}
},
"lookbackDays": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"meterId": {
"type": "string"
},
"checkedAt": {
"type": "string",
"description": "When this was checked, as an ISO 8601 time"
},
"balanceSgd": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}Create a link to the secure top-up page, for the user to open and pay by card themselves. Creating the link charges nothing. Refuses a meter EVS doesn't recognise. If EVS can't be reached, meterVerified is false, so ask the user to check the meter on the page. NUS allows $6-$50 and SUTD allows $10-$50.
| Parameter | Type | Description |
|---|---|---|
| system * | string | The institution the meter belongs to |
| meter_id * | string | The 8-digit EVS meter ID |
| amount_sgd * | number | Top-up amount in SGD |
{
"name": "get_topup_link",
"title": "Get top-up link",
"description": "Create a link to the secure top-up page, for the user to open and pay by card themselves. Creating the link charges nothing. Refuses a meter EVS doesn't recognise. If EVS can't be reached, meterVerified is false, so ask the user to check the meter on the page. NUS allows $6-$50 and SUTD allows $10-$50.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"meter_id",
"system",
"amount_sgd"
],
"properties": {
"system": {
"enum": [
"nus",
"sutd"
],
"type": "string",
"description": "The institution the meter belongs to"
},
"meter_id": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "The 8-digit EVS meter ID"
},
"amount_sgd": {
"type": "number",
"description": "Top-up amount in SGD"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url",
"meterId",
"system",
"amountSgd",
"meterVerified",
"createdAt",
"note"
],
"properties": {
"url": {
"type": "string"
},
"note": {
"type": "string"
},
"system": {
"enum": [
"nus",
"sutd"
],
"type": "string",
"description": "The institution the meter belongs to"
},
"meterId": {
"type": "string"
},
"amountSgd": {
"type": "number"
},
"createdAt": {
"type": "string",
"description": "When the link was made, as an ISO 8601 time. Used to confirm a payment."
},
"meterVerified": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true
}
}Read-only tools for EVS prepaid electricity meters at NUS and SUTD hostels. Ask for the user's 8-digit meter ID and whether it is an NUS or SUTD meter if you do not know them. Usage history is available for NUS meters only. You cannot make payments. To top up, use get_topup_link and give the user the link. Never ask for card details in the conversation. Errors are JSON with a code, a message, and whether retrying can help. If retryable is false, ask the user instead of calling again. To confirm a payment, follow the steps in get_recent_topups. Never tell the user to pay again just because a top-up has not appeared yet.
Names, descriptions and schemas were written by the server and are shown as data.