Tingyun Network MCP Tools

1. Document Overview

Tingyun Network MCP exposes Tingyun Synthetic Monitoring resources, Alerts, Instant Testing, and Synthetic Task management capabilities to compatible clients and AI Agents as MCP resources and tools. This document describes the tool scope, operation permissions, recommended call sequences, full descriptions, and example prompts.

Audience: Operations engineers, developers, and AI Agent users who need to query Synthetic Monitoring data, initiate Instant Tests, or manage scheduled Synthetic Tasks through an MCP client.

Scope: 2 read-only MCP resources and 29 MCP tools, organized into MCP resources, Alerts, Instant Testing, and Synthetic Tasks.

Principle: Verify the tool method, operation type, and account visibility first. Before a write operation, display its parameters and quota or traffic impact, obtain explicit confirmation, execute it, and then query the result.

Category	Count	Operations	Endpoint / URI
Resources	2	2 read-only dictionaries	`tingyun://synthetic/dictionaries/*`
Alerts	3	3 read-only tools	`/mcp/synthetic/alert`
Instant Testing	11	5 read-only tools and 6 write tools	`/mcp/synthetic/instant`
Synthetic Tasks	14	7 read-only tools and 7 write tools	`/mcp/synthetic/task`
Feedback	1	1 write tool	Available on every endpoint

2. Permission Types

Tingyun Network MCP classifies tools as Read-only or Write based on their behavior. This classification indicates whether a call changes tasks, configurations, or data in Tingyun and supports Agent automation and human-confirmation policies.

Permission Type	Meaning	Recommendation
Read-only	Queries, searches, lists, retrieves details, verifies results, or views usage and remaining quota. It does not create, update, enable, disable, or delete tasks, and does not actively initiate monitoring that consumes Synthetic Monitoring quota or traffic.	May be made available for automatic Agent calls as needed. The current account's visibility of tasks, Probes, Alerts, and result data still applies.
Write	Creates an Instant Test or scheduled Synthetic Task, or updates a task state. It changes tasks or runtime state in the workspace and may consume Synthetic Monitoring quota or traffic.	Enable human confirmation in the Agent client. Before execution, display the target, Probes, parameters, frequency, package, and impact. Query the identifier and status afterward.

3. How to Use This Tool Reference

Toolsets: Each MCP module is presented in a continuous table for comparing tool methods, names, operation types, permissions, full descriptions, and examples.

Operations: Read-only operations do not modify tasks or data. Write operations may create, enable, or disable monitoring, or consume traffic and quota.

Permissions: This document marks each tool as Read-only or Write. Actual calls require the current Tingyun account to have the appropriate view or operation permissions for the relevant resources.

4. Recommended Call Sequences

Scenario	Call Sequence	Guidance
Alert investigation	Alert log list → Alert summary → Probe-level details	Find the issue first, assess its impact, and then identify the affected Probes.
Instant Testing	Online Probes → Initiate test → Summary → Detail list → Individual detail	Validate the Probes before initiating a test. Display parameters and quota impact before the write operation.
Scheduled Synthetic Tasks	Dictionaries / packages / Probe Groups / remaining quota → Create → Task list / status → Raw data or resource data	Validate identifiers, the package, and quota before creating or modifying a continuously running task.

5. MCP Resources

Endpoint / URI: tingyun://synthetic/dictionaries/*

These resources provide standard city and carrier identifiers for subsequent tool calls, preventing clients from inferring parameters from names.

Call rule: Resources are read-only. Subsequent tool calls must use identifiers returned by the resources and must not infer identifiers from display names.

No.	Resource URI	Resource Name	Access	Full Description, Access Requirements, and Example
1	`tingyun://synthetic/dictionaries/cities`	City Dictionary	Read-only	Resource description Returns the city dictionary available for Synthetic Probes or monitoring targets, including city identifiers and names used for task configuration, Alert filtering, Probe Group creation, online Probe queries for Instant Testing, and Probe Group queries. This resource is read-only. Callers must use the returned city identifiers as parameters for subsequent tools and must not infer identifiers from city names.
2	`tingyun://synthetic/dictionaries/isps`	Carrier Dictionary	Read-only	Resource description Returns the carrier dictionary available for Synthetic Probes or monitoring targets, including carrier identifiers and names used for task configuration, Alert filtering, Probe Group creation, online Probe queries for Instant Testing, and Probe Group queries. This resource is read-only. Callers must use the returned carrier identifiers as parameters for subsequent tools and must not infer identifiers from carrier names.

