How do I use ubcab-bo-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., "@ubcab-bo-mcp find driver by phone 99054120" 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.

ubcab-bo-mcp

by naranmunkh

Overview Schema Related Servers Score Discussions

JavaScript

Hybrid

ubcab-bo-mcp

MCP server for the UBCab Backoffice (registration-bo) API — the same backend that powers operator.ubcab.mn. Lets Claude search drivers, read driver detail and rating, change driver state, and list service options.

Built on the same pattern as timely-mcp: a single self-contained api/index.ts (the Vercel serverless function) that runs over Streamable HTTP on Vercel (bearer + OAuth 2.1 PKCE) or over stdio locally.

Live endpoint: https://bo-mcp.vercel.app/mcp (POST, Bearer auth). Verified: GET /health → {"status":"ok"}.

Auth

The BO uses Keycloak SSO (realm ubcab-bo, client ubcab-registration-bo). The server gets an access token from https://sso.ubcabtech.com/realms/ubcab-bo/protocol/openid-connect/token:

password grant — set UBCAB_BO_USERNAME + UBCAB_BO_PASSWORD (recommended; durable).
refresh_token grant — set UBCAB_BO_REFRESH_TOKEN (use if password grant is disabled; expires).

Access tokens are short-lived (~5 min); the server caches and silently re-auths. Every API call also sends Origin/Referer = operator.ubcab.mn.

Related MCP server: uptime-kuma-mcp-server

Tools

