Developer Tools
Overview
Threpoly helps teams review the health, availability and security posture of monitored managed file transfer applications from within ChatGPT. Use Threpoly to check current service status, identify active outages, review historical SLA performance, investigate failed connectivity checks, monitor upload and download workflow tests, and see whether expected files or AS2 messages are overdue. Threpoly also provides security scores and prioritized recommendations for monitored services, helping teams identify configuration changes and areas that may need attention. The app is read-only. It retrieves monitoring information from the authenticated customer’s Threpoly account and does not expose passwords, private keys or other secrets.
Tools
Get configuration and safe summary details for one monitored application belonging to the authenticated Threpoly user's company. Use threpoly_list_applications first when the user provides an application name rather than an application_id. Use this tool for questions about the application's configuration or metadata. For a live health summary, use threpoly_get_heartbeat_overview instead. This tool is read-only.
threpoly_get_application_executive_summary
ChatGPTGet a combined customer-facing executive summary for one monitored application belonging to the authenticated Threpoly user's company. The response combines current inbound heartbeat health, ongoing connectivity outages, historical SLA, recent upload and download workflow-test failures, current security posture, highest-priority security recommendations and ongoing outbound-heartbeat expected-file outages. Use this tool when the user asks for an executive summary, overview, overall position, management summary, customer-facing summary or broad current-state report for one application. Use threpoly_list_applications first when the user provides an application name rather than an application_id. The default historical lookback period is 7 days. Increase lookback_days only when the user requests a longer period. Clearly distinguish current incidents from historical metrics. Mention any warnings when a section could not be retrieved. Do not describe an application as production, development or test unless the returned data explicitly includes that environment classification. This tool is read-only.
threpoly_get_company_test
ChatGPTGet details for one configured upload or download company test belonging to the authenticated Threpoly user's company. Use this after threpoly_list_company_tests when the user wants more detail about a specific file-transfer workflow test, such as its application, test type, configuration, schedule, active state or transfer steps. Do not ask the user for a test ID when it can be resolved from threpoly_list_company_tests. This tool is read-only.
threpoly_get_heartbeat_averages
ChatGPTGet historical heartbeat timing averages for one monitored application, grouped by weekday, hour range, time block, agent cluster and target. Use this tool for questions about expected performance, typical response times, timing baselines, slow periods, weekday comparisons or regional performance differences. When the user provides an application name rather than an application_id, use threpoly_list_applications first to resolve the ID. For live status, use threpoly_get_heartbeat_overview instead. For detected deviations from established performance, use threpoly_list_heartbeat_performance_changes instead. This tool is read-only.
threpoly_get_heartbeat_outage
ChatGPTGet details for one heartbeat outage belonging to the authenticated Threpoly user's company. Use this after threpoly_list_heartbeat_outages or threpoly_list_ongoing_heartbeat_outages when the user wants more detail about one incident, such as its timing, affected application, impacted targets or outage type. Do not ask the user for an outage ID when it can be resolved from a previously returned outage list. This tool is read-only.
threpoly_get_heartbeat_overview
ChatGPTGet the latest heartbeat health overview for one monitored application belonging to the authenticated Threpoly user's company. Use this as the first application-specific tool when the user asks for the current health, current position, latest status, availability, or a customer-facing summary of an application. The response includes the latest heartbeat run summary and status for each target and agent cluster. Use threpoly_list_applications first when the user provides an application name rather than an application_id. For historical availability percentages, use threpoly_get_heartbeat_sla instead. For detailed results from one specific run, use threpoly_get_heartbeat_run. This tool is read-only.
threpoly_get_heartbeat_performance_change
ChatGPTGet details for one detected heartbeat performance change belonging to the authenticated Threpoly user's company. Use this after threpoly_list_heartbeat_performance_changes when the user wants more detail about a specific MICRO or MACRO change, including the affected application, region, target, measured value, historical comparison value or deviation. Do not ask the user for a detection ID when it can be resolved from a previous Threpoly response. This tool is read-only.
threpoly_get_heartbeat_run
ChatGPTGet detailed per-target and per-agent-cluster results for one heartbeat run belonging to the authenticated Threpoly user's company. Use this after threpoly_list_heartbeat_runs, threpoly_list_failed_heartbeat_runs or threpoly_get_heartbeat_overview when the user asks for technical detail about a specific monitoring cycle. Do not ask the user for a run ID when it can be resolved from a previous Threpoly response. This tool is read-only.
threpoly_get_heartbeat_sla
ChatGPTGet finalized historical heartbeat SLA and uptime metrics for one monitored application belonging to the authenticated Threpoly user's company. Use this tool for questions about SLA, uptime percentage, historical availability, service reliability or availability over a requested date range. The default period is the last 7 days. When the user provides an application name rather than an application_id, use threpoly_list_applications first to resolve the ID. For the latest live health position rather than historical availability, use threpoly_get_heartbeat_overview instead. Clearly state the time period used when presenting SLA values. This tool is read-only.
threpoly_get_latest_security_score
ChatGPTGet the latest security score and security level for one monitored application belonging to the authenticated Threpoly user's company. Use this tool when the user asks about an application's current security posture, security score, security level, security recommendations or a customer-facing security summary. Use threpoly_list_applications first when the user provides an application name rather than an application_id. Present the score using final_score, score_maximum and score_percentage so the user understands the scale. Set include_details to true only when the user requests per-target findings, algorithms, certificate details or recommendations. "Use the explicit certificate_expiry_status and certificate_signing_validation_status fields when discussing certificates. Do not infer a certificate failure from a missing or NOT_REPORTED value. " + This tool is read-only.
threpoly_get_outbound_as2_partner
ChatGPTGet safe operational details for one AS2 virtual trading partner belonging to the authenticated Threpoly user's company. Use this after threpoly_list_outbound_as2_partners when the user asks for a partner's AS2 identifiers, inbound folder mapping, signing requirement, encryption requirement, compression mode or MDN configuration. Do not ask the user for an AS2 partner ID when it can be resolved from a previous partner list. This tool intentionally excludes certificates, certificate IDs, private keys, secret IDs and raw certificate material. This tool is read-only.
threpoly_get_outbound_folder
ChatGPTGet one virtual trading partner folder and the safe details of user accounts assigned to it. Use this after threpoly_list_outbound_folders when the user asks who can access a particular folder. Do not ask the user for a folder ID when it can be resolved from a previous folder list. This tool does not list uploaded files, passwords, physical storage keys or folder nodes. This tool is read-only.
threpoly_get_outbound_heartbeat_monitor
ChatGPTGet detailed configuration for one outbound-heartbeat monitor belonging to the authenticated Threpoly user's company. Use this after threpoly_list_outbound_heartbeat_monitors when the user asks for a monitor's expected interval, protocol routes, filename masks, folder mappings, usernames, minimum file sizes, last-seen timestamps or AS2 trading-partner mapping. Do not ask the user for a heartbeat ID when it can be resolved from a previous monitor list. This tool intentionally excludes passwords, password hashes, certificate IDs, secret IDs, private keys and raw certificate material. This tool is read-only.
threpoly_get_target
ChatGPTGet safe configuration details for one monitored target belonging to an application in the authenticated Threpoly user's company. Use this after threpoly_list_targets when the user wants more detail about a specific service or server connection, such as its protocol, hostname, port or active configuration. Use threpoly_list_applications first when the user provides an application name rather than an application_id. Do not ask the user for a target ID when it can be resolved from threpoly_list_targets. This tool is read-only.
threpoly_list_applications
ChatGPTList the monitored applications belonging to the authenticated Threpoly user's company. Use this tool first when the user refers to an application by name, asks which applications are monitored, or needs an application_id for another Threpoly tool. Match application names case-insensitively. Do not ask the user for an application ID when it can be resolved with this tool. This tool is read-only.
threpoly_list_company_test_failures
ChatGPTList upload and download company-test failure events belonging to the authenticated Threpoly user's company. Use this tool when the user asks whether monitored file-transfer workflows have failed, whether uploads or downloads encountered errors, or whether there were recent end-to-end transfer-test failures. Optionally filter by application, company-test ID and date range. The default period is the last 30 days. When the user provides an application name rather than an application_id, use threpoly_list_applications first to resolve the ID. When the user names a configured workflow test rather than a test_id, use threpoly_list_company_tests first to resolve the ID. Do not confuse company-test failures with heartbeat connectivity failures or heartbeat outages. This tool is read-only.
threpoly_list_company_tests
ChatGPTList configured upload and download company tests belonging to the authenticated Threpoly user's company. Company tests monitor file-transfer workflows and are separate from heartbeat connectivity checks. Use this tool when the user asks which upload tests, download tests, file-transfer workflow tests or end-to-end transfer checks are configured. Optionally filter by application_id. When the user provides an application name rather than an application_id, use threpoly_list_applications first to resolve the ID. For details about one returned workflow test, use threpoly_get_company_test. For failure events, use threpoly_list_company_test_failures. This tool is read-only.
threpoly_list_failed_heartbeat_runs
ChatGPTList lightweight summaries for heartbeat runs containing one or more failed checks for one monitored application belonging to the authenticated Threpoly user's company. Use this tool when the user asks about recent failed checks, failed heartbeat runs, connectivity issues, monitoring errors or recent service-specific failures. The default period is the last 7 days. When the user provides an application name rather than an application_id, use threpoly_list_applications first to resolve the ID. Use threpoly_get_heartbeat_run only when more technical detail about one returned run is required. Do not describe failed runs as a confirmed outage unless outage data supports that conclusion. This tool is read-only.
threpoly_list_heartbeat_outages
ChatGPTList ended heartbeat outages belonging to the authenticated Threpoly user's company. Use this tool for historical outage, incident-history, downtime-history or previous-availability-issue questions. Optionally filter by application_id. When the user provides an application name rather than an application_id, use threpoly_list_applications first to resolve the ID. For incidents that are happening now, use threpoly_list_ongoing_heartbeat_outages instead. For more detail about one returned outage, use threpoly_get_heartbeat_outage. This tool is read-only.
threpoly_list_heartbeat_performance_changes
ChatGPTList detected heartbeat performance changes for the authenticated Threpoly user's company. Use this tool when the user asks whether response times have changed, whether any service has become slower or faster, whether there are recent performance anomalies, or whether Threpoly detected a change from an established baseline. Optionally filter by application, heartbeat configuration, MICRO or MACRO change type, and date range. When the user provides an application name rather than an application_id, use threpoly_list_applications first to resolve the ID. For historical timing baselines rather than detected deviations, use threpoly_get_heartbeat_averages. For more detail about one returned detection, use threpoly_get_heartbeat_performance_change. This tool is read-only.
threpoly_list_heartbeat_runs
ChatGPTList lightweight heartbeat run summaries for one monitored application belonging to the authenticated Threpoly user's company. Use this tool when the user asks to review recent monitoring checks, heartbeat history or recent runs for an application. The default period is the last 24 hours. When the user provides an application name rather than an application_id, use threpoly_list_applications first to resolve the ID. For failed runs only, use threpoly_list_failed_heartbeat_runs instead. For details about one returned run, use threpoly_get_heartbeat_run. This tool is read-only.
threpoly_list_ongoing_heartbeat_outages
ChatGPTList heartbeat outages that are currently ongoing across the authenticated Threpoly user's company. Use this tool for questions such as whether anything is currently down, whether there are any active incidents, or whether any monitored application has an ongoing outage. For historical incidents that have already ended, use threpoly_list_heartbeat_outages instead. For more detail about one returned outage, use threpoly_get_heartbeat_outage. This tool is read-only.
threpoly_list_ongoing_outbound_heartbeat_outages
ChatGPTList currently ongoing outbound-heartbeat outages across the authenticated Threpoly user's company. Use this tool first when the user asks whether any expected files or AS2 messages are currently overdue, late or missing, whether a trading partner is late sending a file, or whether there are any active expected-file incidents. Optionally filter by application_id. Use threpoly_list_applications first when the user names an application. An outage remains ongoing until a later matching file or AS2 message closes the incident. This tool is read-only.
threpoly_list_outbound_as2_partners
ChatGPTList safe AS2 virtual trading-partner configurations belonging to the authenticated Threpoly user's company. Use this tool when the user asks which AS2 trading partners are configured, which applications have AS2 partner mappings, or which remote and local AS2 IDs are in use. Optionally filter by application_id. Use threpoly_list_applications first when the user provides an application name rather than an application_id. Inactive partners are excluded unless include_inactive is true. This tool intentionally excludes certificates, certificate IDs, private keys, secret IDs and internal cryptographic policy. This tool is read-only.
threpoly_list_outbound_folders
ChatGPTList virtual trading partner folders belonging to the authenticated Threpoly user's company. Use this tool when the user asks which folders are available for file transfers to Threpoly or wants to know how many user accounts are assigned to each folder. These folders apply to SFTP, FTPS and HTTPS folder-based transfers. AS2 uses trading-partner configuration with an inbound folder mapping instead. Optionally filter by application_id. Use threpoly_list_applications first when the user provides an application name rather than an application_id. This tool does not list uploaded files, physical storage keys or folder nodes. This tool is read-only.
threpoly_list_outbound_heartbeat_monitors
ChatGPTList outbound-heartbeat monitors belonging to the authenticated Threpoly user's company. Outbound heartbeats monitor whether an expected file or AS2 message arrives through a Threpoly virtual trading partner route at an agreed interval. Use this tool when the user asks which expected-file monitors are configured, how frequently files are expected, or which applications have outbound-heartbeat monitoring. Optionally filter by application_id. Use threpoly_list_applications first when the user provides an application name rather than an application_id. Inactive monitors are excluded unless include_inactive is true. This tool returns configuration only. For current late-file incidents or historical outages, use the outbound-heartbeat status and outage tools when available. This tool is read-only.
threpoly_list_outbound_heartbeat_outages
ChatGPTList historical outbound-heartbeat outages for one expected-file monitor belonging to the authenticated Threpoly user's company. Use this tool when the user asks whether expected files were late or missing in the past, wants expected-file incident history, or asks how long a previous missing-file outage lasted. Use threpoly_list_outbound_heartbeat_monitors first when the user provides an application name or describes a monitor without a heartbeat_id. For currently overdue expected files, use threpoly_list_ongoing_outbound_heartbeat_outages instead. This tool is read-only.
threpoly_list_outbound_transfer_endpoints
ChatGPTList active customer-facing Threpoly virtual trading partner endpoints for ad-hoc file transfer over SFTP, FTPS, HTTPS and AS2. Use this tool when the user asks how to connect to Threpoly for file transfer, which protocols can be used, which hostname should be used, or which ports are available. For AS2, the response includes the submission URL and safe server-level AS2 requirements. AS2 trading-partner-specific settings are handled separately and are not returned by this tool. This tool intentionally excludes passwords, secrets, certificates, host-key configuration and internal cryptographic policy. This tool is read-only.
threpoly_list_outbound_users
ChatGPTList safe virtual trading partner user details for the authenticated Threpoly user's company. Use this tool when the user asks which accounts can connect to the Threpoly virtual trading partner or which outbound transfer usernames exist. These user accounts apply to SFTP, FTPS and HTTPS folder-based transfers. AS2 uses trading-partner configuration instead. Optionally filter by application_id. Use threpoly_list_applications first when the user provides an application name rather than an application_id. Never ask for, return or describe passwords or password hashes. This tool is read-only.
threpoly_list_recent_outbound_heartbeat_results
ChatGPTList recent outbound-heartbeat validation results for one expected-file monitor belonging to the authenticated Threpoly user's company. Use this tool when the user asks whether expected files or AS2 messages arrived, whether the latest check passed, when matching files were last received, or wants recent expected-file validation history. The default period is the last 24 hours. Use threpoly_list_outbound_heartbeat_monitors first when the user provides an application name or describes a monitor without a heartbeat_id. Do not describe a MISS result as a confirmed current outage unless the ongoing-outage tool also shows an open incident. This tool is read-only.
threpoly_list_recent_security_scores
ChatGPTList recent security-score assessments for one monitored application belonging to the authenticated Threpoly user's company. Use this tool when the user asks how an application's security posture has evolved, whether its score has changed, or wants recent assessment history. Use threpoly_list_applications first when the user provides an application name rather than an application_id. Set unique to true when the user wants significant score change points rather than every assessment. This tool is read-only.
threpoly_list_security_recommendations
ChatGPTList the security recommendations associated with the latest security assessment for one monitored application belonging to the authenticated Threpoly user's company. Use this tool when the user asks which security improvements should be made, which cryptographic settings should be changed first, what the highest-priority recommendations are, or whether any recommendations of a particular severity exist. Recommendations may apply to the overall application or to an individual monitored target. Use threpoly_list_applications first when the user provides an application name rather than an application_id. Use the optional severity filter only when the user asks for a specific severity. Describe these as recommendations associated with the latest assessment, not as permanently unresolved issues, because this tool does not track a separate remediation workflow. This tool is read-only.
threpoly_list_security_score_changes
ChatGPTList security-score assessments where Threpoly detected configuration differences for one monitored application belonging to the authenticated user's company. Use this tool when the user asks whether security settings changed, whether cryptographic configuration changed, whether a score changed recently, or wants a recent security-change history. The default period is the last 30 days. Use threpoly_list_applications first when the user provides an application name rather than an application_id. Set include_details to true when the user requests detailed per-target findings. This tool is read-only.
threpoly_list_targets
ChatGPTList the active monitored targets for one application belonging to the authenticated Threpoly user's company. Targets represent the configured monitored services or server connections, such as SFTP, FTPS, HTTPS or AS2. Use this tool when the user asks which services are monitored for an application, when a target_id is needed for another Threpoly tool, or when a request should be restricted to a specific protocol such as SFTP. When the user provides an application name rather than an application_id, use threpoly_list_applications first to resolve the ID. Do not ask the user for a target ID when it can be resolved with this tool. This tool is read-only.
threpoly_ping
ChatGPTCheck whether the Threpoly MCP service is running and responding. Use this only when the user asks whether the Threpoly app, MCP integration or connector itself is online. Do not use this tool to answer questions about the health of monitored customer applications; use threpoly_get_heartbeat_overview or threpoly_list_ongoing_heartbeat_outages for those questions. This tool is read-only.





