Skip to main content

An MCP server for MBBank

Project description

MBBank MCP Server

MCP server for MBBank API helping monitoring and analytics transactions and balances.

Requirements

  • uv
  • Python 3.10 or higher

Usage

Install in Claude Desktop

Follow the MCP install guide, use the following configuration:

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

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.

Dose this MCP is 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.

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_thedtvn_mbbank_mcp-0.0.6.tar.gz (6.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_thedtvn_mbbank_mcp-0.0.6-py3-none-any.whl (7.6 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_thedtvn_mbbank_mcp-0.0.6.tar.gz.

File metadata

  • Download URL: iflow_mcp_thedtvn_mbbank_mcp-0.0.6.tar.gz
  • Upload date:
  • Size: 6.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_thedtvn_mbbank_mcp-0.0.6.tar.gz
Algorithm Hash digest
SHA256 a15c9a133a8712d116db251bc32cbad2892fe07650fd0f95c206b3c80b3f116a
MD5 6dcb0afe7820dcebece63337b8c8d590
BLAKE2b-256 1546cbc5abc184152a8ecc04ce469017e542b3b8bfd2f637bdf79b63793df7c2

See more details on using hashes here.

File details

Details for the file iflow_mcp_thedtvn_mbbank_mcp-0.0.6-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_thedtvn_mbbank_mcp-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 7.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.27 {"installer":{"name":"uv","version":"0.9.27","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_thedtvn_mbbank_mcp-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 54a1dd1c508d9c21d102d75aa24628a2683956d3afa0cf23e5845cf409f6c006
MD5 dc2b53cdcac170f15aa9fc0bd0043dc4
BLAKE2b-256 aac9b9fa7fc706fa6a67268675d2c0f06bd8425f8f345306f58a2f3a1abdcef7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page