# Nigeria Bank Resolve MCP by Wycord

> Nigeria Bank Resolve MCP by Wycord is an open-source MCP server for finance and payments. Resolve a Nigerian NUBAN and bank code to the account name, via Paystack. 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-bank-resolve
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-15

## About

This server answers one question for an agent: whose account is this? Given a 10-digit NUBAN and a bank code, it returns the registered account name, and a second tool lists banks with their codes so the agent can pick the right one.

Live lookups go through Paystack and need a free Paystack secret key in PAYSTACK_SECRET_KEY. Without a key it serves built-in sample data, and every such result is labelled MOCK DATA so it can't pass for a real name. A BANK_PROVIDER setting can force the labelled sample mode.

It is one of twelve servers in the Wycord nigeria-mcp repository (MIT licence, built by Braynex Services Ltd), runs over stdio, and installs from npm as @wycord/nigeria-mcp-bank-account.

## Features

- **Account name resolution:** Turns a NUBAN plus bank code into the registered account holder name.
- **Bank list:** Lists banks together with their codes.
- **Labelled sample mode:** Returns MOCK DATA-labelled results when no key is set.
- **Provider switch:** BANK_PROVIDER chooses paystack or mock.

## Good for

- Confirm a payee's name before an agent prepares a transfer
- Check a user-entered account number in an onboarding flow
- Look up bank codes for a payout form
- Test a payment workflow safely with sample data

## Install

### Claude Code (Terminal)

```sh
claude mcp add nigeria-bank-resolve --env PAYSTACK_SECRET_KEY='<PAYSTACK_SECRET_KEY>' -- npx -y @wycord/nigeria-mcp-bank-account
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nigeria-bank-resolve": {
      "command": "npx",
      "args": [
        "-y",
        "@wycord/nigeria-mcp-bank-account"
      ],
      "env": {
        "PAYSTACK_SECRET_KEY": "<PAYSTACK_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nigeria-bank-resolve": {
      "command": "npx",
      "args": [
        "-y",
        "@wycord/nigeria-mcp-bank-account"
      ],
      "env": {
        "PAYSTACK_SECRET_KEY": "<PAYSTACK_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "nigeria-bank-resolve": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wycord/nigeria-mcp-bank-account"
      ],
      "env": {
        "PAYSTACK_SECRET_KEY": "<PAYSTACK_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nigeria-bank-resolve": {
      "command": "npx",
      "args": [
        "-y",
        "@wycord/nigeria-mcp-bank-account"
      ],
      "env": {
        "PAYSTACK_SECRET_KEY": "<PAYSTACK_SECRET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "nigeria-bank-resolve": {
      "command": "npx",
      "args": [
        "-y",
        "@wycord/nigeria-mcp-bank-account"
      ],
      "env": {
        "PAYSTACK_SECRET_KEY": "<PAYSTACK_SECRET_KEY>"
      }
    }
  }
}
```

## Tools

- `resolve_bank_account`: Resolves a 10-digit NUBAN and bank code to the registered account name.
- `list_banks`: Lists banks with their codes.

## FAQ

### Do I need a Paystack account?

For live data, yes: set PAYSTACK_SECRET_KEY. The README calls the key free.

### What happens without a key?

Built-in sample data is returned and each result is labelled MOCK DATA.

### How do I force sample data?

Set BANK_PROVIDER to mock.

### Which transport does it use?

stdio, installed from npm.

### Is Nigeria Bank Resolve MCP by Wycord free?

Yes. Nigeria Bank Resolve MCP by Wycord is open source, so you can use and self-host it for free.

### How do I add Nigeria Bank Resolve MCP by Wycord to Claude Code?

Run this command in your terminal: claude mcp add nigeria-bank-resolve --env PAYSTACK_SECRET_KEY='<PAYSTACK_SECRET_KEY>' -- npx -y @wycord/nigeria-mcp-bank-account

### What are the best alternatives to Nigeria Bank Resolve MCP by Wycord?

The closest alternatives to Nigeria Bank Resolve MCP by Wycord are Nigeria FX Rates MCP by Wycord, Nigeria NIGSAC Sanctions MCP by Wycord, Japan Bank Code, Nigerian Reference Data and Nigeria IMF WEO MCP by Wycord.

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

- [Nigeria FX Rates MCP by Wycord](https://ai-powered.com/mcp/nigeria-fx-rates-mcp-by-wycord): Nigeria FX Rates MCP by Wycord is an open-source MCP server for finance and payments.
- [Nigeria NIGSAC Sanctions MCP by Wycord](https://ai-powered.com/mcp/nigeria-nigsac-sanctions-mcp-by-wycord): Nigeria NIGSAC Sanctions MCP by Wycord is an open-source MCP server for legal and government.
- [Japan Bank Code](https://ai-powered.com/mcp/japan-bank-code): Japan Bank Code is an open-source MCP server for finance and payments.
- [Nigerian Reference Data](https://ai-powered.com/mcp/nigerian-reference-data): Nigerian Reference Data is a paid MCP server for finance and payments.
- [Nigeria IMF WEO MCP by Wycord](https://ai-powered.com/mcp/nigeria-imf-weo-mcp-by-wycord): Nigeria IMF WEO MCP by Wycord is an open-source MCP server for finance and payments.
- [Nigeria Quidax Crypto MCP by Wycord](https://ai-powered.com/mcp/nigeria-quidax-crypto-mcp-by-wycord): Nigeria Quidax Crypto MCP by Wycord is an open-source MCP server for finance and payments.
- [IBAN Analyzer](https://ai-powered.com/mcp/iban-analyzer): IBAN Analyzer is a freemium MCP server for finance and payments.
- [Mkopo MCP](https://ai-powered.com/mcp/mkopo-mcp): Mkopo MCP is an open-source MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/nigeria-bank-resolve-mcp-by-wycord
