MCP
Connect Superpowered Platform to AI with MCP
Setup for Claude, Claude Code, Codex, ChatGPT, and other MCP clients, with a prompt to copy and a guide to up to 75 role-based tools.
Once connected, your AI assistant can read and export your stored Superpowered report, review coaching recommendations, and work with Space pages directly from the platform. Team leads, admins, owners, and partners also receive tightly scoped access to statistics, member reports, and weekly team reports. After a separate opt-in, admins and owners can perform a bounded set of organization changes. The same MCP address works in Claude, Claude Code, Codex, ChatGPT Desktop, and other clients that support remote MCP servers and OAuth.
The MCP server address is https://sp.aimee.coach/api/mcp. The connection uses your Superpowered account and OAuth consent. You do not need an API key or a custom OAuth Client ID.
#Fastest setup: give this prompt to your assistant
Copy the complete prompt with the button in the upper-right corner and paste it into the app where you want to use Superpowered Platform. The assistant will either configure the connection or walk you through the exact steps. Setup is complete only after it reads your profile from the live server.
Copy and paste into your AI assistant
Read https://docs.aibility.org/en/methodology/mcp and connect the Superpowered Platform MCP server at https://sp.aimee.coach/api/mcp in this client using its native remote MCP configuration. If you can change the client settings, do it. If you cannot, give me the exact steps for this client and wait while I complete them. Use OAuth: open the sign-in flow and let me approve the requested access. Do not ask me for an API key or a custom OAuth Client ID, and do not store a key. Once connected, call the `get_my_profile` tool and summarize my current Superpowered profile; if I do not have a completed result, say so plainly. Setup is complete only after that tool returns real data. Do not stop after adding the server or signing in.#What to ask after connecting
- “Read my latest Superpowered report. For each recommendation, cite the report section it comes from.”
- “Export my latest report as HTML and save it under the filename returned by the platform.”
- “Find the existing public link for my latest ready report.”
- “List my coaching recommendations and find the themes that repeat.”
- “Find every Space page I can access.”
- “Read our organization statistics for the last 30 days and prepare the CSV.” This requires organization read access.
- “Find the latest ready report for my team and summarize the recommendations for next week.” A team lead receives reports only for their teams.
- “What was the participation in our latest check-in?” This requires full organization read access.
- “As an admin, prepare a preview that changes our organization default locale to Slovak. Do not execute it until I approve the preview.”
- “Prepare an invitation for
anna@example.com. Before asking for confirmation, show the recipient, what will be sent, and why. Do not send anything yet.” - “Review this bulk member import. Before asking for confirmation, explain whether the current campaign will send or schedule email for anyone.”
- “Prepare campaign activation from September 15 to September 30. Before both confirmations, show the recipients, message content, and send times.”
- “Archive this organization prompt. Show the exact impact and request both separate confirmations.”
- “Start an organization ZIP export without email notification, poll its status through MCP, download the ready ZIP from a fresh link, and verify the complete byte count and that the ZIP opens.”
To understand the parts of your result, read how to interpret your result. For sign-in problems, see the signing in and access FAQ.
#Manual setup by application
In Claude on the web or in the desktop app, open Customize → Connectors, select +, and choose Add custom connector. Enter the MCP address, add the connector, and sign in through OAuth.
Individual accounts can add the connector directly. On Team and Enterprise accounts, an owner must first add it under Organization settings → Connectors; each member then connects with their own Superpowered account. Leave custom OAuth Client ID and secret empty.
Run this command in a terminal:
claude mcp add --transport http --scope user superpowered https://sp.aimee.coach/api/mcpOpen Claude Code, enter /mcp, and start authentication for the superpowered server. OAuth opens in your browser. Check the connection with claude mcp list.
In ChatGPT Desktop or Codex, open Settings → MCP servers → Add server. Choose Streamable HTTP, name the server Superpowered Platform, enter the MCP address, save it, and restart the app. Then select Authenticate for the server.
In Codex CLI or the IDE extension, you can add the same connection to ~/.codex/config.toml:
[mcp_servers.superpowered]
url = "https://sp.aimee.coach/api/mcp"Start OAuth with codex mcp login superpowered; inspect active servers with /mcp or codex mcp list. ChatGPT Desktop, Codex CLI, and the Codex IDE extension on the same computer share this configuration.
ChatGPT on the web does not read your local Codex MCP configuration. Remote MCP tools are supplied through plugins in ChatGPT Work, and workspace administrators can control their availability.
If ChatGPT on the web does not offer a matching plugin to install, use ChatGPT Desktop, Codex, Claude, or Claude Code. Pasting the MCP address into an ordinary chat does not create a connection.
In Cursor or another client, look for MCP servers, Custom connector, or Integrations. Add a remote Streamable HTTP server, enter the MCP address, and complete OAuth sign-in.
The client must support remote HTTPS MCP servers and OAuth. A client that only accepts local stdio servers or requires a manually entered API key cannot use this direct connection.
During sign-in, approve access to your own Superpowered data, Space pages, and any organizations where you have an eligible role or lead a team. Then ask the assistant to call get_my_profile. One real data read verifies the server, sign-in, and permissions together.
#How many tools you get
The table shows the maximum after granting access to personal data, Space, and organization management where relevant. Your actual catalog depends on your role and the permissions you approve during connection.
| Your role | Available catalog |
|---|---|
| Regular user or organization member | 11 personal and Space tools. Total: 11. |
| Team lead | 11 personal and Space tools + 12 organization tools for led teams only. Total: 23. |
| Organization partner | 11 personal and Space tools + 25 read-only organization tools. Total: 36. |
| Organization admin | 11 personal and Space tools + up to 26 organization read tools. After granting management access: up to 30 change tools and 5 tools that safely confirm them. Total: up to 72. |
| Organization owner | 11 personal and Space tools + up to 26 organization read tools. After granting management access: up to 33 change tools and 5 tools that safely confirm them. Total: up to 75. |
If you do not grant Space access, you keep the 9 personal tools. A team lead receives organization tools only for teams they lead. A partner can only read organization data. Organization changes are available only to admins and owners after they explicitly grant management access. An account with several roles gets their combined catalog without duplicate tool names; the maximum is 75.
#Personal data and Space: 11 tools
These tools work only with your account and content you can currently access.
| Tool | What it does |
|---|---|
get_my_profile | Reads your name, locale, assessment and recommendation counts, and current derived Superpowered result. |
list_my_assessments | Lists your assessments with status, date, and available result metadata. |
get_my_assessment | Reads the details of one of your assessments. |
get_my_report | Reads a stored structured report. |
export_my_report | Returns the stored report as Markdown or HTML with a filename. |
get_my_report_share_link | Returns an existing public link for your ready report. |
list_my_coaching_recommendations | Lists your coaching recommendations, newest first. |
get_my_coaching_recommendation | Reads one complete recommendation in a readable format. |
export_my_coaching_recommendations | Exports one or all ready recommendations as Markdown. |
list_my_space_sites | Lists Space pages available to you directly, through an organization, or through a team. |
download_my_space_site | Creates a download link for an available Space page. The link expires after 120 seconds. |
You do not need to know the tool names. Ask your assistant to “Find my latest report and summarize my three strongest areas” or “Find the material for our workshop in Space and download it.”
#Organization data: based on your role
The platform reloads memberships, roles, and led teams on every request. A regular member cannot use MCP to see other people's data. A team lead sees only people, assessments, statistics, and team reports belonging to teams they currently lead. An admin or owner can read their organization; a partner can read all organizations in their current memberships.
| Tool | What it does | Availability |
|---|---|---|
list_my_organizations | Lists organizations, current roles, read scope, and led teams. | Team lead, admin, owner, partner |
list_members | Lists members, roles, teams, and available assessment status. | Everyone with organization read access |
list_teams | Lists teams and member counts. | Everyone with organization read access |
list_assessments | Finds and filters assessments in an organization. | Everyone with organization read access |
get_assessment | Reads assessment result details. | Everyone with organization read access |
get_report | Reads stored report sections for an assessment. | Everyone with organization read access |
export_member_report | Returns an authorized member's stored report as Markdown or HTML. | Everyone with organization read access |
get_organization_statistics | Reads the same statistics cards and member rows as the platform, restricted by role or led teams. | Everyone with organization read access |
export_organization_statistics | Exports the current statistics table as CSV. | Everyone with organization read access |
list_team_checkin_reports | Lists available ready weekly team reports. | Everyone with organization read access |
get_team_checkin_report | Reads one stored team report and its participation summary. | Everyone with organization read access |
export_team_checkin_report | Returns a stored team report as Markdown. | Everyone with organization read access |
get_organization_context | Reads the approved company context and its status. | Admin, owner, partner |
list_campaigns | Lists assessment campaigns in an organization. | Admin, owner, partner |
get_campaign | Reads the details of a campaign. | Admin, owner, partner |
get_checkin_participation | Shows check-in participation and member status. | Admin, owner, partner |
get_upcoming_coaching_schedule | Reads the combined company AI check-in schedule for a selected time range. | Admin, owner, partner |
list_activity | Shows member visit summaries. | Admin, owner, partner |
get_user_activity | Reads visit timestamps for one member. | Admin, owner, partner |
list_organization_prompts | Lists prompts owned by an organization. | Admin, owner, partner |
get_organization_prompt | Reads a complete organization prompt and its metadata. | Admin, owner, partner |
list_sites | Lists Space pages belonging to an organization or one of its teams. | Admin, owner, partner |
get_site | Reads metadata for one organization Space page. | Admin, owner, partner |
get_organization_export_status | Reads the status and progress of the latest organization ZIP export. | Admin, owner, partner |
download_organization_export | Creates a fresh link for a ready, unexpired ZIP. The link lasts 120 seconds and rechecks authorization during download. | Admin, owner, partner |
Access always follows your current role in the platform. If your role or team-lead assignment changes, the new access applies the next time you use a tool.
#How MCP returns exports and large files
The assistant receives text exports directly. Space and complete organization ZIP files use a secure link that lasts 120 seconds, so large files can be downloaded in full.
| Delivery | Tools | Result |
|---|---|---|
| Text export | export_my_report, export_my_coaching_recommendations, export_member_report, export_organization_statistics, export_team_checkin_report | The assistant receives the content and filename directly. |
| File download | download_my_space_site, download_organization_export | A fresh link to an HTML or ZIP file, valid for 120 seconds. |
For a large file, ask the assistant to check the downloaded size and verify that the HTML or ZIP opens. If the transfer stops early, request a new link and download the file again.
A complete organization export has three steps: an admin or owner starts start_organization_export with email notification disabled, an eligible admin, owner, or partner polls get_organization_export_status, then requests a fresh link through download_organization_export. A partner can read and download an existing export but cannot start a new one.
#Organization management: up to 30 tools for admins, 33 for owners
You must explicitly grant organization management access during sign-in. If you connected MCP earlier with read-only access, reconnect it and grant management access. The available scope follows your current role:
- an admin can use up to 30 management tools;
- an owner can use all 33 management tools;
- a partner, team lead, or regular member cannot change an organization through MCP.
Every change starts with a preview. Removal, cancellation, ending, unpublishing, archiving, and revocation require two separate confirmations. If an action sends or schedules email, the assistant must explain what will happen and why, who will receive the message, and when before asking for confirmation.
#Up to five tools that control safe execution
| Tool | What it does |
|---|---|
preview_customer_mutation | Shows the exact change before execution. It changes nothing. |
confirm_customer_mutation | Records the first confirmation for a change that removes something and requests the second. |
get_customer_mutation_status | Shows the status and result of one requested change. |
list_customer_mutation_audit | Lists the history of changes made through MCP in the organization. |
list_customer_communication_recipients | Shows the current campaign recipients before a send or schedule is confirmed. |
A standard change follows preview → confirmation → execution. A change that removes something follows preview → first confirmation → second confirmation → execution. If the target or permissions change in between, the assistant must prepare a new preview.
For any action that can send or schedule email, the assistant must show the recipients, reason, send time, and message preview before asking for confirmation. Invitations and campaigns use prepared Superpowered Platform templates.
#Organization settings and features: 5 tools
For admins and owners.
| Tool | What it changes |
|---|---|
update_organization_context | Replaces the approved company context in Markdown. |
update_organization_space_label | Sets the Space navigation labels for supported locales. |
update_organization_default_locale | Changes the organization's default locale. |
set_organization_ai_coach | Enables or disables AI Coach for the organization. |
set_organization_prompt_external_actions | Enables or disables external actions for organization prompts. |
#Teams and membership: 7 tools
| Tool | What it changes | Availability |
|---|---|---|
create_team | Creates a team; if a case-insensitive name match already exists, safely reuses it. | Admin, owner |
set_member_team | Assigns one team to a member or removes their current team assignment. | Admin, owner |
set_team_lead_teams | Replaces the exact set of teams led by one member. | Admin, owner |
set_member_note | Sets the internal organization-visible note for a member. | Admin, owner |
set_member_locale_override | Sets or clears the member's locale override. | Admin, owner |
update_member_role | Promotes a member to admin or downgrades an admin to member. It cannot change an owner or the caller's own role. | Owner only |
remove_organization_member | Removes a person's organization membership and team relationships. | Owner only |
Two confirmations apply when removing a member, removing or replacing an existing team assignment, removing a team-lead grant, clearing a locale override, or downgrading an admin to member.
#Campaign setup and management: 6 tools
For admins and owners.
| Tool | What it changes |
|---|---|
create_campaign_draft | Creates an inert organization or team campaign draft. It sends and schedules nothing. |
update_campaign_draft | Changes the start or end while the campaign remains a draft. |
update_campaign_end_date | Changes the campaign end date in a supported state. |
cancel_scheduled_campaign | Cancels a scheduled campaign after two confirmations. |
end_active_campaign | Ends an active campaign after two confirmations. |
remove_campaign_reminder | Removes one pending reminder after two confirmations. |
The tools for activating a campaign and adding a reminder are listed below.
#Export, Space, and organization prompts: 9 tools
For admins and owners.
| Tool | What it changes |
|---|---|
start_organization_export | Starts a ZIP export of the organization without an email notification. You can then check status and download the ready ZIP through MCP. |
create_organization_site | Creates an unpublished organization or team Space page and stores its first private content version. |
update_organization_site | Updates metadata or content as a new version and keeps prior versions. |
publish_organization_site | Publishes the current page version to authorized users. |
unpublish_organization_site | Hides a published page after two confirmations while keeping its content and versions. |
archive_organization_site | Archives and hides a page after two confirmations while keeping its content and versions. |
create_organization_prompt | Creates an active organization prompt for one locale and stores its first version. |
update_organization_prompt | Updates a prompt and keeps the previous version. |
archive_organization_prompt | Archives a prompt after two confirmations while keeping its versions. |
#Revoke older MCP access to an organization: 1 tool
For owners only.
| Tool | What it changes |
|---|---|
revoke_organization_mcp_key | Revokes one active older organization MCP key after two confirmations. |
Use the OAuth steps at the start of this page for new connections.
#Invitations and bulk import: 4 tools
For admins and owners.
| Tool | What it does |
|---|---|
get_organization_invite_link | Reads the current organization invitation link. It creates or changes nothing. |
rotate_organization_invite_link | Creates the first link after one confirmation. Replacing an existing link requires two confirmations and immediately invalidates the old link. |
invite_organization_member | Creates an invitation and sends it to the entered email address. Before confirmation, the assistant shows the recipient, reason, and message preview. An admin can invite a member; only an owner can invite an admin. |
bulk_import_members | Adds several members with optional team and language. Before confirmation, the assistant explains whether the current campaign will email anyone. If it will, the action requires two confirmations. |
#Campaign activation and reminders: 2 tools
For admins and owners.
| Tool | What it does |
|---|---|
activate_campaign | Activates the campaign after two confirmations and schedules its start email and reminders. Before confirmation, the assistant shows the recipients, reason, content, and send times. |
add_campaign_reminder | Adds a reminder to the campaign. For a draft it only saves the reminder; for an active campaign it schedules the message after two confirmations. |
A reminder cannot be added directly to a scheduled campaign. First cancel the schedule and return the campaign to draft after two confirmations. Then add the reminder.
#If the connection fails
| What you see | What to do |
|---|---|
Couldn't register with Superpowered Platform's sign-in service | Check the exact server address: https://sp.aimee.coach/api/mcp. Do not add a custom OAuth Client ID. Disconnect, delete, and add the connector again. |
| Only 9 tools and no Space tools | Reconnect and grant Space read access on the consent screen. |
| 11 tools but no organization tools | Check your role and organization-access consent. A regular member who does not lead a team remains on the personal catalog. |
| You are a team lead but organization tools are missing | Confirm that the platform still lists you as a lead for a specific team, then start a new OAuth sign-in. |
| Organization reads work but change tools are missing | Reconnect MCP, grant organization management access, and confirm that you are still an admin or owner. |
| The assistant says a change preview is stale | The target or your permissions changed. Ask for a fresh preview and review it again. |
| An invitation or campaign preview says the audience changed | Ask the assistant to reload recipients and create a new preview. Do not reuse the old confirmation because it no longer matches the people affected. |
| A Space or organization ZIP download stops early | Request a fresh 120-second link and ask the assistant to download the complete file. If its size differs from the reported size or the HTML/ZIP does not open, try a new link. |
Connection issue on an older connection | Start authentication again and complete a new OAuth consent flow. If the error remains, send the ofid_ reference to support@aibility.cz. |
| The server is configured but the assistant does not use it | Check the server status in the client or through /mcp, then ask the assistant to call get_my_profile directly. |