Telegram Agent by Nova (CIVAI)

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

I use your linked Telegram MTProto session (Integrations → Telegram) to list groups, members, and s…

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Telegram Agent by Nova (CIVAI)": {
      "url": "https://nova.civai.co/mcp/agents/telegram-agent",
      "transport": "streamable-http"
    }
  }
}

Measured tools (17)

• list_connectors

  List WhatsApp, Instagram, Email, X connector status for a support agent.

  Parameters:

  • agent_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• suggest_targets

  AI-propose Instagram or X @targets for a discovery scan (depth/breadth optional).

  Parameters:

  • agent_id (required) — string
  • channel (required) — string
  • min_followers — integer
  • discovery_depth — integer
  • discovery_breadth — integer
  • disable_hard_filter — boolean

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• run_scan

  Start a leads discovery scan (whatsapp, instagram, x, telegram, or jiji). Discovery params for x/instagram accept max_post_age_days (1-365; omit = no age limit) and post_age_relax_steps (0-4, default 3) to cap how old a source post may be before its engagers are collected; the window widens within a run only.

  Parameters:

  • agent_id (required) — string
  • channel (required) — string
  • params — object

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• continue_scan

  Continue a scan paused for selection (WhatsApp/Telegram groups or IG/X targets).

  Parameters:

  • agent_id (required) — string
  • scan_id (required) — string
  • selected_resources (required) — array
  • max_contacts_per_group — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_scans

  List past and active leads discovery scans for an agent.

  Parameters:

  • agent_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_scan

  Get one scan with paginated leads (status, progress, leads).

  Parameters:

  • agent_id (required) — string
  • scan_id (required) — string
  • limit — integer
  • offset — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_scan_results

  Alias of get_scan — read leads from an active or completed scan.

  Parameters:

  • agent_id (required) — string
  • scan_id (required) — string
  • limit — integer
  • offset — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• delete_scans

  Delete one or more completed scan runs (does not delete schedules).

  Parameters:

  • agent_id (required) — string
  • scan_ids (required) — array

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• abort_scans

  Stop stuck running scans (marks interrupted, releases schedule lock).

  Parameters:

  • agent_id (required) — string
  • scan_ids (required) — array
  • reason — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• import_leads

  Import discovered leads into the agent CRM (outreach: none|immediate|bulk_followup).

  Parameters:

  • agent_id (required) — string
  • scan_id (required) — string
  • lead_ids (required) — array
  • label — string
  • outreach — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• clear_discovery_cache

  Clear Leads Discovery scan cache for an agent (seen handles / WA progress).

  Parameters:

  • agent_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_scan_schedule

  Create an auto-scan schedule (Import Only or Message now outreach). Discovery params for x/instagram accept max_post_age_days (1-365; omit = no age limit) and post_age_relax_steps (0-4, default 3) to cap how old a source post may be before its engagers are collected; the window widens within a run only.

  Parameters:

  • agent_id (required) — string
  • channel (required) — string
  • label — string
  • params — object
  • enabled — boolean
  • max_runs — integer
  • frequency — string
  • auto_import — boolean
  • run_hour_utc — integer
  • auto_outreach — string
  • source_scan_at — string
  • source_scan_id — string
  • max_leads_per_run — integer
  • relax_target_filter_after_runs — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_scan_schedules

  List auto-scan schedules for an agent.

  Parameters:

  • agent_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• update_scan_schedule

  Update or pause/resume an auto-scan schedule. Discovery params for x/instagram accept max_post_age_days (1-365; omit = no age limit) and post_age_relax_steps (0-4, default 3) to cap how old a source post may be before its engagers are collected; the window widens within a run only.

  Parameters:

  • agent_id (required) — string
  • schedule_id (required) — string
  • label — string
  • params — object
  • channel — string
  • enabled — boolean
  • max_runs — integer
  • frequency — string
  • auto_import — boolean
  • run_hour_utc — integer
  • auto_outreach — string
  • max_leads_per_run — integer
  • relax_target_filter_after_runs — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• delete_scan_schedule

  Delete an auto-scan schedule.

  Parameters:

  • agent_id (required) — string
  • schedule_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• trigger_scan_schedule

  Run an auto-scan schedule immediately (Run now).

  Parameters:

  • agent_id (required) — string
  • schedule_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_discovery_analytics

  Get sourced-leads analytics for an agent (window e.g. 7d, 30d).

  Parameters:

  • agent_id (required) — string
  • window — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.