How do I use bizratings-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., "@bizratings-mcp Get ticket responses from 01-Jan-2025 to 31-Mar-2025" 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.

bizratings-mcp

by MSPbotsAI

Overview Schema Related Servers Score Discussions

Python

Remote

bizratings-mcp

BizRatings MCP server — exposes the BizRatings CSAT/NPS customer-survey API (for ConnectWise partners) as MCP tools.

Overview

This server implements the Model Context Protocol (Streamable HTTP/SSE transport) and wraps the BizRatings API, which manages CSAT/NPS satisfaction surveys tied to ConnectWise tickets and projects. It follows the MSPbots Vendor MCP Service SOP: stateless, no stored credentials, per-request header authentication.

The server itself holds no credentials — the caller obtains a BizRatings OAuth2 access token and passes it per-request through a header.

Related MCP server: mcp-connectwise-psa

Quick Start

Docker (recommended)

docker compose up --build

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

Local (uv)

uv sync
python -m bizratings_mcp

Health Check

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

No token is required for the health endpoint.

授权参数说明 (Authentication)

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

Header	类型	是否必填	默认值	枚举值	字段描述	Example
`X-Bizratings-Token`	string	必填	无	无(自由文本)	BizRatings OAuth2 access token(`grant_type=client_credentials`)。由调用方(Agent Platform / 上游网关)预先换好后传入,本服务从不接触 `client_id`/`client_secret`,只透传该 Bearer token 给 BizRatings API。	`X-Bizratings-Token: <access_token>`

The token itself must be obtained by the caller via:

curl -X POST https://bizratingsidp.azurewebsites.net/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=<client_id>&client_secret=<client_secret>&scope=BRApi"

Missing or invalid tokens return 401 Unauthorized.

Environment Variables

Variable	Default	Description
`MCP_HTTP_PORT`	`8080`	Listening port
`MCP_HTTP_HOST`	`0.0.0.0`	Listening host
`BIZRATINGS_BASE_URL`	`https://api.bizratings.com`	Override if your tenant is routed through a different host

MCP Endpoint

POST http://localhost:8080/mcp

Connect your MCP client with:

Transport: http (Streamable HTTP / SSE)
Header: X-Bizratings-Token: <access_token>

Tool List

All dates use the DD-Mon-YYYY format (e.g. 15-Mar-2026) unless noted otherwise.

Tickets

Tool	功能	参数
`bizratings_get_ticket_responses`	查询工单满意度调查结果(分页)	`member_name?`, `filter_by="CompanyName"`, `keyword?`, `review_type=0`, `score=0`, `start_date`, `end_date`, `current_page=1`, `page_size=20`
`bizratings_get_ticket`	按工单号查单条调查结果	`ticket_no` (必填, int)
`bizratings_create_ticket`	推送已关闭工单触发满意度调查邮件(写操作,有副作用)	`ticket_id`, `ticket_title`, `company_rec_id`, `company_name`, `contact_rec_id`, `contact_name`, `contact_email`, `ticket_created_on`, `ticket_closed_on`, `ticket_updated_on` (均必填,均为 ISO 8601), `board_name?`, `resource?`
`bizratings_get_ticket_summary`	工单调查汇总统计	`member_name?`, `filter_by="CompanyName"`, `keyword?`, `review_type=0`, `start_date`, `end_date`

Surveys(项目 / 多站点 / 专项问卷)

Tool	功能	参数
`bizratings_get_project_responses`	项目类调查结果	`filter_by="CompanyName"`, `keyword?`, `review_type=0`, `start_date`, `end_date`, `current_page=1`, `page_size=20`
`bizratings_get_multisite_responses`	跨站点合并工单调查结果	`member_name?`, `filter_by="CompanyName"`, `keyword?`, `review_type=0`, `score=0`, `start_date`, `end_date`, `current_page=1`, `page_size=20`
`bizratings_get_multisite_employee_rating`	跨站点员工评分	`start_date`, `end_date`, `current_page=1`, `page_size=20`
`bizratings_get_five_question_survey_detail`	5问卷详情	`start_date`, `end_date`, `current_page=1`, `page_size=20`
`bizratings_get_employee_survey_detail`	员工调查详情	`start_date`, `end_date`, `current_page=1`, `page_size=20`

