How do I use ubcab-bo-mcp?

1. Click on "Deploy 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 Source Related Servers Discussions Admin

TypeScript

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).
2FA (since 2026-10-05) — Keycloak enforces OTP on the BO realm. Set UBCAB_BO_TOTP_SECRET to the account's base32 TOTP secret (the text shown under «Unable to scan?» when setting up the authenticator). Every password grant then sends a freshly generated 6-digit totp. Without it Keycloak answers invalid_grant («Account is not fully set up» until OTP is configured, then «Invalid user credentials»). Per-client overrides: UBCAB_EXPRESS_TOTP_SECRET, UBCAB_MARKETING_TOTP_SECRET.
UBEats (ubeats_* tools) log in with the same BO login (UBCAB_BO_USERNAME / _PASSWORD / _TOTP_SECRET) against client ubeats-bo, Origin https://office.ubeats.mn. UBEATS_USERNAME / _PASSWORD / _TOTP_SECRET are only a fallback when no BO login is set. Verify the generator offline: node scripts/test-totp.mjs.

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_audit_log_list`	`POST /v1/audit-log/list`	Audit log — хэн юуг хэзээ өөрчилсөн (`target{type,_id}`)
`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_rider_invoices`	`POST /v1/rider/riders/{id}/invoices`	Хэрэглэгчийн нэхэмжлэхүүд (filter.status, ж: open)
`ubcab_bo_invoice_get`	`GET /v1/billing/api/invoices/{id}`	Нэхэмжлэхийн дэлгэрэнгүй
`ubcab_bo_service_trip_invoices`	`GET /v1/{service}/api/trips/{id}/invoices` (+ delivery requests)	Аль ч үйлчилгээний аяллын нэхэмжлэх
`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.

Is the latest build live?

Every Keycloak auth error ends with a non-secret context, for example [build 2026-10-16 bo-login+totp, client=ubeats-bo, origin=https://office.ubeats.mn, grant=password, login=UBCAB_BO_*, totp=sent]. No [build …] at all → an old deploy is still serving: the top Production deployment in Vercel must be the latest main commit ("Redeploy" on an old deployment rebuilds that old source). origin / client show what was actually sent, so a stale UBEATS_ORIGIN override is visible there.

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 deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Artificial Wit AIOAuth
com.artificialwit
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
ERP Systems CRM Knowledge & Memory
2
mcp-serverOAuth
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 MCP by usefulapi 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 8 months ago (2026-02-07 09:25 UTC)
12
50 npm
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 2 months 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 4 months ago (2026-06-12 09:41 UTC)
-
Upvote Club Remote MCPofficial
Project Management App Automation
upvoteclub
A
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 9 days ago (2026-10-12 15:15 UTC)
42
MIT

ubcab-bo-mcp

Auth

Tools

Local run (stdio)

Deploy (Vercel)

Is the latest build live?

Extending

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

claude-sessions-mcp

uptime-kuma-mcp-server

globick-mcp

Upvote Club Remote MCPofficial