Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "telegram-bot-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyuanxv/[email protected]",
        "--port",
        "3000"
      ],
      "env": {
        "MCP_API_KEY": "${MCP_API_KEY}",
        "TELEGRAM_BOT_TOKEN": "${TELEGRAM_BOT_TOKEN}",
        "TELEGRAM_CHAT_ID": "${TELEGRAM_CHAT_ID}"
      }
    }
  }
}

claude mcp add telegram-bot-mcp-server -e "MCP_API_KEY=${MCP_API_KEY}" -e "TELEGRAM_BOT_TOKEN=${TELEGRAM_BOT_TOKEN}" -e "TELEGRAM_CHAT_ID=${TELEGRAM_CHAT_ID}" -- npx -y @cyuanxv/[email protected] --port 3000

[mcp_servers.telegram-bot-mcp-server]
command = "npx"
args = ["-y", "@cyuanxv/[email protected]", "--port", "3000"]
env = { "MCP_API_KEY" = "${MCP_API_KEY}", "TELEGRAM_BOT_TOKEN" = "${TELEGRAM_BOT_TOKEN}", "TELEGRAM_CHAT_ID" = "${TELEGRAM_CHAT_ID}" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "telegram-bot-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@cyuanxv/[email protected]",
        "--port",
        "3000"
      ],
      "enabled": true,
      "environment": {
        "MCP_API_KEY": "{env:MCP_API_KEY}",
        "TELEGRAM_BOT_TOKEN": "{env:TELEGRAM_BOT_TOKEN}",
        "TELEGRAM_CHAT_ID": "{env:TELEGRAM_CHAT_ID}"
      }
    }
  }
}

{
  "mcpServers": {
    "telegram-bot-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyuanxv/[email protected]",
        "--port",
        "3000"
      ],
      "env": {
        "MCP_API_KEY": "${MCP_API_KEY}",
        "TELEGRAM_BOT_TOKEN": "${TELEGRAM_BOT_TOKEN}",
        "TELEGRAM_CHAT_ID": "${TELEGRAM_CHAT_ID}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=telegram-bot-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeXVhbnh2L3RlbGVncmFtLWJvdC1tY3Atc2VydmVyQDEuMC4xIiwiLS1wb3J0IiwiMzAwMCJdLCJlbnYiOnsiTUNQX0FQSV9LRVkiOiIke01DUF9BUElfS0VZfSIsIlRFTEVHUkFNX0JPVF9UT0tFTiI6IiR7VEVMRUdSQU1fQk9UX1RPS0VOfSIsIlRFTEVHUkFNX0NIQVRfSUQiOiIke1RFTEVHUkFNX0NIQVRfSUR9In19"
}

{
  "servers": {
    "telegram-bot-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyuanxv/[email protected]",
        "--port",
        "3000"
      ],
      "env": {
        "MCP_API_KEY": "${MCP_API_KEY}",
        "TELEGRAM_BOT_TOKEN": "${TELEGRAM_BOT_TOKEN}",
        "TELEGRAM_CHAT_ID": "${TELEGRAM_CHAT_ID}"
      }
    }
  }
}

{
  "mcpServers": {
    "telegram-bot-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyuanxv/[email protected]",
        "--port",
        "3000"
      ],
      "env": {
        "MCP_API_KEY": "${MCP_API_KEY}",
        "TELEGRAM_BOT_TOKEN": "${TELEGRAM_BOT_TOKEN}",
        "TELEGRAM_CHAT_ID": "${TELEGRAM_CHAT_ID}"
      }
    }
  }
}

extensions:
  "telegram-bot-mcp-server":
    enabled: true
    name: "telegram-bot-mcp-server"
    type: stdio
    cmd: "npx"
    args:
      - "-y"
      - "@cyuanxv/[email protected]"
      - "--port"
      - "3000"
    envs:
      "MCP_API_KEY": "${MCP_API_KEY}"
      "TELEGRAM_BOT_TOKEN": "${TELEGRAM_BOT_TOKEN}"
      "TELEGRAM_CHAT_ID": "${TELEGRAM_CHAT_ID}"
    timeout: 300

Placeholders to fill from your own secret store: ${MCP_API_KEY}, ${TELEGRAM_BOT_TOKEN}, ${TELEGRAM_CHAT_ID}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25

n/a
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know @cyuanxv/[email protected]

Tool list unknown · checked 2026-11-07 17:28 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 91 / 100

provenance80

livenessn/a

freshness100

hygiene100

+repository +namespace-matches-repo ~liveness-unmeasured +updated-14d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

@cyuanxv/[email protected] npmthis version is not known to the dependency resolver

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

package	registry	version	runtime	secrets
`@cyuanxv/telegram-bot-mcp-server`	npm	1.0.1	npx	`MCP_API_KEY`, `TELEGRAM_BOT_TOKEN`, `TELEGRAM_CHAT_ID`

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

More from io.github.cyuanxv

Official server.json

{
  "name": "io.github.cyuanxv/telegram-bot-mcp-server",
  "title": "Telegram Bot MCP Server",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "1.0.1",
  "packages": [
    {
      "version": "1.0.1",
      "transport": {
        "url": "http://127.0.0.1:{port}/api/mcp",
        "type": "streamable-http",
        "headers": [
          {
            "name": "Authorization",
            "isSecret": true,
            "isRequired": true,
            "description": "Bearer followed by the same MCP_API_KEY configured for the local server."
          }
        ]
      },
      "identifier": "@cyuanxv/telegram-bot-mcp-server",
      "runtimeHint": "npx",
      "registryType": "npm",
      "packageArguments": [
        {
          "name": "--port",
          "type": "named",
          "format": "number",
          "default": "3000",
          "valueHint": "port",
          "isRequired": true
        }
      ],
      "environmentVariables": [
        {
          "name": "MCP_API_KEY",
          "isSecret": true,
          "isRequired": true,
          "description": "Choose a strong local MCP access key. Use the same key in the Authorization header."
        },
        {
          "name": "TELEGRAM_BOT_TOKEN",
          "isSecret": true,
          "description": "Your own Telegram Bot token. Required for real Bot operations."
        },
        {
          "name": "TELEGRAM_CHAT_ID",
          "isSecret": true,
          "description": "Your own default Telegram chat ID."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/cyuanxv/telegram-bot-mcp-server",
    "source": "github",
    "subfolder": "server"
  },
  "description": "Self-hosted Telegram Bot MCP server for rich text, media and interactive buttons."
}