Back to search
telbot
MCP serverGitHub
Go-based tool for managing Telkomsel accounts via Telegram Bot, Terminal CLI, or MCP Server (for AI agents).
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/0xtbug--telbot)HTML
<a href="/listings/0xtbug--telbot"><img src="/api/listings/0xtbug--telbot/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
git clone https://github.com/0xtbug/telbot cd telbot cp .env.example .env # fill in your tokens go mod tidy
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 107 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Telbot
- Go-based tool for managing Telkomsel accounts via **Telegram Bot**, **Terminal CLI**, or **MCP Server** (for AI agents).
- ## Features
- - 🔑 SMS OTP login with session caching
- - 📊 Profile, balance, quota checking
- - 📦 Browse recommended packages
- - 🛍️ Purchase packages (Pulsa / QRIS)
- - ⏰ Auto-buy monitor (auto-purchase when quota is depleted or below a custom MB threshold)
- - 🔄 Auto re-login via OTP webhook (session renewal without manual intervention)
- - 🤖 MCP server for AI agent integration
- ## Quick Start
- ```bash
- git clone https://github.com/0xtbug/telbot
- cd telbot
- cp .env.example .env # fill in your tokens
- go mod tidy
- ```
- ## Modes
- | Flag | Description |
- |------|-------------|
- | `--bot` | Telegram bot (requires `.env` config) |
- | `--cli` | Interactive terminal UI (Bubbletea) |
- | `--mcp` | MCP server for AI agents (stdio) |
- ```bash
- go run . --bot # Telegram bot
- go run . --cli # Terminal UI
- go run . --mcp # MCP server
- ```
- ## Installation (Pre-built Binaries)
- If you don't want to install Go or build it yourself, you can download the pre-compiled executables for Windows, Linux, and macOS directly from the **[Releases](https://github.com/0xtbug/telbot/releases)** page of this repository.
- To install the binary globally so you can run `telbot` from any folder:
- **Linux / macOS:**
- 1. Download the appropriate binary from the Releases page.
- 2. Make the file executable:
- ```bash
- chmod +x telbot-linux-amd64 # Replace with your downloaded file name
- ```
- 3. Move it to your global bin directory:
- ```bash
- sudo mv telbot-linux-amd64 /usr/local/bin/telbot
- ```
- 4. You can now run `telbot` from anywhere in your terminal.
- **Windows:**
- 1. Download the Windows `.exe` executable from the Releases page.
- 2. Rename the downloaded file to `telbot.exe`.
- 3. Move it to a permanent folder, for example `C:\telbot\`.
- 4. Open the Windows Start menu, search for **Edit the system environment variables**, and open it.
- 5. Click **Environment Variables**, find **Path** in the System variables list, and click **Edit**.
- 6. Click **New**, add `C:\telbot\`, and click **OK** to save everything.
- 7. You can now run `telbot` from any new PowerShell or Command Prompt window.
- ## Environment Variables
- | Variable | Required | Description |
- |----------|----------|-------------|
- | `TELKOMSEL_BOT_TOKEN` | Bot mode | Telegram bot token from BotFather |
- | `TELEGRAM_ADMIN_ID` | Bot mode | Your Telegram user ID |
- | `OTP_WEBHOOK_PORT` | Optional | Port for OTP webhook listener (e.g. `8081`) |
- | `OTP_WEBHOOK_SECRET` | Optional | Shared secret for webhook authentication |
- You can either export these directly in your terminal, or place them in a `.env` file located in your platform's standard configuration directory:
- - **Windows:** `%APPDATA%\telbot\.env` (e.g., `C:\Users\<User>\AppData\Roaming\telbot\.env`)
- - **Linux/macOS:** `~/.config/telbot/.env`
- ## 🤖 AI Agent Integration (OpenClaw)
- This repository includes official support for [OpenClaw](https://github.com/0xtbug/telbot), an open-source AI agent framework. To teach your AI exactly how to use the Telkomsel MCP Server, simply provide it with the URL to the raw `SKILL.md` file in this repository:
- **Prompt your AI with:**
- ```text
- Please load and use this telbot Skill:
- https://raw.githubusercontent.com/0xtbug/telbot/main/telbot-skills/SKILL.md
- ```
- ## Documentation
- See the [docs/](docs/) folder for detailed guides:
- - [Telegram Bot](docs/telegram-bot.md)
- - [CLI Mode](docs/cli.md)
- - [MCP Server](docs/mcp-server.md)
- - [Auto Re-login (OTP Webhook)](docs/auto-relogin.md)
- - [Systemd Service (Linux)](docs/systemd.md)
- - [OpenWrt](docs/openwrt.md)
- - [OpenClaw Skill](telbot-skills/SKILL.md)
- ## Disclaimer
- This project is an unofficial tool that interacts with MyTelkomsel web services for personal automation purposes.
- It does not modify, bypass, or exploit any security mechanisms of the MyTelkomsel platform. All requests are performed using standard HTTP interactions similar to those made by the official web interface.
- This project is intended for educational and personal use only. Use at your own risk.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.