Docs · Developers & AI assistants

Modus MCP Connector

Last Updated: September 19, 2026

Modus is the sales system for gyms, studios and athletic-training businesses. The connector lets an AI assistant work with a business's Modus workspace to acquire new prospects, convert leads into customers and understand what's driving sales. The assistant does the reasoning; Modus supplies the data and the actions.

Understand

Headline numbers, the sales funnel, which lead sources and ad campaigns produce customers, and who the best customers are.

Convert

Who to follow up with today, who went quiet, unconfirmed appointments and open times. Texts are drafted and sent only after the owner approves them; assessments can be booked, moved and cancelled once the user confirms.

Acquire

Search the athletes a business already has by school, sport and grade, and find new youth-athlete prospects in its area.


Connecting

MCP endpointhttps://connect.himodus.com/mcp (Streamable HTTP)
Protocol versions2026-07-28, plus 2025-11-25, 2025-06-18 and 2025-03-26 for clients that open with initialize. Stateless: no sessions, no server-initiated requests; every response is a single JSON object.
AuthorizationOAuth 2.1 authorization code with PKCE (S256 only), discovered through WWW-Authenticate on a 401 response.
Resource metadata/.well-known/oauth-protected-resource/mcp (RFC 9728)
Authorization server metadata/.well-known/oauth-authorization-server (RFC 8414)
Client registrationClient ID Metadata Documents (preferred), Dynamic Client Registration at /oauth/register (RFC 7591), or a pre-registered client ID on request.
TokensOpaque bearer tokens bound to the MCP resource (RFC 8707). Access tokens last 1 hour. Refresh tokens (for clients registered for them) last 30 days and rotate on every use; a reused refresh token revokes the whole grant. Every grant ends 90 days after sign-in. Revocation is at /oauth/revoke (RFC 7009).
Scopesmodus.read: reports, leads, appointments and conversations, plus drafting messages.
modus.act: send owner-approved text messages. Requested separately, only granted to verified apps, and step-up is supported (HTTP 403 insufficient_scope).

The user signs in with their Modus username and password. Owner/admin accounts can connect; staff accounts can't by default. Each connection only sees the workspace of the person who signed in.

Tools

ToolWhat it does
get_workspace_overviewThe business, its programs, how much data it holds and which capabilities are on for this connection. A good first call when planning a multi-step goal.
get_business_snapshotLeads, bookings, sales and estimated recurring revenue for a period, with booking and close rates, compared with the previous period (like-for-like while a period is still in progress).
get_funnelLead → contacted → booked → attended → bought, with the conversion at each step and the weakest step called out. Can be split by source, program, trainer or ad campaign.
get_lead_source_performanceWhich sources, Facebook campaigns and ad sets turn leads into customers and revenue, not just leads.
get_best_customer_profileHow buyers differ from everyone who enquires (sport, grade, school, source, program), and how long a sale takes.
get_follow_up_prioritiesA ranked list of people most worth contacting now, each with the reason (for example, replied and waiting, assessed but not bought, missed an appointment, went quiet).
find_leadsSearch the pipeline by follow-up situation, stage, source, program and dates.
get_leadOne person's stage, bookings and recent conversation. Lead-written text is marked as untrusted content.
list_upcoming_appointmentsAssessments in the next N days, flagged by whether the person has replied since booking.
get_open_assessment_slotsOpen assessment days and times from the business's booking calendar.
draft_follow_upwrites a draft onlyPrepares personalised texts for up to 25 people and checks each against the contact rules. Sends nothing. Returns the exact messages and, where sending is on, a link for the owner to approve them in Modus.
send_follow_upmodus.actSends a batch the owner approved in Modus, exactly as approved, once. Only available where sending is turned on for the workspace.
book_appointmentmodus.actBooks a first appointment (assessment / consultation) for one person at a time the user has approved. Where the workspace has a booking calendar, it books there and starts the business's usual reminder texts, exactly as booking by hand in Modus does.
move_appointmentmodus.actMoves someone's upcoming assessment to another open time, after the user confirms.
cancel_appointmentmodus.actCancels someone's upcoming assessment after the user confirms. The person isn't told automatically; the assistant offers to draft them a message.
search_athletesSearches the athletes already in the business's Modus database by school (loosely matched), sport, grade, position or name, and shows who has already been contacted, booked or signed up.
find_prospectsif enabledFinds high-school athletes for a sport on public school rosters in the business's area, for the user to review. Adds no one to the pipeline and contacts no one.

Example requests

Messaging safeguards

Only one tool, send_follow_up, can reach a person. It works only when all of these are true:

Drafted messages can't contain links, web or email addresses, or phone numbers. The assistant never sees or supplies phone numbers; recipients are identified by Modus IDs. Opt-outs apply per person, across every conversation with that number. See the SMS section of our Privacy Policy.

Calendar safeguards

Booking, moving and cancelling appointments work the same way as messaging: the assistant must show the user the person and the exact time, then pass confirm: true. Beyond that:

Data & security

How Modus collects, uses and protects personal data is described in our Privacy Policy; use of Modus is governed by our Terms & Conditions.

Access requirements

Disconnecting

Disconnect Modus in the assistant, or ask Modus to revoke every connection for a workspace. Resetting a Modus password ends every connection that person made, and deactivating a staff member cuts off their connections on the very next request.

Contact

Questions, access requests or security reports: hello@himodus.com.

Connect your AI assistant to Modus

Don't have a Modus workspace yet? Request access and we'll set you up. Already a customer? Add connect.himodus.com/mcp as a connector in your assistant and sign in.

Request access Email us