Private, local Bale bot for agents: read, search and answer messages, ask and wait, files.

GitHub stars
270

Install

/plugin install bale@iran-mcp

Run it inside Claude Code after adding the marketplace with /plugin marketplace add sepehr071/iran-mcp.

Contents

Discovered from source

Skills 1

Bale Bot

Private, local Bale bot for agents: read, search and answer messages, ask and wait, files.

The tools below come from the bale-mcp MCP server. If they are not available, install it with claude mcp add bale -- uvx bale-mcp, or add "bale": {"command": "uvx", "args": ["bale-mcp"], "env": {"BALE_BOT_TOKEN": "${BALE_BOT_TOKEN:-}"}} to the client's MCP servers config. It needs uv. Restart the session after installing.

Tools

  • bot_get_me: Check BALE_BOT_TOKEN and show the bot's id, username and name.
  • bot_get_chat: Get a chat's type, title or name, username and description.
  • bot_get_webhook_info: Show whether a webhook is set (url empty = the reading tools work), pending updates and the last error.
  • bot_send_message: Send a real text message from the bot.
  • bot_send_file: Send a real photo, document, video, audio or voice file from the bot.
  • bot_edit_message: Replace the text of a message the bot sent earlier.
  • bot_delete_message: Delete a message the bot may delete (its own, or as admin).
  • bot_get_new_messages: Get messages people sent the bot since the last check, from all chats, oldest first, and mark them read.
  • bot_list_chats: List the chats this bot has talked in, newest first, with unread count and last message.
  • bot_read_chat: Show a chat's recent messages in both directions, oldest first, and mark the chat read (local store; Bale keeps no history).
  • bot_search_messages: Search stored messages by text, newest first.
  • bot_wait_for_reply: Wait until someone writes in a chat or presses a button, then return the new messages (marked read).
  • bot_download_file: Download a file someone sent the bot (max 20 MB) and return its local path.

Rules

  • This server acts on the user's own account (BALE_BOT_TOKEN). Confirm with the user before any call that creates, sends, edits or deletes something.
  • On timeouts or HTTP 403 outside Iran, set BALE_MCP_PROXY to an HTTP proxy with an Iranian IP.

Maintainer

Sepehr Radmard: open-source MCP servers for the Iranian web

Built and maintained by Sepehr Radmard (سپهر رادمرد): LinkedIn · GitHub. More servers for Iranian websites: iran-mcp.

MCP servers 1

Sponsors

Details

Marketplace
sepehr071/iran-mcp
Source
plugins/bale
Category
Messaging

More from sepehr071/iran-mcp

All 96