6. Alert Toolset

Endpoint / URI: /mcp/synthetic/alert

Use this toolset to find Alerts, assess their overall impact, and drill down into Probe-level anomaly details.

Toolset overview: 3 tools: 3 read-only tools and 0 write tools. Visible data and available operations depend on the current account's permissions.

No.	Tool Method	Tool Name	Operation	Full Description, Permissions, and Example
1	`list_tingyun_synthetic_alert`	Alert Log List	Read-only	Tool description Queries the Synthetic Monitoring Alert logs visible to the current account. Filters can include time range, task type, and Alert state. The response contains Alert summaries and Alert identifiers required for subsequent summary or detail queries. Use this tool to find recent anomalies, not to retrieve the complete details of a single Alert. This is a read-only operation.
2	`get_tingyun_synthetic_alert_summary`	Alert Summary	Read-only	Tool description Queries the summary of a single Synthetic Monitoring Alert by Alert identifier, including the affected scope, duration, anomalous Probes, and key performance metrics. Use it to assess Alert severity and overall impact. To inspect specific Probes or test results, call `list_tingyun_synthetic_alert_detail_rows`. This is a read-only operation.
3	`list_tingyun_synthetic_alert_detail_rows`	Alert Detail Rows	Read-only	Tool description Queries Probe-level details for a single Synthetic Monitoring Alert by Alert identifier. Use it to identify the source of an anomaly. The tool returns a list of individual Synthetic Monitoring samples and does not replace the Alert summary tool. This is a read-only operation.

7. Instant Testing Toolset

Endpoint / URI: /mcp/synthetic/instant

Use this toolset to select online Probes, initiate a one-time test, and view summaries, samples, and complete details for an individual sample.

Toolset overview: 11 tools: 5 read-only tools and 6 write tools. Visible data and available operations depend on the current account's permissions.

No.	Tool Method	Tool Name	Operation	Full Description, Permissions, and Example
1	`list_tingyun_synthetic_online_probe`	Online Probe List	Read-only	Tool description Queries the Synthetic Probes currently available for Instant Testing. Returns Probe identifiers, locations, carriers, and types for selecting Probes before initiating an Instant Test. Probe status can change over time. This is a read-only operation.
2	`list_tingyun_synthetic_instant_test`	Instant Test List	Read-only	Tool description Queries Instant Test records for the current account. Filters can include target address, time range, and task type. The response contains summaries such as the Instant Test identifier, target, type, creation time, and execution status. Use it to locate historical records and lists of Synthetic Monitoring samples. This is a read-only operation.
3	`get_tingyun_synthetic_instant_test_results`	Instant Test Summary	Read-only	Tool description Queries aggregated results for an Instant Test identifier, including Availability, response time, and error distribution summaries for each test. Use it to assess the target's current quality. The tool reads existing results and does not initiate a new test. Use the Instant Test detail list tool to locate individual Synthetic Monitoring samples. This is a read-only operation.
4	`list_tingyun_synthetic_instant_test_details`	Instant Test Detail List	Read-only	Tool description Queries a paginated list of Synthetic Monitoring samples by Instant Test identifier. Use it to identify the source of an anomaly. The returned individual samples can be used to query the complete details of a specific sample. This is a read-only operation.
5	`get_tingyun_synthetic_instant_test_detail`	Instant Test Detail	Read-only	Tool description Queries the complete test details for an individual Synthetic Monitoring sample by detail identifier, including request and response summaries, error information, and performance metrics. Use it for in-depth analysis of an identified anomalous Probe. This is a read-only operation.
6	`create_tingyun_synthetic_instant_test_page`	Page Test	Write	Tool description Initiates a page Instant Test that accesses a specified page URL from selected online Probes and measures page Availability, First Contentful Paint (FCP), DNS, TCP, SSL, response time, and other metrics. The call sends tests to an external target and may consume Synthetic Monitoring quota. Confirm the target URL, Probes, and test parameters before submission. A successful request returns an Instant Test identifier and acceptance or execution status. Use the result query tools afterward.
7	`create_tingyun_synthetic_instant_test_file`	File Test	Write	Tool description Initiates a file-download Instant Test that accesses a specified file URL from selected online Probes and measures Availability, Download Speed, file size, and response time. The call downloads data from an external target and may consume Synthetic Monitoring quota. Confirm the target URL, Probes, and download parameters before submission. A successful request returns an Instant Test identifier and acceptance or execution status. Use the result query tools afterward.
8	`create_tingyun_synthetic_instant_test_ping`	Ping Test	Write	Tool description Initiates a Ping Instant Test from selected online Probes to measure network reachability, packet loss, and minimum, maximum, and average latency for a target domain or IP address. The call sends test packets to an external target and may consume Synthetic Monitoring quota. Confirm the target and Probes before submission. A successful request returns an Instant Test identifier and acceptance or execution status. Use the result query tools afterward.
9	`create_tingyun_synthetic_instant_test_streaming`	Streaming Test	Write	Tool description Initiates a streaming Instant Test that accesses a specified audio or video stream from selected online Probes and measures Availability, time to first frame, buffering, stalls, and playback quality. The call may generate actual streaming traffic and consume Synthetic Monitoring quota. Confirm the stream URL, Probes, protocol, and test duration before submission. A successful request returns an Instant Test identifier and acceptance or execution status.
10	`create_tingyun_synthetic_instant_test_mtr`	MTR Test	Write	Tool description Initiates an MTR Instant Test from selected online Probes to analyze the network path, hop count, per-hop latency, and packet loss to a specified domain or IP address. The call sends route-probing traffic to an external network and may consume Synthetic Monitoring quota. Confirm the target, Probes, and test parameters before submission. A successful request returns an Instant Test identifier and acceptance or execution status.
11	`create_tingyun_synthetic_instant_test_whois`	Whois Test	Write	Tool description Initiates a domain Whois Instant Test to query registration information, expiration date, registrar, DNS information, and registration status for a specified domain. Use it to check current domain information. The call may consume Synthetic Monitoring quota. A successful request returns an Instant Test identifier and acceptance or execution status.

