Skip to content
MCP server

Nigeria Bank Resolve MCP by Wycord

Resolve a Nigerian NUBAN and bank code to the account name, via Paystack

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 Bank Resolve MCP by Wycord

Nigeria Bank Resolve MCP by Wycord is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • BANK_PROVIDERData source. Leave unset: live Paystack is used when PAYSTACK_SECRET_KEY is set, otherwise built-in sample data labelled MOCK DATA. Set "mock" to force labelled sample data.
  • PAYSTACK_SECRET_KEYPaystack secret key (free at paystack.com). When set, live account resolution is used by default.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

MIT licence; live lookups need a free Paystack key

Prices change. Check wycord.com before you buy.

Nigeria Bank Resolve MCP by Wycord 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.

How AIPoweredBot checks servers