Skip to main content
Glama
README.md
# nomba-mcp

MCP server for Nomba payment and POS platform (Nigeria).

## Tools (8)

| Tool | Description |
|---|---|
| `create_checkout` | Create a checkout page |
| `get_transaction` | Get transaction details |
| `list_transactions` | List transactions |
| `create_transfer` | Create a bank transfer |
| `get_balance` | Get account balance |
| `list_terminals` | List POS terminals |
| `create_virtual_account` | Create a virtual account |
| `get_virtual_account` | Get virtual account details |

## Quick Start

```json
{
  "mcpServers": {
    "nomba": {
      "command": "npx",
      "args": ["-y", "@theyahia/nomba-mcp"],
      "env": {
        "NOMBA_CLIENT_ID": "<YOUR_NOMBA_CLIENT_ID>",
        "NOMBA_CLIENT_SECRET": "<YOUR_NOMBA_CLIENT_SECRET>",
        "NOMBA_ACCOUNT_ID": "<YOUR_NOMBA_ACCOUNT_ID>"
      }
    }
  }
}
```

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `NOMBA_CLIENT_ID` | Yes | OAuth client ID |
| `NOMBA_CLIENT_SECRET` | Yes | OAuth client secret |
| `NOMBA_ACCOUNT_ID` | Yes | Nomba account ID |

## License

MIT

TDQS

B3/5.0

Scored across 8 tools

Disambiguation5/5

Each tool has a clearly distinct purpose targeting specific resources and actions: creating different financial entities (checkout, transfer, virtual account), retrieving balance or transaction details, and listing terminals or transactions. There is no overlap or ambiguity in functionality.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern with clear action prefixes (create_, get_, list_) and descriptive nouns. The naming is uniform and predictable throughout the set.

Tool Count5/5

With 8 tools, the server is well-scoped for a payment/financial domain, covering key operations like creation, retrieval, and listing without being overly broad or sparse. Each tool serves a clear, necessary function.

Completeness4/5

The toolset provides strong coverage for core financial workflows, including creation and retrieval of transactions, virtual accounts, and checkouts, plus balance and terminal listing. A minor gap exists in update/delete operations for resources like virtual accounts or transactions, but agents can work around this.

Maintenance

ActivityInactive
ResponsivenessSyncing