telegram_search

Search Telegram posts using a free-text query with optional filters like specific channels or date ranges. Retrieve targeted results efficiently.

Instructions

Query-based search over Telegram posts.

When to use:

Use when a free-text query is provided (e.g., "search Telegram for X").
Optional filters: telegram_channel_usernames, start_date, end_date.
For "recent posts in Telegram" without a query, use get_recent_posts_from_telegram.
For "recent posts from @channel", use get_recent_posts_from_telegram with telegram_channel_usernames=["@channel"].

Input Schema

Name	Required	Description
`end_date`	No
`limit`	No	Approximate number of Telegram posts to return
`query`	Yes	Free-text query to match in Telegram posts
`start_date`	No
`telegram_channel_usernames`	No

Input Schema (JSON Schema)

{
  "properties": {
    "end_date": {
      "anyOf": [
        {
          "anyOf": [
            {
              "format": "date",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "ISO date (YYYY-MM-DD). Include posts up to and including this date"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "End Date"
    },
    "limit": {
      "default": 50,
      "description": "Approximate number of Telegram posts to return",
      "maximum": 100,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    },
    "query": {
      "description": "Free-text query to match in Telegram posts",
      "title": "Query",
      "type": "string"
    },
    "start_date": {
      "anyOf": [
        {
          "anyOf": [
            {
              "format": "date",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "description": "ISO date (YYYY-MM-DD). Include posts on/after this date"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Start Date"
    },
    "telegram_channel_usernames": {
      "anyOf": [
        {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "description": "List of Telegram channel usernames to filter by (with or without leading @)"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Telegram Channel Usernames"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

mcp-spacefrontiers

telegram_search

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from mcp-spacefrontiers

Related Tools

MCP directory API