Servers Playground How we check Add a server Log in

Telegram Agent by Nova (CIVAI)

Working · 276 ms

co.civai.nova/telegram-agentv1.0.0 Domain verified

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

Sales & CRM

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://nova.civai.co/mcp/agents/telegram-agent

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

abort_scans

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

agent_idstring, required

scan_idsarray, required

reasonstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Telegram Agent by Nova (CIVAI) MCP server | mcptry

Tools (17)

abort_scans

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

Argument	Type	Description
reason	string
agent_id*	string
scan_ids*	array

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "scan_ids"
  ],
  "properties": {
    "reason": {
      "type": "string"
    },
    "agent_id": {
      "type": "string"
    },
    "scan_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

clear_discovery_cache

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

Argument	Type	Description
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string"
    }
  }
}

continue_scan

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

Argument	Type	Description
scan_id*	string
agent_id*	string
selected_resources*	array
max_contacts_per_group	integer

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "scan_id",
    "selected_resources"
  ],
  "properties": {
    "scan_id": {
      "type": "string"
    },
    "agent_id": {
      "type": "string"
    },
    "selected_resources": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "max_contacts_per_group": {
      "type": "integer"
    }
  }
}

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.

Argument	Type	Description
label	string
params	object
channel*	string
enabled	boolean
agent_id*	string
max_runs	integer
frequency	string
auto_import	boolean
run_hour_utc	integer
auto_outreach	string
source_scan_at

delete_scan_schedule

Delete an auto-scan schedule.

Argument	Type	Description
agent_id*	string
schedule_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "schedule_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string"
    },
    "schedule_id": {
      "type": "string"
    }
  }
}

delete_scans

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

Argument	Type	Description
agent_id*	string
scan_ids*	array

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "scan_ids"
  ],
  "properties": {
    "agent_id": {
      "type": "string"
    },
    "scan_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

get_discovery_analytics

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

Argument	Type	Description
window	string
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id"
  ],
  "properties": {
    "window": {
      "type": "string"
    },
    "agent_id": {
      "type": "string"
    }
  }
}

get_scan

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

Argument	Type	Description
limit	integer
offset	integer
scan_id*	string
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "scan_id"
  ],
  "properties": {
    "limit": {
      "type": "integer"
    },
    "offset": {
      "type": "integer"
    },
    "scan_id": {
      "type": "string"
    },
    "agent_id": {
      "type": "string"
    }
  }
}

import_leads

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

Argument	Type	Description
label	string
scan_id*	string
agent_id*	string
lead_ids*	array
outreach	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "scan_id",
    "lead_ids"
  ],
  "properties": {
    "label": {
      "type": "string"
    },
    "scan_id": {
      "type": "string"
    },
    "agent_id": {
      "type": "string"
    },
    "lead_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "outreach": {
      "type": "string"
    }
  }
}

list_connectors

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

Argument	Type	Description
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string"
    }
  }
}

list_scan_results

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

Argument	Type	Description
limit	integer
offset	integer
scan_id*	string
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "scan_id"
  ],
  "properties": {
    "limit": {
      "type": "integer"
    },
    "offset": {
      "type": "integer"
    },
    "scan_id": {
      "type": "string"
    },
    "agent_id": {
      "type": "string"
    }
  }
}

list_scan_schedules

List auto-scan schedules for an agent.

Argument	Type	Description
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string"
    }
  }
}

list_scans

List past and active leads discovery scans for an agent.

Argument	Type	Description
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string"
    }
  }
}

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.

Argument	Type	Description
params	object
channel*	string
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "channel"
  ],
  "properties": {
    "params": {
      "type": "object"
    },
    "channel": {
      "type": "string"
    },
    "agent_id": {
      "type": "string"
    }
  }
}

suggest_targets

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

Argument	Type	Description
channel*	string
agent_id*	string
min_followers	integer
discovery_depth	integer
discovery_breadth	integer
disable_hard_filter	boolean

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "channel"
  ],
  "properties": {
    "channel": {
      "enum": [
        "instagram",
        "x"
      ],
      "type": "string"
    },
    "agent_id": {
      "type": "string"
    },
    "min_followers": {
      "type": "integer"
    },
    "discovery_depth": {
      "type": "integer"
    },
    "discovery_breadth": {
      "type": "integer"
    },
    "disable_hard_filter": {
      "type": "boolean"
    }
  }
}

trigger_scan_schedule

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

Argument	Type	Description
agent_id*	string
schedule_id*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "schedule_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string"
    },
    "schedule_id": {
      "type": "string"
    }
  }
}

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.

Argument	Type	Description
label	string
params	object
channel	string
enabled	boolean
agent_id*	string
max_runs	integer
frequency	string
auto_import	boolean
schedule_id*	string
run_hour_utc	integer
auto_outreach	string