Tool	Method / Endpoint	Purpose
`ubcab_bo_driver_search`	`POST /v1/driver/drivers/list`	Жолоочийг утас/регистр/нэр/shortId-аар хайх → `_id` авах
`ubcab_bo_driver_get`	`GET /v1/driver/drivers/{driverId}`	Жолоочийн дэлгэрэнгүй (profile, vehicle, kyc…)
`ubcab_bo_driver_rating`	`GET /v1/driver/rating/{driverId}`	Жолоочийн үнэлгээ
`ubcab_bo_driver_set_state`	`PUT /v1/driver/drivers/{driverId}/state`	Төлөв солих: `normal` / `suspended` (reason ≥10 тэмдэгт)
`ubcab_bo_service_options`	`GET /v1/driver/select-options/services`	Үйлчилгээний сонголтын жагсаалт
`ubcab_bo_driver_history`	`POST /v1/activity/api/drivers/{id}/history`	Жолоочийн үйлчилгээний түүх; `phone` өгвөл зорчигчийн утсаар шүүнэ; `docs[].serviceId` → trip_get
`ubcab_bo_driver_wallet`	`GET /v1/driver/drivers/{id}/wallet`	Хэтэвчний үлдэгдэл
`ubcab_bo_driver_wallet_history`	`POST /v1/driver/drivers/{id}/wallet/history`	Хэтэвчний гүйлгээний түүх (paged; `beginDate`/`endDate`-аар шүүж сарын орлого/зарлага)
`ubcab_bo_driver_vehicles`	`GET /v1/driver/drivers/{id}/vehicles/list`	Тээврийн хэрэгслүүд
`ubcab_bo_driver_vehicle_services_update`	`PUT /v1/driver/drivers/{id}/vehicles/update`	⚠ Машины үйлчилгээ нэмэх/хасах (`approvedServices` бүтнээр дарж бичнэ)
`ubcab_bo_driver_feedback`	`POST /v1/driver/rating/{id}/list`	Сэтгэгдэл/үнэлгээний жагсаалт (paged)
`ubcab_bo_driver_loyalty_history`	`POST /v1/loyalty/driver/drivers/{id}/level-history/list`	Цолны түүх (paged)
`ubcab_bo_vehicle_inspection_get`	`GET /v1/driver/vehicle-inspections/{id}`	Техникийн үзлэгийн дэлгэрэнгүй (асуулт бүрийн хариу, result, expiresAt)
`ubcab_bo_vehicle_inspection_drivers`	`POST /v1/driver/vehicle-inspections/{id}/drivers/list`	Үзлэгт хамаарах жолоочид (paged)
`ubcab_bo_rider_search`	`POST /v1/rider/riders/list`	Хэрэглэгч (rider) хайх (body: filter.query)
`ubcab_bo_rider_history`	`POST /v1/activity/api/riders/{id}/history`	Хэрэглэгчийн аяллын түүх; `phone` өгвөл жолоочийн утсаар шүүнэ; `docs[].serviceId` → trip_get
`ubcab_bo_trip_get`	`GET /v1/taxi/api/trips/{id}`	Аяллын үндсэн бүх мэдээлэл
`ubcab_bo_trip_routes`	`GET …/{id}/routes`	Маршрут (GPS зам)
`ubcab_bo_trip_invoices`	`GET …/{id}/invoices`	Нэхэмжлэл
`ubcab_bo_trip_charges`	`GET …/{id}/charges`	Төлбөр тооцооны задаргаа
`ubcab_bo_trip_complaints`	`GET …/{id}/complaints`	Гомдол
`ubcab_bo_trip_penalties`	`GET …/{id}/penalties`	Торгууль (жагсаалт)
`ubcab_bo_trip_penalty_cancel`	`POST …/trips/{tripId}/penalties/{penaltyId}/cancel`	⚠ Торгууль цуцлах (write)
`ubcab_bo_delivery_penalty_cancel`	`POST /v1/delivery/api/trips/{tripId}/penalties/{penaltyId}/cancel`	⚠ Хүргэлтийн торгууль цуцлах
`ubcab_bo_trip_loyalty`	`GET …/{id}/loyalty`	Урамшуулал
`ubcab_express_track`	`GET express-tracking.ubcabtech.com/v1/trackings/{code}`	TEMU/чиглэлийн илгээмж хянах (нэвтрэлтгүй нийтийн API)
`ubcab_express_order_search`	`POST operator-api.ubcabexpress.mn/v1/api/address-ready-shipments/list`	UBExpress энгийн захиалга хайх (operator, client express-bo)
`ubcab_express_return_search`	`POST operator-api.ubcabexpress.mn/v1/api/ready-return-shipments/list`	UBExpress буцах захиалга хайх
`ubcab_marketing_help_group_list`	`POST marketing-bo-api…/v1/content/api/help/content-groups/list`	Гарын авлагын категорууд
`ubcab_marketing_help_group_create`	`POST …/content-groups`	⚠ Шинэ категор нэмэх (name, order)
`ubcab_marketing_help_group_get`	`GET …/content-groups/{id}`	Категорын дэлгэрэнгүй
`ubcab_marketing_help_group_delete`	`DELETE …/content-groups/{id}`	⚠ Категор устгах
`ubcab_marketing_help_group_meta`	`GET …/content-groups/meta?action=create\|get`	Формын meta
`ubcab_marketing_content_category_list`	`POST …/v1/content/api/content/categories/list`	Мэдээний (Press) ангиллууд
`ubcab_marketing_content_category_create`	`POST …/content/categories`	⚠ Шинэ мэдээний ангилал
`ubcab_marketing_content_category_get`	`GET …/content/categories/{id}`	Ангилалын дэлгэрэнгүй
`ubcab_marketing_content_category_update`	`PUT …/content/categories/{id}`	⚠ Засах
`ubcab_marketing_help_content_list`	`POST …/help/contents/list`	Тусламжийн агуулгууд (filter: slug, title)
`ubcab_marketing_help_content_create`	`POST …/help/contents`	⚠ Агуулга нэмэх (`slug`=null шинэ / slug=орчуулга)
`ubcab_marketing_help_content_get`	`GET …/help/contents/{id}`	Агуулгын дэлгэрэнгүй
`ubcab_marketing_help_content_update`	`PUT …/help/contents/{id}`	⚠ Агуулга засах
`ubcab_marketing_help_content_delete`	`DELETE …/help/contents/{id}`	⚠ Агуулга устгах
`ubcab_marketing_help_content_meta`	`GET …/help/contents/meta`	Формын meta
`ubcab_marketing_help_select_content_groups`	`GET …/help/select-options/content-groups`	Бүлгийн сонголт (`group` утга)
`ubcab_marketing_help_select_language`	`GET …/help/select-options/language`	Хэлний сонголт
`ubcab_marketing_content_list`	`POST …/content/contents/list`	Press контентууд
`ubcab_marketing_content_create`	`POST …/content/contents`	⚠ Контент нэмэх (title, cover, category, preview)
`ubcab_marketing_content_get`	`GET …/content/contents/{id}`	Дэлгэрэнгүй
`ubcab_marketing_content_update`	`PUT …/content/contents/{id}`	⚠ Засах
`ubcab_marketing_content_delete`	`DELETE …/content/contents/{id}`	⚠ Устгах
`ubcab_marketing_content_meta`	`GET …/content/contents/meta`	Формын meta
`ubcab_marketing_content_select_categories`	`GET …/content/select-options/categories`	Ангиллын сонголт (`category`)
`ubcab_marketing_upload_image`	`POST upload.ubcabtech.com/v2/upload`	Зураг байршуулах → `cover` URL
`ubcab_marketing_content_category_delete`	`DELETE …/content/categories/{id}`	⚠ Устгах
`ubcab_marketing_content_category_meta`	`GET …/content/categories/meta`	Формын meta (талбар динамик)
`ubeats_order_search`	`POST ubeats-bo-api…/v1/api/orders/list`	UBEats Cloud Kitchen захиалга хайх (filter.customerPhone)
`ubeats_order_get`	`GET …/v1/api/orders/{id}`	Cloud Kitchen захиалгын бүрэн дэлгэрэнгүй
`ubeats_order_state_histories`	`GET …/v1/api/orders/{id}/state-histories`	Cloud Kitchen төлөвийн түүх
`ubeats_merchant_order_search`	`POST …/v1/api/merchant-orders/list`	UBEats Merchant захиалга хайх
`ubeats_merchant_order_get`	`GET …/v1/api/merchant-orders/{id}`	Merchant захиалгын бүрэн дэлгэрэнгүй
`ubeats_merchant_order_state_histories`	`GET …/v1/api/merchant-orders/{id}/state-histories`	Merchant төлөвийн түүх

