Connect AI tools to your organization with MCP
Connect AI tools to your organization with MCP
The MCP integration lets AI assistants — Claude, ChatGPT, Claude Desktop, and Cursor — connect directly to your upcoach organization. Once connected, they can build programs, post to your programs, pull progress reports, and look up participant data through natural conversation.
You connect once, authorize access, and the AI can use the tools listed under Available tools on your behalf.
Works with any MCP client that supports remote servers with OAuth (streamable HTTP).
Before you begin
- Only an organization Owner, Admin or Implementation Admin can connect. Program-level roles, such as a Program Admin or Program Facilitator, see “The upcoach connector needs an organization Owner, Admin or Implementation Admin. Ask one of them to connect it, or to give you one of these roles in Admin Area > Users.” on the authorization page, and nothing is connected
- You need an account with at least one supported AI tool (Claude, ChatGPT, Claude Desktop, or Cursor)
Find your connection details
- Open Admin Area > Integrations > MCP from the sidebar
The page shows two values you’ll need during setup:
- Server Name — your organization’s MCP server identifier (formatted as “upcoach MCP - Your Organization Name”)
- Server URL — the endpoint your AI tool connects to
Click Copy next to either value to copy it to your clipboard.
Use your workspace’s own URL, https://<your-workspace>.upcoach.com/s/mcp/admin (copy it from Admin Area > Integrations > MCP).
If an AI tool is connected to
https://v3.upcoach.com/s/mcp/admininstead, it opens the one workspace where you’re an admin. If you’re an admin of several workspaces, the AI tool shows each workspace’s own URL so you can connect with the one you want.
Connect Claude
Custom connectors work on every Claude plan, including Free, where you can add one custom connector. On Team and Enterprise, an organization Owner adds it under Organization settings > Connectors; members then open Customize > Connectors and click Connect next to upcoach.
- In Claude, open Customize and select Connectors
- Click + Add, then Add custom connector. Enter “upcoach” as the name, paste your MCP server URL, and click Add
- A browser window will open showing the upcoach authorization page. Click Authorize to grant Claude access to your organization
- Your connector is ready. In any conversation, Claude can now create programs, check progress reports, and design programs for your organization
Connect ChatGPT
Custom MCP connections in ChatGPT are available on Business, Enterprise, and Edu (ChatGPT on the web), where a workspace admin or owner adds and publishes them; on Enterprise and Edu, admins can also let members connect them. On Pro, you can connect with read-only access, so tools that create or change things won’t run.
- In ChatGPT on the web, go to Plugins, select the plus button, then Add custom MCP server
- Enter “upcoach” as the name, paste your MCP server URL under Connection, and choose OAuth for authentication
- Review the risk warning, select I understand and want to continue, then select Create as a plugin
- A browser window will open showing the upcoach authorization page. Click Authorize to grant access to your organization
Connect Claude Desktop
Claude Desktop uses the same connectors as your Claude account. If you already added upcoach on claude.ai, it’s ready in Claude Desktop when you sign in with the same account. Otherwise, add it in Claude Desktop with the same steps as in Connect Claude: Customize > Connectors, then + Add > Add custom connector.
Connect Cursor
-
Create or open
~/.cursor/mcp.jsonto connect upcoach in all your projects, or.cursor/mcp.jsonin a project to connect it there only -
Add upcoach under
mcpServers, with your MCP server URL, and save the file:{ "mcpServers": { "upcoach": { "url": "https://<your-workspace>.upcoach.com/s/mcp/admin" } } } -
Cursor lists upcoach under Customize in the sidebar. When Cursor asks you to sign in, continue with OAuth. A browser window will open showing the upcoach authorization page. Click Authorize to grant access to your organization
-
Cursor uses the upcoach tools in your conversations whenever they’re relevant
Authorization and security
When you first connect any AI tool, you’ll be asked to authorize it through a secure OAuth flow. The AI tool never sees your upcoach password — it receives a token that grants access only to the tools listed below, acting as you in your organization. The authorization page names the workspace you’re connecting and what the AI tool will be able to do there, including what reaches other people as you: invitations, posts, channel messages and event notifications. You authorize once per tool.
The access stays in place for up to a year. Most AI tools renew it on their own while you keep using them, so you rarely need to authorize again. If a tool asks you to sign in again, connect it the same way you did the first time.
Disconnect an AI tool
- Click your avatar and select Your Profile
- Open the Account tab
- Scroll to Connected apps
- Click Disconnect next to the AI tool, then click Disconnect again to confirm
The AI tool loses access at once. To use it with upcoach again, connect it again.
What the AI tool can’t do
The AI tool can’t:
- publish, rename or delete a program
- work with offers, payments or checkout
- upload files (it can use files already uploaded in upcoach)
- read your feed, channel messages or direct messages
- create or edit groups
- set check-in schedules, reminders or due dates
- change workspace settings, billing or branding
Do these in upcoach itself. The AI tool knows these limits, so you can ask it what it can and can’t do.
Available tools
Once connected, your AI assistant can use these tools, grouped by what they work on.
Programs, members, and posts
| Tool | What it does |
|---|---|
| Create program | Create a new draft program with the Coaching & Learning app ready for its curriculum, and get its link |
| List programs | List the programs in your organization with their links, filtered by name or status (live/draft) |
| Update program | Rename a program, publish it or move it back to draft. Publishing sends nothing itself, but from then on members are notified about new activities and section releases, and any section-release, cohort-start or early-access notices already scheduled for the program go out when due. Moving it back to draft pauses those notices, and any that come due while it is a draft are not sent. While it is a draft, its participants get no notifications or reminders from it, such as being added or a new event, and publishing doesn’t send those afterwards. A draft is visible only to Owners, Admins and its Program Admins. Its offer stays as it is: set that Live in Admin Area > Sell |
| List program apps | List the apps installed in a program, such as its Events, Feed, and Channel apps |
| List members | List the members of a program |
| Invite members | Invite people by email to a program as participants or coaches. Each one gets the normal invite email |
| Remove member | Remove someone from a program. They get a notice that they were removed. Owners, Admins and a program’s only Program Admin are removed on the Members page instead |
| Change member role | Make a program member a participant or a coach. They get a notice of the change. Owners, Admins and a program’s only Program Admin are changed on the Members page instead |
| List groups | List the subgroups of a program |
| List events | List a program’s events between two dates, with each event’s time and time zone |
| Create event | Create a single event or a recurring event series in a program |
| Update event | Change an event’s title, time, duration, or location, for one event or the rest of its series. Members going to it are notified and their calendar invites update |
| Cancel event | Cancel an upcoming event, or it and the rest of its series. Past events stay. Members going to it are notified and it leaves their calendars |
| Create feed post | Post to a program’s Feed |
| Send channel message | Send a message to a program’s Channel |
Curriculum: sections and modules
| Tool | What it does |
|---|---|
| Create section | Add a section (such as “Week 1”) to a program’s curriculum |
| Update section | Change a section’s title, icon, color, release date, and display settings |
| Delete section | Delete a section with its modules and activities |
| List sections | List a program’s sections in sidebar order |
| Reorder sections | Set the order of a program’s sections |
| Create module | Add a module to a section |
| Update module | Change a module’s title and the modules it requires first |
| Delete module | Delete a module and its activity placements |
| List modules | List the modules in a program, or in one section |
| Reorder modules | Set the order of the modules in a section |
Activities
| Tool | What it does |
|---|---|
| Get activity | Read an activity’s full content and settings, and where it’s placed |
| Create lesson activity | Create a lesson with text, headings, lists, images, and video |
| Update lesson activity | Edit a lesson |
| Create worksheet activity | Create a worksheet with questions participants answer |
| Create quiz activity | Create a quiz with scored single and multiple choice questions |
| Update worksheet activity | Edit a worksheet |
| Create task list activity | Create a checklist participants tick off at their own pace |
| Update task list activity | Edit a task list |
| Create check-in activity | Create a repeatable reflection, such as a weekly review or daily journal |
| Update check-in activity | Edit a check-in |
| Duplicate activity | Copy an activity with its content, settings, cover, and attachments |
| Delete activity | Delete an activity from your activity library, with its placements and responses |
| Update activity media | Set an activity’s cover, embed, and attachments from files already uploaded |
| Add activity to module | Place an existing activity in a module |
| Reorder activities | Set the order of the activities in a module |
| Search activity library | Find activities in your organization’s library to reuse |
Reports and participants
| Tool | What it does |
|---|---|
| Get program progress | Get progress reports for a program — overview metrics or individual participant progress |
| Get activity completion | See who has and hasn’t completed an activity, by name, with people who haven’t joined the program yet listed separately; for a quiz, each participant’s score |
| Get client insights | Look up a participant by name or email and see their profile across all programs |
| Get client responses | Retrieve participant responses to worksheets and check-ins, filtered by program, activity, or participant |
| Get content engagement | Analyze content performance — section-level completion rates or per-activity completion and view counts |
| Find inactive clients | Find participants who haven’t been active for a given number of days |
Cards
In AI assistants that support MCP Apps, these tools answer with a card in the chat, in light or dark to match it. Other AI tools get the same information as text. A card changes nothing by itself: Refresh, Show more and picking an activity only update the card, and its other buttons put a request into your chat. If you connected on or before Oct 31, refresh the connector once to see the new cards. What each card shows: See your programs as cards in your AI assistant.
| Tool | What it does |
|---|---|
| Show program overview card | A program at a glance: participants, people who opened it in the last 30 days (coaches and admins included), average progress, the share who finished, its sections and modules, and the next events |
| Show progress card | Who is on track and who went quiet: participants active in the last 14 days, and those who weren’t, including anyone who has never opened it. Draft a check-in for who went quiet asks the assistant to draft a message for you to review, and not to send it yet |
| Show activity completion card | Pick an activity and see who has done it, who hasn’t, and who was invited but hasn’t joined. Draft a reminder for who hasn’t done it asks the assistant to draft one for you to review, and not to send it yet |
| Show events card | A program’s events from today through the next 30 days, or the dates you ask for. Reschedule (events that haven’t started) and Cancel (events that haven’t ended) put a request into your chat, and some assistants send it at once; either way, it asks the assistant to show you the change and wait for your OK before making it with Update event or Cancel event, and members going to the event are notified |
Help and updates
| Tool | What it does |
|---|---|
| Search help center | Search upcoach help articles and guides |
| Search changelog | Browse recent updates and new features from the upcoach changelog |
Example prompts to try
Once connected, try asking your AI assistant:
- “List all my live programs and show me their progress”
- “Design a 6-week leadership coaching program with weekly group calls”
- “Show me the check-in responses for my leadership program”
- “Which activities in my coaching program have the lowest completion rates?”
- “Who hasn’t done Week 2’s lesson in my Wellness Program yet?”
- “Who hasn’t been active in the last 7 days in my mindfulness workshop?”
What to do next
- Create your first program — if you haven’t set one up yet, start here before connecting AI tools
- Track participant progress with reports — see how reports work so you know what to ask your AI assistant for
- Configure your organization settings — review your organization name, which appears in your MCP server name