How do I use connectwise-asio-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@connectwise-asio-mcp show me all companies" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

connectwise-asio-mcp

by MSPbotsAI

Overview Schema Related Servers Score Discussions

Python

Remote

connectwise-asio-mcp

ConnectWise Asio MCP server — exposes the ConnectWise Platform APIs (the "Current API" behind ConnectWise Asio, formerly SolarWinds MSP/N-central-adjacent RMM) as MCP tools.

Naming note: app.mspbots.ai calls this integration "ConnectWise Asio" (sys_integration.subject_code = CWASIO). It is a distinct product from ConnectWise Command (Continuum), ConnectWise Manage (PSA), and ConnectWise Automate — each has its own MCP server in this fleet. The underlying API is officially named "ConnectWise Platform APIs" in its OpenAPI spec (developer.connectwise.com — "REST API" doc under Products > ConnectWise Platform > Platform Vendors > APIs and Callbacks).

Overview

This server implements the Model Context Protocol (Streamable HTTP/SSE transport) and wraps every resource in the official ConnectWise Platform APIs OpenAPI 3.0 spec (v2.7.7, 107 operations across 24 tag categories). It follows the MSPbots Vendor MCP Service SOP: stateless, no stored credentials, per-request header authentication.

The underlying API authenticates via OAuth2 Client Credentials. This server does not perform the token exchange itself — it receives an already-obtained bearer access token per request (matching how other OAuth-flow integrations, e.g. Microsoft Graph, are handled in this MSPbots MCP fleet: the gateway mints/refreshes the token from client_id/client_secret/scope, and only the resulting token reaches this server).

Quick Start

Docker (recommended)

docker compose up --build

The server starts on http://localhost:8080.

Local (uv)

uv sync
python -m connectwise_asio_mcp

Health Check

curl http://localhost:8080/health
# {"status": "ok", "service": "connectwise-asio-mcp", "transport": "http"}

No token is required for the health endpoint.

授权参数说明 (Authentication)

Every request to /mcp must include the following HTTP headers:

Header	类型	是否必填	默认值	枚举值	字段描述	Example
`X-ConnectWise-Asio-Token`	string	必填	无	无(自由文本)	OAuth2 bearer access token,由调用方(Agent Platform / 上游网关)通过 `POST /v1/token`(client_credentials grant,需 client_id + client_secret + scope)预先换取并负责刷新。本服务从不接触 client_id/client_secret,只转发已获取的 token。	`X-ConnectWise-Asio-Token: <access_token>`
`X-ConnectWise-Asio-Base-Url`	string	可选	`CONNECTWISE_ASIO_BASE_URL` 环境变量(默认 `https://openapi.service.itsupport247.net`)	`https://openapi.service.itsupport247.net`(NA)、`https://openapi.service.euplatform.connectwise.com`(EU)、`https://openapi.service.auplatform.connectwise.com`(AU)	ConnectWise Asio 按账号所属地区分 3 个独立服务器(Client ID 前缀 0e30=NA/0e31=EU/0e32=AU 可判断地区);不带该 header 时用环境变量默认值,网关同时服务多地区租户时按请求覆盖。	`X-ConnectWise-Asio-Base-Url: https://openapi.service.euplatform.connectwise.com`

Missing X-ConnectWise-Asio-Token returns 401 Unauthorized.

Environment Variables

Variable	Default	Description
`MCP_HTTP_PORT`	`8080`	Listening port
`MCP_HTTP_HOST`	`0.0.0.0`	Listening host
`CONNECTWISE_ASIO_BASE_URL`	`https://openapi.service.itsupport247.net`	Default regional server; override per-request with `X-ConnectWise-Asio-Base-Url`

MCP Endpoint

POST http://localhost:8080/mcp

Connect your MCP client with:

Transport: http (Streamable HTTP / SSE)
Headers: X-ConnectWise-Asio-Token: <access_token> (required), X-ConnectWise-Asio-Base-Url: <base_url> (optional)

Tool List

104 tools — full coverage of every operation in the official ConnectWise Platform APIs spec (POST /v1/token, the token endpoint itself, is not exposed as a tool since the gateway handles OAuth token exchange, not this server).

Companies & Contacts (13)