⚠ driver_get / trip_get return PII (name, phone, register no, civil ID). driver_set_state is a write action.

Local run (stdio)

npm install
npm run compile
cp .env.example .env   # fill UBCAB_BO_USERNAME + UBCAB_BO_PASSWORD
node --env-file=.env scripts/test-login.mjs 99054120   # live smoke test

Claude Desktop config:

{
  "mcpServers": {
    "ubcab-bo": {
      "command": "node",
      "args": ["/abs/path/to/ubcab-bo-mcp/dist/api/index.js"],
      "env": {
        "UBCAB_BO_USERNAME": "...",
        "UBCAB_BO_PASSWORD": "..."
      }
    }
  }
}

Deploy (Vercel)

Connected to GitHub (naranmunkh/bo-mcp) — every push to main auto-deploys. Zero-config: api/index.ts is auto-built as a serverless function, and vercel.json rewrites send every path (/mcp, /health, /.well-known/*) to it. There is intentionally no build script — a build script makes Vercel expect a static public/ output and the deploy fails. Local TypeScript build is npm run compile.

Required env vars on the Vercel project: UBCAB_BO_USERNAME, UBCAB_BO_PASSWORD, and UBCAB_BO_MCP_AUTH_TOKEN (openssl rand -hex 32).

Connect from Claude with Authorization: Bearer <UBCAB_BO_MCP_AUTH_TOKEN> at https://bo-mcp.vercel.app/mcp. The endpoint fails closed if UBCAB_BO_MCP_AUTH_TOKEN is unset.

Extending

Add a new endpoint by registering another tool inside createMcpServer() in api/index.ts — copy one of the existing reg(...) blocks.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityActive

ResponsivenessSyncing

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 Connectors

Artificial Wit AI
com.artificialwit
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
ERP Systems CRM Knowledge & Memory
2
mcp-server
io.klokin
MCP server exposing klokin time-tracking operations (employees, time entries, stores) to AI clients.
Workplace & Productivity Project Management
2
jumpcloud-genaiOAuth
com.jumpcloud
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Cloud Platforms Security Developer Tools
2
sendbird A
io.usefulapi
MCP server for Sendbird — chat users, channels, members, and messages from your AI client.
Communication Customer Support
142

Related MCP Servers

claude-sessions-mcp
Developer Tools File Systems App Automation
es6kr
A
license
B
quality
D
maintenance
MCP server for managing Claude Code conversation sessions
Updated 7 months ago (2026-02-07 09:25 UTC)
12
78
MIT
uptime-kuma-mcp-server
Monitoring Observability
mbay-ODW
F
license
Not graded
quality
C
maintenance
MCP server for managing self-hosted Uptime Kuma monitors and querying uptime statistics from Claude.
Updated 3 days ago (2026-09-01 10:02 UTC)
globick-mcp
Travel & Transportation Search
G5L-Ventures
F
license
Not graded
quality
C
maintenance
A local MCP server that connects the Globick activities API to Claude Desktop, enabling natural language search and filtering of the activities catalogue.
Updated 3 months ago (2026-06-12 09:41 UTC)
Upvote Club Remote MCPofficial
Project Management App Automation
upvoteclub
F
license
Not graded
quality
C
maintenance
Remote MCP server for Claude.ai to interact with Upvote Club's API, enabling task creation, status checking, and platform listing via natural language.
Updated 2 months ago (2026-07-14 09:27 UTC)
42

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/naranmunkh/bo-mcp'

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

ubcab-bo-mcp

Auth

Tools

Local run (stdio)

Deploy (Vercel)

Extending

Maintenance

Resources

Looking for Admin?

Related MCP Connectors

Related MCP Servers

claude-sessions-mcp

uptime-kuma-mcp-server

globick-mcp

Upvote Club Remote MCPofficial

Latest Blog Posts

MCP directory API