# Nigeria Electricity Meter MCP by Wycord

> Nigeria Electricity Meter MCP by Wycord is an open-source MCP server for energy and smart home. Read-only check of Nigerian electricity meters and the DisCo list through VTpass. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Self-hosted
- **Website:** https://wycord.com
- **Repository:** https://github.com/wycord/nigeria-mcp
- **MCP Registry name:** io.github.wycord/nigeria-electricity
- **Categories:** [energy and smart home](https://ai-powered.com/categories/energy-and-smart-home)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `validate_meter`: Validates a meter and returns customer name, address and DisCo.
- `list_discos`: Lists the DisCos.

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

## Alternatives

- [enfy.nl energievergelijker (Nederland)](https://ai-powered.com/mcp/enfy-nl-energievergelijker-nederland): enfy.nl energievergelijker (Nederland) is a free MCP server for energy and smart home.
- [Utilify](https://ai-powered.com/mcp/utilify): Utilify is a free MCP server for home services.
- [TexasHomeBills — Texas electricity plans](https://ai-powered.com/mcp/texashomebills-texas-electricity-plans): TexasHomeBills — Texas electricity plans is a freemium MCP server for energy and smart home.

---
Source: https://ai-powered.com/mcp/nigeria-electricity-meter-mcp-by-wycord