Stats

Tool	功能	参数
`bizratings_get_response_summary`	按 view_type 统计 CSAT/NPS 响应数	`start_date`, `end_date`, `view_type="Monthly"`, `source="CSAT"`
`bizratings_get_client_responses`	按客户维度统计	`filter_by="CompanyName"`, `keyword?`, `start_date`, `end_date`, `current_page=1`, `page_size=20`
`bizratings_get_employee_responses`	按员工维度统计	`company_name?`, `start_date`, `end_date`, `current_page=1`, `page_size=20`
`bizratings_get_quarterly_responses`	季度盈利明细统计	无参数
`bizratings_get_quarterly_summary`	季度盈利汇总统计	无参数

测试示例 (Test Example)

Call bizratings_get_ticket_responses for the last quarter's high scores only:

{
  "method": "tools/call",
  "params": {
    "name": "bizratings_get_ticket_responses",
    "arguments": {
      "start_date": "01-Jan-2026",
      "end_date": "31-Mar-2026",
      "current_page": 1,
      "page_size": 10
    }
  }
}

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

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "X-Bizratings-Token: <access_token>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "bizratings_get_ticket_responses",
      "arguments": { "start_date": "01-Jan-2026", "end_date": "31-Mar-2026", "page_size": 10 }
    }
  }'

Expected shape of a successful result (fields abbreviated):

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"tickets\": [ { \"ticketID\": 12345, \"companyName\": \"Acme Corp\", \"score\": 9, ... } ],\n  \"totalCount\": 42\n}"
    }
  ]
}

API Reference

BizRatings Swagger UI

This server cannot be installed

license - permissive license

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.

Related MCP Servers

N-central MCP Server
Monitoring Networking & Infrastructure
theonlytruebigmac
A
license
B
quality
B
maintenance
Exposes N-able N-central REST API as MCP tools for managing devices, organizations, users, and more, with support for read-only, write, and full write modes.
Updated 13 days ago (2026-08-01 06:15 UTC)
82
5
MIT
mcp-connectwise-psa
Customer Support CRM
mspstack
A
license
-
quality
A
maintenance
MCP server for ConnectWise PSA (Manage) enabling ticket management, time entry, and read-only lookups of companies, contacts, and configurations with role-based access control and bring-your-own-API-keys support.
Updated 4 days ago (2026-08-10 12:38 UTC)
143
4
MIT
connectwise-asio-mcp
Monitoring Customer Support Networking & Infrastructure
MSPbotsAI
A
license
-
quality
C
maintenance
Exposes ConnectWise Platform APIs as MCP tools, enabling management of companies, contacts, devices, policies, patches, and tickets through natural language.
Updated 11 days ago (2026-08-04 02:56 UTC)
Apache 2.0
cloudradial-mcp
CRM Customer Support
MSPbotsAI
F
license
-
quality
C
maintenance
Exposes the CloudRadial REST API (client portal / PSA-adjacent MSP platform) as MCP tools, enabling operations on companies, articles, feedback, archives, flexible assets, and more via 34 tools with HTTP Basic Auth.
Updated 11 days ago (2026-08-04 03:15 UTC)

View all related MCP servers

Related MCP Connectors

CryptoCultCurt-appfolio-mcp-server
Provide seamless access to Appfolio Property Manager Reporting API through a standardized MCP serv…
DATPAQ
34 production API tools over one hosted MCP endpoint.
CodeQR
Create and manage CodeQR short links, QR codes, and analytics from any MCP client.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
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

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/bizratings-mcp'

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

bizratings-mcp

Overview

Quick Start

Docker (recommended)

Local (uv)

Health Check

授权参数说明 (Authentication)

Environment Variables

MCP Endpoint

Tool List

Tickets

Surveys(项目 / 多站点 / 专项问卷)

Stats

测试示例 (Test Example)

API Reference

Maintenance

Resources

Looking for Admin?

Related MCP Servers

N-central MCP Server

mcp-connectwise-psa

connectwise-asio-mcp

cloudradial-mcp

Related MCP Connectors

Latest Blog Posts

MCP directory API