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