Tool	功能	参数
`connectwise_asio_get_companies`	列出全部公司	无
`connectwise_asio_create_company`	新建公司(写操作)	`body`(dict, 需含 `name`)
`connectwise_asio_get_company`	按 ID 查公司	`company_id`
`connectwise_asio_replace_company`	全量替换公司(写操作)	`company_id`, `body`
`connectwise_asio_update_company`	JSON Patch 局部更新公司(写操作)	`company_id`, `patch_operations`
`connectwise_asio_get_company_sites`	列出公司下所有站点	`company_id`
`connectwise_asio_create_company_site`	在公司下新建站点(写操作)	`company_id`, `body`(需含 `name`,`timeZone`)
`connectwise_asio_get_company_site`	按 ID 查公司下站点	`company_id`, `site_id`
`connectwise_asio_replace_company_site`	全量替换站点(写操作)	`company_id`, `site_id`, `body`
`connectwise_asio_update_company_site`	JSON Patch 局部更新站点(写操作)	`company_id`, `site_id`, `patch_operations`
`connectwise_asio_get_sites`	列出全部站点(不分公司)	无
`connectwise_asio_get_site`	按 ID 查站点(不分公司)	`site_id`
`connectwise_asio_create_contact`	新建联系人(写操作)	`body`(需含 `firstName`,`lastName`)

Custom Fields (11)

Tool	功能	参数
`connectwise_asio_get_custom_field_definitions`	列出自定义字段定义	`entity_type?`, `origin_type?`
`connectwise_asio_create_custom_field_definition`	新建自定义字段定义(写操作)	`body`
`connectwise_asio_get_custom_field_definition`	按 ID 查字段定义	`definition_id`
`connectwise_asio_update_custom_field_definition`	替换字段定义(写操作)	`definition_id`, `body`
`connectwise_asio_delete_custom_field_definition`	删除字段定义(写操作)	`definition_id`
`connectwise_asio_get_company_custom_fields`	查公司自定义字段值	`company_id`, `attribute_ids?`, `with_defaults?`, `origin_type?`, `owner_id?`
`connectwise_asio_update_company_custom_fields`	更新公司自定义字段值(写操作)	`company_id`, `body`
`connectwise_asio_get_site_custom_fields`	查站点自定义字段值	`site_id`, `attribute_ids?`, `with_defaults?`, `origin_type?`, `owner_id?`
`connectwise_asio_update_site_custom_fields`	更新站点自定义字段值(写操作)	`site_id`, `body`
`connectwise_asio_get_device_custom_fields`	查设备自定义字段值	`endpoint_id`, `attribute_ids?`, `with_defaults?`, `origin_type?`, `owner_id?`
`connectwise_asio_update_device_custom_fields`	更新设备自定义字段值(写操作)	`endpoint_id`, `body`

Devices & Network Devices (18)

Tool	功能	参数
`connectwise_asio_list_endpoints`	按分类列出设备	`category`("platform"/"network"/"cloud"/"all"), `resource_type`, `resources`, `limit=50`, `cursor=0`, `sort_by?`, `field?`, `filter?`
`connectwise_asio_get_endpoint`	查设备详情	`company_id`, `site_id`, `endpoint_id`, `field?`
`connectwise_asio_get_endpoint_services`	查设备上运行的服务	`company_id`, `site_id`, `endpoint_id`, `service_name?`, `field?`
`connectwise_asio_get_endpoint_applications`	批量查设备已装应用	`resource_type`, `resources`, `limit=50`, `cursor=0`, `field?`, `name?`, `version?`
`connectwise_asio_get_endpoint_system_state`	查设备系统状态信息	`endpoint_id`
`connectwise_asio_get_hypervisor_hosts`	查受监控的 VMware 宿主机	无
`connectwise_asio_get_device_id_mapping`	查 publicID/privateID 映射	`mapping_type`("public"/"private"), `filter`
`connectwise_asio_get_unique_services`	查全部唯一服务名	无
`connectwise_asio_get_endpoint_disk_usage`	查设备最新磁盘使用率	`endpoint_id`
`connectwise_asio_get_endpoint_memory_usage`	查设备最新内存使用率	`endpoint_id`, `minute?`
`connectwise_asio_get_endpoint_cpu_usage`	查设备最新 CPU 使用率	`endpoint_id`
`connectwise_asio_uninstall_endpoints`	⚠️批量卸载设备代理(危险写操作)	`endpoints`, `reason?`, `feedback?`
`connectwise_asio_get_endpoint_heartbeat`	查设备在线/离线状态	`resource_type`("clients"/"sites"/"endpoints"), `resources`, `offline_lookback?`, `availability?`
`connectwise_asio_update_endpoint_friendly_name`	修改设备显示名(写操作)	`company_id`, `site_id`, `endpoint_id`, `friendly_name`
`connectwise_asio_get_device_groups`	列出设备分组	无
`connectwise_asio_create_network_device`	新建网络设备记录(写操作)	`company_id`, `site_id`, `body`
`connectwise_asio_update_network_device`	更新网络设备记录(写操作)	`company_id`, `site_id`, `endpoint_id`, `body`
`connectwise_asio_delete_network_device`	删除网络设备记录(写操作)	`company_id`, `site_id`, `endpoint_id`, `device_id`

