tbc-bank-mcp

MCP server for TBC Bank payment gateway (Georgia). Supports payments, refunds, recurring, QR payments, and exchange rates via the TBC Open Banking API.

Tools (8)

Tool	Description
`create_payment`	Create a new payment
`get_payment`	Get payment details by ID
`confirm_payment`	Confirm/complete a pending payment
`cancel_payment`	Cancel a payment
`refund_payment`	Refund a completed payment
`create_recurring_payment`	Charge a recurring payment
`create_qr_payment`	Create a QR code payment
`get_exchange_rates`	Get commercial exchange rates

Quick Start

{
  "mcpServers": {
    "tbc-bank": {
      "command": "npx",
      "args": ["-y", "@theyahia/tbc-bank-mcp"],
      "env": {
        "TBC_API_KEY": "<YOUR_API_KEY>",
        "TBC_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`TBC_API_KEY`	Yes	API key from TBC developers portal
`TBC_CLIENT_SECRET`	Yes	Client secret from TBC developers portal

Demo Prompts

"Create a payment for 50 GEL for a coffee subscription"
"Check the status of payment pay-abc123"
"Refund 20 GEL from payment pay-xyz789"
"Generate a QR code payment for 15 GEL"
"What are today's TBC exchange rates?"

License

MIT

@theyahia/tbc-bank-mcp

Quick Install