MCPLow riskUnclaimed

Bale Bot

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

sepehr071sepehr071/bale-mcpUpdated Oct 3, 2026

server.json

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.sepehr071/bale-mcp",
  "description": "Private, local Bale bot for agents: read, search and answer messages, ask and wait, files.",
  "title": "Bale Bot",
  "repository": {
    "url": "https://github.com/sepehr071/bale-mcp",
    "source": "github"
  },
  "version": "0.1.0",
  "websiteUrl": "https://github.com/sepehr071/bale-mcp",
  "packages": [
    {
      "registryType": "pypi",
      "registryBaseUrl": "https://pypi.org",
      "identifier": "bale-mcp",
      "version": "0.1.0",
      "runtimeHint": "uvx",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Bot token from @botfather in Bale (https://ble.ir/botfather).",
          "isRequired": true,
          "isSecret": true,
          "name": "BALE_BOT_TOKEN"
        },
        {
          "description": "Comma-separated chat ids or @usernames the bot may read and message; all other chats are ignored. Recommended.",
          "name": "BALE_ALLOWED_CHATS"
        },
        {
          "description": "Local message history file (default ~/.bale-mcp/messages.db); ':memory:' keeps nothing on disk.",
          "name": "BALE_MCP_DB"
        },
        {
          "description": "Optional HTTP proxy URL for every request; system proxy settings are ignored.",
          "name": "BALE_MCP_PROXY"
        }
      ]
    }
  ]
}

Permissions

DeclaredDetected
Runs code—python
Installs—pypi:bale-mcp@0.1.0
Runs install scripts—None
NetworkNoneNone
Needs credentialsBALE_BOT_TOKENBALE_BOT_TOKEN
Outside the workspace—None
Agent tools—None

Checks

Low risk · Nothing worth a warning was found.

Not reviewed by a person · Checked by rules; the model review is not switched on yet.

Versions

  1. #10.1.0latestOct 7, 2026