Policy, Policy Group & Package (11)

Tool	功能	参数
`connectwise_asio_get_policies`	列出全部策略	无
`connectwise_asio_get_policy`	按 ID 查策略	`policy_id`
`connectwise_asio_get_policy_categories`	查策略分类/子分类	`target_type?`
`connectwise_asio_get_policy_assignments`	查策略的分配情况	`policy_id`
`connectwise_asio_get_effective_policy`	查设备的生效策略	`client_id`, `site_id`, `endpoint_id`
`connectwise_asio_get_effective_policy_override`	查设备生效策略的覆盖项	`client_id`, `site_id`, `endpoint_id`
`connectwise_asio_get_policy_groups`	列出策略组	无
`connectwise_asio_get_policy_group`	按 ID 查策略组	`group_id`
`connectwise_asio_get_packages`	列出全部安装包	无
`connectwise_asio_get_package`	按 ID 查安装包	`package_id`
`connectwise_asio_get_package_assignments`	查安装包的分配情况	`package_id`

Patching — OS & Third-Party (6)

Tool	功能	参数
`connectwise_asio_get_endpoint_patches`	查设备补丁列表	`endpoint_id`
`connectwise_asio_get_os_patch_compliance_summary`	批量查 OS 补丁合规汇总	`resource_type`, `resources`, `limit=50`, `cursor=0`, `field?`
`connectwise_asio_get_os_patch_details`	批量查 OS 补丁详情	`resource_type`, `resources`, `field?`
`connectwise_asio_get_os_patch_inventory`	查合作伙伴补丁库存	`field?`
`connectwise_asio_get_third_party_patch_compliance_summary`	批量查第三方补丁合规汇总	`resource_type`, `resources`, `limit=500`, `cursor=0`, `field?`
`connectwise_asio_get_third_party_patch_details`	批量查第三方补丁详情	`resource_type`, `resources`, `limit=500`, `cursor=0`, `field?`

Tickets (24)

Tool	功能	参数
`connectwise_asio_get_ticket_categories`	列出工单分类	无
`connectwise_asio_get_ticket_priorities`	列出工单优先级	无
`connectwise_asio_get_service_boards`	列出服务看板	`company_id?`, `site_id?`, `type_id?`
`connectwise_asio_get_service_board_teams`	查看板关联团队	`board_id`
`connectwise_asio_get_ticket_sources`	列出工单来源	无
`connectwise_asio_get_ticket_statuses`	列出工单状态	无
`connectwise_asio_get_ticket_tags`	列出工单标签	无
`connectwise_asio_create_ticket_tag`	新建工单标签(写操作)	`name`
`connectwise_asio_get_ticket_tag`	按 ID 查标签	`tag_id`
`connectwise_asio_replace_ticket_tag`	替换标签(写操作)	`tag_id`, `name`
`connectwise_asio_update_ticket_tag`	JSON Patch 更新标签(写操作)	`tag_id`, `patch_operations`
`connectwise_asio_delete_ticket_tag`	删除标签(写操作)	`tag_id`
`connectwise_asio_get_ticket_counts`	查工单计数	无
`connectwise_asio_get_ticket_notes`	查工单备注列表	`ticket_id`, `detail?`, `extended_attribute_ids?`, `visibility?`, `created_by?`, `created_at_to?`
`connectwise_asio_create_ticket_note`	新建工单备注(写操作)	`ticket_id`, `detail`, `visibility`, `extended_attributes?`
`connectwise_asio_get_ticket_note`	按 ID 查备注	`ticket_id`, `note_id`
`connectwise_asio_replace_ticket_note`	替换备注(写操作)	`ticket_id`, `note_id`, `detail`, `visibility`, `extended_attributes?`
`connectwise_asio_update_ticket_note`	JSON Patch 更新备注(写操作)	`ticket_id`, `note_id`, `patch_operations`
`connectwise_asio_get_ticket_types`	列出工单类型	`entity?`
`connectwise_asio_get_tickets`	多条件搜索工单	30+ 个可选过滤参数(见工具 docstring),如 `company_ids`, `status_names`, `created_at_from/to` 等
`connectwise_asio_create_ticket`	新建工单(写操作)	`description`, `summary`, `service_board`, `source`, `extra?`(其余字段)
`connectwise_asio_get_ticket`	按 ID 查工单	`ticket_id`
`connectwise_asio_replace_ticket`	替换工单(写操作)	`ticket_id`, `description`, `summary`, `service_board`, `source`, `extra?`
`connectwise_asio_update_ticket`	JSON Patch 更新工单(写操作)	`ticket_id`, `patch_operations`

