Nigeria Electricity Meter MCP by Wycord
Read-only check of Nigerian electricity meters and the DisCo list through VTpass
- Pricing
- Open source
- Platforms
- CLI, Self-hosted
- Runs
- Locally
- Version
- 0.4.0
- Listing updated
- 4 days ago
Similar MCP servers
About Nigeria Electricity Meter MCP by Wycord
Nigeria Electricity Meter MCP by Wycord is an open-source MCP server for energy and smart home. It runs locally on your machine and is started by your AI client.
The server validates a prepaid or postpaid meter number and returns the customer name and address along with the distribution company (DisCo), and it can list the DisCos. It is strictly read-only: the README states there are no payments.
Live results come from VTpass and need three credentials (VTPASS_API_KEY, VTPASS_PUBLIC_KEY and VTPASS_SECRET_KEY). VTPASS_BASE_URL defaults to the VTpass sandbox, which returns test data, so it must be set to https://vtpass.com/api for production. With no keys, built-in sample data is returned and labelled MOCK DATA.
It belongs to the Wycord nigeria-mcp set (MIT licence, built by Braynex Services Ltd), runs over stdio and installs as @wycord/nigeria-mcp-electricity.
Install
Run in a terminal
claude mcp add nigeria-electricity --env VTPASS_API_KEY='<VTPASS_API_KEY>' --env VTPASS_SECRET_KEY='<VTPASS_SECRET_KEY>' -- npx -y @wycord/nigeria-mcp-electricityAdd to claude_desktop_config.json
{
"mcpServers": {
"nigeria-electricity": {
"command": "npx",
"args": [
"-y",
"@wycord/nigeria-mcp-electricity"
],
"env": {
"VTPASS_API_KEY": "<VTPASS_API_KEY>",
"VTPASS_SECRET_KEY": "<VTPASS_SECRET_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"nigeria-electricity": {
"command": "npx",
"args": [
"-y",
"@wycord/nigeria-mcp-electricity"
],
"env": {
"VTPASS_API_KEY": "<VTPASS_API_KEY>",
"VTPASS_SECRET_KEY": "<VTPASS_SECRET_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"nigeria-electricity": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@wycord/nigeria-mcp-electricity"
],
"env": {
"VTPASS_API_KEY": "<VTPASS_API_KEY>",
"VTPASS_SECRET_KEY": "<VTPASS_SECRET_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"nigeria-electricity": {
"command": "npx",
"args": [
"-y",
"@wycord/nigeria-mcp-electricity"
],
"env": {
"VTPASS_API_KEY": "<VTPASS_API_KEY>",
"VTPASS_SECRET_KEY": "<VTPASS_SECRET_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"nigeria-electricity": {
"command": "npx",
"args": [
"-y",
"@wycord/nigeria-mcp-electricity"
],
"env": {
"VTPASS_API_KEY": "<VTPASS_API_KEY>",
"VTPASS_SECRET_KEY": "<VTPASS_SECRET_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ELECTRICITY_PROVIDERData source. Leave unset: live VTpass is used when all three VTPASS_* keys are set, otherwise built-in sample data labelled MOCK DATA. Set "mock" to force labelled sample data.VTPASS_API_KEYVTpass API key — with all three VTPASS_* keys set, live VTpass is used by default.VTPASS_PUBLIC_KEYVTpass public key (PK_...) — with all three VTPASS_* keys set, live VTpass is used by default.VTPASS_SECRET_KEYVTpass secret key (SK_...) — with all three VTPASS_* keys set, live VTpass is used by default.VTPASS_BASE_URLSet to https://vtpass.com/api for production. Default is the VTpass sandbox, which returns test data.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- validate_meter
- Validates a meter and returns customer name, address and DisCo.
- list_discos
- Lists the DisCos.
What it does
- Meter validation
- Returns customer name, address and DisCo for a meter number.
- DisCo list
- Lists the electricity distribution companies.
- Read-only by design
- No payment or top-up capability.
- Sandbox default
- Uses the VTpass sandbox until the production base URL is set.
- Labelled sample data
- Falls back to MOCK DATA-labelled results without keys.
Good for
- Verify a meter number before a customer pays a bill elsewhere
- Show DisCo choices in a utility-payment form
- Let a support agent confirm meter ownership details
- Prototype a Nigerian utilities app with sample data
Pricing
Open source
MIT licence; live lookups need VTpass keys
Prices change. Check wycord.com before you buy.
Nigeria Electricity Meter MCP by Wycord FAQ
Can it buy electricity?
No. It only validates meters and lists DisCos.
What credentials does live mode need?
VTPASS_API_KEY, VTPASS_PUBLIC_KEY and VTPASS_SECRET_KEY, all three.
Will I get real data by default?
No. The VTpass sandbox is the default and returns test data until VTPASS_BASE_URL points to production.
How do I force sample mode?
Set ELECTRICITY_PROVIDER to mock.
Is Nigeria Electricity Meter MCP by Wycord free?
Yes. Nigeria Electricity Meter MCP by Wycord is open source, so you can use and self-host it for free.
How do I add Nigeria Electricity Meter MCP by Wycord to Claude Code?
Run this command in your terminal: claude mcp add nigeria-electricity --env VTPASS_API_KEY='<VTPASS_API_KEY>' --env VTPASS_SECRET_KEY='<VTPASS_SECRET_KEY>' -- npx -y @wycord/nigeria-mcp-electricity
What are the best alternatives to Nigeria Electricity Meter MCP by Wycord?
The closest alternatives to Nigeria Electricity Meter MCP by Wycord are enfy.nl energievergelijker (Nederland), Utilify and TexasHomeBills — Texas electricity plans.
Where this comes from
- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.
