Skip to content
MCP server

Nigeria Electricity Meter MCP by Wycord

Read-only check of Nigerian electricity meters and the DisCo list through VTpass

Runs locally
Install
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-electricity

Add 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.

How AIPoweredBot checks servers