Alerting & Incidents (4)

Tool	功能	参数
`connectwise_asio_create_alerts`	批量创建告警(写操作)	`alerts`
`connectwise_asio_update_alerts`	批量更新告警(写操作)	`alerts`
`connectwise_asio_delete_alerts`	批量删除告警(写操作)	`alerts`
`connectwise_asio_post_incident_alerts`	上报/更新安全事件告警详情(写操作)	`incidents`

Mapping (8)

Tool	功能	参数
`connectwise_asio_lookup_mappings`	按 schema 查属性映射	`schemas`, `criteria`, `all?`
`connectwise_asio_get_site_endpoint_mappings`	查站点的集成商设备映射	`company_id`, `site_id`
`connectwise_asio_create_site_endpoint_mappings`	新建/更新站点设备映射(写操作)	`company_id`, `site_id`, `mappings`
`connectwise_asio_replace_site_endpoint_mappings`	全量替换站点设备映射(写操作)	`company_id`, `site_id`, `mappings`
`connectwise_asio_delete_site_endpoint_mappings`	删除站点全部设备映射(写操作)	`company_id`, `site_id`
`connectwise_asio_delete_site_endpoint_mapping`	删除单个设备映射(写操作)	`company_id`, `site_id`, `endpoint_id`
`connectwise_asio_get_partner_endpoint_mappings`	查合作伙伴全部设备映射	无
`connectwise_asio_get_site_mappings`	查站点映射列表	无

Automation (3)

Tool	功能	参数
`connectwise_asio_get_scripts`	列出自动化脚本	无
`connectwise_asio_get_shell_scripts`	列出 Shell 脚本	无
`connectwise_asio_get_automation_tasks`	列出自动化任务	无

Backup Dashboard (4)

Tool	功能	参数
`connectwise_asio_resolve_alarm`	关闭备份告警(写操作)	`company_id`, `site_id`, `alarm_id`, `vendor_device_id`
`connectwise_asio_create_alarm_record`	上报备份告警记录(写操作)	`company_id`, `site_id`, `alarms`, `family`, `severity`, `type`
`connectwise_asio_create_dr_readiness_record`	上报灾备就绪验证记录(写操作)	`company_id`, `site_id`, `id`, `devices`, `triggered_by`, `backup_job_id?`, `backup_name?`
`connectwise_asio_create_backup_record`	上报备份运行记录(写操作)	`company_id`, `site_id`, `backup_job_id`, `backup_job_name`, `devices`, `job_type`, `managed_by`, `appliance_id?`, `appliance_name?`

Misc (2)

Tool	功能	参数
`connectwise_asio_upload_product_usage`	上传厂商产品用量记录(计费,写操作)	`usage_records`
`connectwise_asio_get_rate_limits`	查当前 API 速率限制状态	无

测试示例 (Test Example)

Get a company list, then its sites:

{
  "method": "tools/call",
  "params": { "name": "connectwise_asio_get_companies", "arguments": {} }
}

Equivalent curl against the running server (streamable HTTP MCP endpoint):

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "X-ConnectWise-Asio-Token: <access_token>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "connectwise_asio_get_companies", "arguments": {} }
  }'

A parameterized call:

{
  "method": "tools/call",
  "params": {
    "name": "connectwise_asio_get_endpoint_cpu_usage",
    "arguments": { "endpoint_id": "abc-123" }
  }
}

API Reference

Official docs (ConnectWise Developer Network — requires login): Products > ConnectWise Platform > Platform Vendors > APIs and Callbacks > REST API
Base URLs: NA https://openapi.service.itsupport247.net, EU https://openapi.service.euplatform.connectwise.com, AU https://openapi.service.auplatform.connectwise.com

Known Gaps / Not Yet Verified

Not yet tested against a live ConnectWise Asio account — only protocol-level verification (health check, 401 on missing token, tools/list returning all 104 tools) has been done so far.
Several request bodies with deeply nested schemas (e.g. Company, Contact, Ticket, NetworkDevice) are exposed as a generic body: dict / extra: dict parameter rather than fully flattened named arguments — the docstring lists the required top-level fields, but nested object shapes should be cross-checked against the live API on first use.
connectwise_asio_uninstall_endpoints is destructive (removes RMM agents) — do not call against production data without explicit confirmation for each device.

This server cannot be installed

license - not tested

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/MSPbotsAI/connectwise-asio-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server