Bale Bot

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

What does this entry provide?

Bale Bot is an MCP server entry in ChatHome Skills, sourced from Official MCP Registry and scored 78/100. As a Model Context Protocol server, it exposes tools that MCP-compatible LLM clients such as Claude, Cursor, and Copilot can call directly, extending an agent's reach beyond its built-in capabilities. ChatHome Skills discovered this entry through its daily ingest of official registries and GitHub discovery queries, and re-verifies repository facts, freshness signals, and install metadata on every run. The quality score weighs official-registry presence, a working install command, license clarity, GitHub star trajectory, and repository freshness — the full formula is on the Sources page. The install command above is ready to copy. Review the last-pushed date and repository status before adding Bale Bot to a production agent workflow; the snapshot facts below are point-in-time values from the most recent ingest.

Snapshot facts

Source: Official MCP Registry
Quality: 78/100
Install method: pypi
Repo: sepehr071/bale-mcp
Repo updated: Oct 23, 2026

Install command

uvx bale-mcp==0.2.2

Install method: pypi

Review the upstream source before running this command.

GitHub project

Quality

Repo stars

Repo updated

Oct 23, 2026

How is this score calculated?

Weighted across six dimensions, scored 0-100.
Provenance (25): listed in an official or curated registry.
Installability (25): a runnable install command beats a declared transport, which beats a source checkout.
Maintenance (20): recency of the last push; archived entries score zero here.
Adoption (20): repository stars on a log curve.
Documentation (10) and description quality (10): parsed manifest or SKILL.md frontmatter, and a real description rather than a placeholder.

MCP manifest

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-10-23T11:07:14.312521Z",
      "publishedAt": "2026-10-23T11:07:14.312521Z",
      "statusChangedAt": "2026-10-23T11:07:14.312521Z"
    }
  },
  "server": {
    "name": "io.github.sepehr071/bale-mcp",
    "title": "Bale Bot",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "0.2.2",
    "packages": [
      {
        "version": "0.2.2",
        "transport": {
          "type": "stdio"
        },
        "identifier": "bale-mcp",
        "runtimeHint": "uvx",
        "registryType": "pypi",
        "registryBaseUrl": "https://pypi.org",
        "environmentVariables": [
          {
            "name": "BALE_BOT_TOKEN",
            "isSecret": true,
            "isRequired": true,
            "description": "Bot token from @botfather in Bale (https://ble.ir/botfather)."
          },
          {
            "name": "BALE_ALLOWED_CHATS",
            "description": "Comma-separated chat ids or @usernames the bot may read and message; all other chats are ignored. Recommended."
          },
          {
            "name": "BALE_MCP_DB",
            "description": "Local message history file (default ~/.bale-mcp/messages.db); ':memory:' keeps nothing on disk."
          },
          {
            "name": "BALE_MCP_SEND_DIRS",
            "description": "Folders bot_send_file may upload local files from (os.pathsep-separated); default is the download folder and the working directory."
          },
          {
            "name": "BALE_MCP_PROXY",
            "description": "Optional HTTP proxy URL for every request; system proxy settings are ignored."
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/sepehr071/bale-mcp",
      "source": "github"
    },
    "websiteUrl": "https://github.com/sepehr071/bale-mcp",
    "description": "Private, local Bale bot for agents: read, search and answer messages, ask and wait, files."
  }
}

Report an issue with this listing