8. Synthetic Task Toolset

Endpoint / URI: /mcp/synthetic/task

Use this toolset to query tasks, enable or disable tasks, create scheduled monitoring, validate quota and packages, and query raw data or page-resource data.

Toolset overview: 14 tools: 7 read-only tools and 7 write tools. Visible data and available operations depend on the current account's permissions.

No.	Tool Method	Tool Name	Operation	Full Description, Permissions, and Example
1	`list_tingyun_synthetic_tasks`	Synthetic Task List	Read-only	Tool description Queries the Synthetic Tasks and basic configurations visible to the current account. Filters can include task name, task ID, or package ID. The response contains task identifiers, names, types, states, and key configuration summaries. Use it to find an existing task and obtain its identifier for status updates or data queries. This is a read-only operation.
2	`update_tingyun_synthetic_task_status`	Update Synthetic Task Status	Write	Tool description Updates the runtime state of an existing Synthetic Task by task identifier to enable or disable it. This operation changes an online task and may stop or resume testing and quota consumption. Before execution, validate permissions and display the task name, current state, and target state for explicit confirmation. The tool returns the updated state and does not create or delete tasks.
3	`create_tingyun_synthetic_task_page`	Page Monitoring	Write	Tool description Creates a Page Monitoring task that periodically accesses a page URL from the specified Probe Groups and measures page Availability, response status, DNS, TCP, SSL, Time to First Byte (TTFB), and page load time. This operation creates a continuously running online task that consumes Synthetic Monitoring quota. Confirm the task name, target, Probe Groups, frequency, package, and monitoring parameters before submission. A successful request returns a task identifier.
4	`create_tingyun_synthetic_task_file`	File Monitoring	Write	Tool description Creates a File Monitoring task that periodically accesses a file URL from the specified Probe Groups and measures accessibility, download time, Download Speed, file size, status code, and network-stage timings. This operation creates a continuously running online task that generates recurring download traffic and consumes quota. Confirm the target, Probe Groups, frequency, package, and download parameters before submission. A successful request returns a task identifier.
5	`create_tingyun_synthetic_task_ping`	Ping Monitoring	Write	Tool description Creates a Ping Monitoring task that periodically checks the reachability, packet loss, and minimum, maximum, and average latency of a target domain or IP address from specified Probe Groups. This operation creates a continuously running online task that consumes Synthetic Monitoring quota. Confirm the target, Probe Groups, frequency, package, and test parameters before submission. A successful request returns a task identifier.
6	`create_tingyun_synthetic_task_streaming`	Streaming Monitoring	Write	Tool description Creates a Streaming Monitoring task that periodically accesses an audio or video stream from specified Probe Groups and measures Availability, time to first frame, buffering, stalls, and playback quality. This operation creates a continuously running online task, may generate recurring streaming traffic, and consumes quota. Confirm the stream URL, protocol, Probe Groups, frequency, test duration, and package before submission. A successful request returns a task identifier.
7	`create_tingyun_synthetic_task_mtr`	MTR Monitoring	Write	Tool description Creates an MTR Monitoring task that periodically analyzes the network path, hop count, per-hop latency, and packet loss to a target domain or IP address from specified Probe Groups. This operation creates a continuously running online task that consumes Synthetic Monitoring quota. Confirm the target, Probe Groups, frequency, package, and route-probing parameters before submission. A successful request returns a task identifier.
8	`create_tingyun_synthetic_task_whois`	Domain Whois Monitoring	Write	Tool description Creates a Domain Whois Monitoring task that periodically queries domain registration information, expiration date, registrar, DNS information, and registration status to continuously identify expiration, information changes, or status anomalies. This operation creates a continuously running online task that consumes Synthetic Monitoring quota. Confirm the domain, frequency, package, and Alert conditions before submission. A successful request returns a task identifier.
9	`get_tingyun_synthetic_usage`	Usage	Read-only	Tool description Queries Synthetic Monitoring usage for a specified time range at daily, weekly, or other granularities and returns statistics for analyzing quota-consumption trends. Historical usage does not represent the current remaining quota. To determine whether monitoring can be created or initiated, call the remaining-quota tool. This is a read-only operation.
10	`get_tingyun_synthetic_remaining_quota`	Remaining Quota	Read-only	Tool description Queries the current account's remaining Synthetic Monitoring quota for validation before creating a task or initiating an Instant Test. The tool only reads quota status. It does not reserve quota and does not guarantee that the quota will remain unchanged before a subsequent creation request.
11	`list_tingyun_synthetic_packages`	Package List	Read-only	Tool description Queries the Synthetic Monitoring packages visible to the current account and their states. The response contains package identifiers, names, validity periods, and status summaries required for task creation. Use it to select and validate a package before creating a task. The tool does not reserve or modify package quota. This is a read-only operation.
12	`list_tingyun_synthetic_probe_groups`	Probe Group List	Read-only	Tool description Queries the Probe Groups and basic information visible to the current account. The response contains Probe Group identifiers, names, and Probe summaries required for task creation. Use it to select or validate a Probe Group before creating a task. The tool does not modify Probe Groups. This is a read-only operation.
13	`get_tingyun_synthetic_raw_json`	Raw JSON Export	Read-only	Tool description Queries raw JSON results for a specified Synthetic Task and time range for incident review, evidence retention, or offline analysis. A single call returns at most 200 records. Reduce the time range to avoid missing data. The tool is not intended for complete bulk export and does not modify tasks or data.
14	`list_tingyun_synthetic_page_resources`	Page Resource Export	Read-only	Tool description Queries page-resource-level data from Page Monitoring task results, including resource URL, resource type, load time, and status information, for analyzing page performance bottlenecks. This is a read-only list query.

9. Feedback Tool

Endpoint / URI:

/mcp/synthetic/task

/mcp/synthetic/alert

/mcp/synthetic/instant

Submit feedback when an AI Agent encounters a blocker or determines that an approach does not work. Include the intent, attempted steps, and issue encountered.

No.	Tool Method	Tool Name	Operation	Full Description, Permissions, and Example
1	`submitFeedback`	Feedback Tool	Write	Tool description Submit feedback when an AI Agent encounters a blocker or determines that an approach does not work. Include the intent, attempted steps, and issue encountered.

Tingyun Network MCP Tools

1. Document Overview#

2. Permission Types#

3. How to Use This Tool Reference#

4. Recommended Call Sequences#

5. MCP Resources#

6. Alert Toolset#

7. Instant Testing Toolset#

8. Synthetic Task Toolset#

9. Feedback Tool#