Mbbank MCP

🚀 MBBank MCP Server

The MCP server for MBBank API, facilitating the monitoring and analytics of transactions and balances.

🚀 Quick Start

✨ Features

The MCP server for MBBank API offers functionalities for monitoring and analyzing transactions and balances.

📦 Installation

Requirements

• uv
• Python 3.10 or higher

💻 Usage Examples

Install in Claude Desktop

Follow the MCP install guide, and use the following configuration:

⚠️ Important Note

Replace <your_username> and <your_password> with your actual MB Bank credentials. You should not set env variables for username and password, as it errors python runtime.

{
    "mcpServers": {
        "mbbank": {
            "command": "uvx",
            "args": [
                "mbbank-mcp",
                "--username=<your_username>",
                "--password=<your_password>"
            ]
        }
    }
}

With docker, you can use the following configuration:

{
    "mcpServers": {
        "mbbank": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "MBBANK_USERNAME",
                "-e",
                "MBBANK_PASSWORD",
                "thedtvn/mbbank-lib:latest"
            ],
            "env": {
                "MBBANK_USERNAME": "<your_username>",
                "MBBANK_PASSWORD": "<your_password>"
            }
        }
    }
}

Standalone MCP Server

To run the MCP server standalone, add the --sse flag to enable SSE mode (default is stdio mode).

The --username and --password flags are optional - you can also set them as environment variables MBBANK_USERNAME and MBBANK_PASSWORD.

You can specify --host and --port flags for the server address (default: localhost:3000).

uvx mbbank-mcp --username=<your_username> --password=<your_password> --host=localhost --port=3000 --sse 

📚 Documentation

Tools

get_balances

Get the balance from all accounts in MB Bank.

get_today_date

Returns the current date in YYYY-MM-DD format. Useful for transaction processing when model cannot access real time clock.

get_transactions

Get the transactions from account in MB Bank for a given date.

Parameters:

• account_number (string): The account number to get transactions for
• from_date (string): The start date for the transactions in the format dd-mm-yyyy
• to_date (string): The end date for the transactions in the format dd-mm-yyyy

get_cards

Get the cards information from MB Bank.

get_card_transactions

Get the transactions for a specific card in MB Bank.

Parameters:

• card_id (string): The card ID to get transactions from. Obtain this from the get_cards tool
• from_date (string): The start date for the transactions in the format dd-mm-yyyy
• to_date (string): The end date for the transactions in the format dd-mm-yyyy

get_savings

Get the savings accounts information from MB Bank.

get_saving_details

Get the details of a specific savings account in MB Bank.

Parameters:

• account_number (string): The ID of the savings account to get details for. Obtain this from the get_savings tool
• account_type (Literal["OSA", "SBA"]): The type of the account, either "OSA" for Online Savings Account or "SBA" for Saving Bank Account

get_interest_rates

Get the interest rates for savings accounts in MB Bank.

Parameters:

• currency (Literal["VND", "USD", "EUR"]): The currency for which to get the interest rates

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

FAQ

Is this MCP server free to use?

Yes, this MCP server is free to use.

Is this MCP safe to use?

Yes, this mcp core is mbbank-lib you can check it FAQ

Can this MCP Server transfer or withdraw money?

No, this MCP server does not support transferring or withdrawing money. It is designed for monitoring and analytics purposes only, such as checking balances and transactions.

⚠️ Important Note

However, you should be careful when using this MCP server, as it reads your sensitive data such as your account balances and transactions. Make sure to only use it with trusted applications and environments.