AI assistants through MCP
In-app assistants, external assistants and partners use the same Gym Master tools. Each user signs in and grants their own access.
Connect
https://mcp.gymmaster.vn/mcp
Sandbox: https://mcp-dev.gymmaster.vn/mcp
Paste the URL and sign in with OAuth. Select the workspace and scopes. Do not use a shared workspace API key.
Paste the URL and sign in with OAuth. Select the workspace and scopes. Do not use a shared workspace API key.
{
"url": "https://mcp.gymmaster.vn/mcp",
"transport": "streamable-http"
}Assistant scopes
gym:read·crm:read: read gym or customer data within the user’s permissions.gym:export·crm:export: propose a report or list export and return an in-app confirmation link.gym:write·crm:write: run a preview and create a proposal; the assistant cannot execute it.
Effective access is the intersection of OAuth scopes and actual user permissions. A user with view_own only sees their own records. An AI package does not give staff additional permissions.
Confirm in Gym Master
Write tools return dryRun=true, executed=false and a confirmation link. Sign in with the same account and workspace. Review the saved proposal and select Confirm. Proposals expire in 15 minutes and can be consumed once. Opening a link executes nothing.
Reads and exports require AI Read or AI Do; write proposals require AI Do. Consent and package access are checked both at tool invocation and at confirmation.
Creating receipts, renewing contracts, collecting debts and paying commissions are unavailable.
Tools
Call gym_tool_catalog or crm_tool_catalog for current schemas. Call each tool with {args:{...}} according to its schema. Includes NET revenue, error explanations, named report exports, sales, retention and commission queries.
call_agents_searchcall_call_flows_searchcall_calls_searchcall_campaigns_searchcall_ivr_flows_searchcall_phone_numbers_searchcall_queues_searchads_catalogads_readcomm_add_ai_bot_qacomm_ads_changecomm_agents_performancecomm_assign_to_mecomm_bot_statscomm_channels_statuscomm_close_conversationcomm_conversations_searchcomm_create_ai_botcomm_inbox_breakdowncomm_messages_getcomm_messages_volumecomm_sales_pipelinecomm_update_ai_botcrm_add_notecrm_add_tagcrm_appointments_querycrm_assign_ownercrm_contacts_activitycrm_contacts_carecrm_contacts_exportcrm_contacts_querycrm_contracts_searchcrm_create_appointmentcrm_create_contract_from_quotationcrm_create_leadcrm_create_opportunitycrm_create_quotationcrm_create_taskcrm_move_opportunity_stagecrm_opportunities_exportcrm_opportunities_querycrm_products_searchcrm_quotation_templates_listcrm_quotations_searchcrm_remove_tagcrm_reports_ads_exportcrm_reports_ads_querycrm_reports_analytics_querycrm_reports_call_outcome_exportcrm_reports_call_outcome_querycrm_reports_campaign_querycrm_reports_care_dashboard_querycrm_reports_care_tasks_exportcrm_reports_care_tasks_querycrm_reports_contact_querycrm_reports_contracts_exportcrm_reports_contracts_querycrm_reports_conversations_exportcrm_reports_conversations_querycrm_reports_customers_exportcrm_reports_customers_querycrm_reports_exportcrm_reports_forecast_querycrm_reports_journey_exportcrm_reports_journey_querycrm_reports_kpi_querycrm_reports_lead_querycrm_reports_lead_source_exportcrm_reports_lead_source_querycrm_reports_lead_speed_exportcrm_reports_lead_speed_querycrm_reports_multi_module_exportcrm_reports_multi_module_querycrm_reports_opportunity_querycrm_reports_pipeline_campaign_querycrm_reports_pipeline_exportcrm_reports_pipeline_querycrm_reports_querycrm_reports_quotations_exportcrm_reports_quotations_querycrm_reports_reconciliation_exportcrm_reports_reconciliation_querycrm_reports_retention_exportcrm_reports_retention_querycrm_reports_satisfaction_exportcrm_reports_satisfaction_querycrm_reports_support_exportcrm_reports_support_querycrm_reports_survey_querycrm_reports_team_activity_exportcrm_reports_team_activity_querycrm_reports_win_loss_exportcrm_reports_win_loss_querycrm_sales_process_alertscrm_sales_process_casecrm_sales_process_case_actioncrm_sales_process_createcrm_sales_process_disablecrm_sales_process_enablecrm_sales_process_getcrm_sales_process_listcrm_sales_process_patchcrm_sales_process_paymentscrm_sales_process_runscrm_sales_process_simulatecrm_sales_process_templatescrm_sales_process_todaycrm_sales_process_validatecrm_sales_process_workspacecrm_select_quotation_print_templatecrm_send_quotation_emailcrm_set_lifecyclecrm_tasks_querycrm_tickets_querycrm_workspace_summarydms_catalog_products_searchdms_checkins_searchdms_daily_plans_getdms_daily_plans_searchdms_orders_searchdms_outlets_searchdms_routes_searchdms_van_inventory_getdms_van_inventory_low_stockdms_van_load_historyeinvoice_invoices_geteinvoice_invoices_searcheinvoice_reports_summaryeinvoice_series_listeinvoice_settings_listgym_book_classgym_book_pt_sessiongym_checkins_querygym_classbookings_querygym_classes_searchgym_commissions_querygym_contracts_exportgym_contracts_querygym_create_packagegym_devices_statusgym_errors_explaingym_freeze_contractgym_lockers_reportgym_loyalty_reportgym_manual_checkingym_member_changesgym_member_historygym_members_exportgym_members_querygym_print_contractgym_print_ticketgym_ptsessions_querygym_register_membergym_reports_access_querygym_reports_allocation_querygym_reports_branch_querygym_reports_business_querygym_reports_checkin_by_period_querygym_reports_checkin_detail_querygym_reports_churn_querygym_reports_churn_risk_querygym_reports_class_pt_querygym_reports_customer_analytics_querygym_reports_debt_querygym_reports_exportgym_reports_fund_querygym_reports_goal_outcomes_querygym_reports_goal_progress_querygym_reports_kpi_querygym_reports_lead_funnel_querygym_reports_loyalty_querygym_reports_members_querygym_reports_progress_querygym_reports_pt_commission_querygym_reports_pt_training_querygym_reports_registrations_querygym_reports_remaining_querygym_reports_rental_querygym_reports_revenue_breakdown_querygym_reports_revenue_by_service_querygym_reports_service_frequency_querygym_reports_tickets_querygym_retention_reportgym_revenue_reportgym_sales_reportgym_summary_reportgym_unfreeze_contracthrm_attendance_devices_listhrm_clock_history_dailyhrm_clock_history_timelinehrm_contracts_expiringhrm_employee_credentials_listhrm_employees_gethrm_employees_searchhrm_inbox_listhrm_insurance_summaryhrm_me_clock_todayhrm_me_contractshrm_me_payslipshrm_me_requestshrm_me_summaryhrm_onboarding_listhrm_org_unitshrm_performance_meetingshrm_raw_punches_searchhrm_recruitment_listhrm_report_attendancehrm_report_overtimehrm_training_courseshrm_training_learnerhrm.correction.submithrm.inbox.approvehrm.inbox.rejecthrm.leave.submithrm.onboarding.tickhrm.overtime.submithrm.training.completemarketing_activate_workflowmarketing_automation_catalogmarketing_check_graphmarketing_create_web_formmarketing_create_workflow_from_graphmarketing_delete_landingmarketing_email_campaigns_getmarketing_email_campaigns_searchmarketing_email_templates_searchmarketing_get_workflow_statsmarketing_integrations_listmarketing_list_landing_pagesmarketing_list_web_formsmarketing_list_workflow_templatesmarketing_list_workflowsmarketing_pause_workflowmarketing_publish_landingmarketing_reports_overviewmarketing_save_landing_draftmarketing_sender_profiles_listmarketing_unpublish_landingmarketing_update_web_formmarketing_update_workflow_graphmarketing_zns_templates_searchget_my_recent_mailoffice_activate_automationoffice_add_checklist_itemoffice_add_task_commentoffice_approve_approval_taskoffice_approve_taskoffice_automation_catalogoffice_cancel_eventoffice_check_graphoffice_create_approval_instanceoffice_create_automation_from_graphoffice_create_eventoffice_create_recordoffice_create_taskoffice_create_task_from_chatoffice_create_task_listoffice_delete_recordoffice_delete_taskoffice_get_approval_instanceoffice_get_recordoffice_list_approval_instancesoffice_list_automationsoffice_list_my_calendaroffice_list_recordsoffice_list_stuck_tasksoffice_list_tasksoffice_pause_automationoffice_read_group_chatoffice_reject_approval_taskoffice_restore_taskoffice_return_taskoffice_simulate_automationoffice_transfer_approval_taskoffice_update_automation_graphoffice_update_eventoffice_update_recordoffice_update_taskpayment_intents_getpayment_refunds_searchpayment_reports_overviewpayment_subscriptions_searchpayment_transactions_getpayment_transactions_searchsales_customers_searchsales_orders_getsales_orders_searchsales_products_searchsales_products_stockTroubleshooting
401: sign in again. insufficient_scope: grant the required scope; actual user permissions must still allow it. ai.package_missing: the workspace lacks AI Read/AI Do or consent expired. Confirmation is blocked if the package is withdrawn after a proposal was created.