MCP
Superpowered in Claude, ChatGPT, and other AI tools
The Superpowered Professional connector in the Claude directory, the plugin for Claude Code and Codex, and the full Superpowered Platform MCP for company programs. Setup steps and a role-based tool guide.
You can connect Superpowered directly to the AI tool you already work in. Your assistant then knows your result, explains your report, coaches you on the work in front of it, and can run a new assessment with you. The connection uses MCP, an open standard for linking AI assistants to other services. You sign in with your Superpowered account; no API key or technical setup is needed.
#Two ways to connect
| Superpowered Professional | Superpowered Platform | |
|---|---|---|
| Who it is for | Anyone who wants coaching and their report inside their AI tool | Company programs: members, team leads, admins, owners, and partners |
| Where to find it | Claude connector directory, plugin for Claude Code and Codex | Custom connector using the server address |
| What it does | Coaching on current work, report explanations, and a new assessment you review before it is saved | Everything personal, plus report exports, Space pages, organization statistics, and role-based organization management |
| Tools | 9 tools and 3 ready-made workflows | 22 to 76 tools depending on role |
| Server address | https://sp.aimee.coach/api/mcp/plugin | https://sp.aimee.coach/api/mcp |
Most people only need Superpowered Professional. Connect the full platform when you need Space, exports, or organization data. You can use both at the same time; each connection has its own sign-in.
#Superpowered Professional in Claude
Superpowered Professional is listed in Claude's official connector directory. You can add it in a few clicks, and it works in Claude on the web, in the desktop app, and in Cowork.
Open the connector in the directory. Use the link above, or in Claude open Customize → Connectors, browse the directory, and search for “Superpowered Professional”.
Add it and sign in. Claude opens the sign-in page on sp.aimee.coach. Sign in with the email you use for Superpowered and approve the requested access.
Check that it works. In a new chat, write “Load my Superpowered state.” Setup is complete when the assistant returns your real data.
On Claude Team and Enterprise accounts, the organization owner can restrict directory connectors. If you cannot add Superpowered Professional, ask your company's Claude admin to allow it under Organization settings → Connectors.
The connector returns data only with active paid Superpowered access, either through your own purchase or a company program. You can still connect without it. The Superpowered FAQ explains what is free and what is paid.
#Superpowered Professional in Claude Code, Codex, and other tools
In Claude Code and Codex, you install Superpowered Professional as a plugin. Besides the server connection, it adds the three ready-made workflows described below. The plugin source code is public on GitHub.
Run these two commands inside Claude Code:
/plugin marketplace add aibilitycz/Superpowered-professional-by-aibility
/plugin install superpowered-professional@aibility-superpoweredThen type /mcp, select the Superpowered Professional server, and sign in. Sign-in opens in your browser.
Run this in a terminal:
codex plugin marketplace add aibilitycz/Superpowered-professional-by-aibilityThen open /plugins in Codex, install Superpowered Professional from the aibility-superpowered marketplace, and sign in with your Superpowered account.
In ChatGPT, add Superpowered Professional as a custom MCP app with the address https://sp.aimee.coach/api/mcp/plugin. Developer mode must be on.
In a company workspace (Business, Enterprise, Edu), an admin creates the app under Workspace settings → Apps → Create, chooses OAuth sign-in, reviews the discovered tools, and makes the app available to people. Each person then connects their own Superpowered account.
In Cursor or another client, add a remote MCP server of type Streamable HTTP with the address https://sp.aimee.coach/api/mcp/plugin and complete OAuth sign-in.
The client must support remote HTTPS MCP servers and OAuth. If it only offers local stdio servers or requires a manually pasted API key, it cannot connect this way.
#What Superpowered Professional does
Three ready-made workflows cover what people most often use Superpowered for inside an AI tool. In Claude Code and Codex they are skills; in Claude and other clients they are connector prompts.
| Workflow | What it does |
|---|---|
coach-current-work | Reviews work from the current conversation, the last day, the last week, or a period you choose. It picks at most two AI-first principles and gives you one experiment, a ready prompt, and a signal that shows whether it works. |
understand-my-report | Explains your current result and report and helps you choose one next step. |
take-superpowered-assessment | Prepares a new assessment from your real work in the AI tool. It shows you the complete report and saves it only after you confirm. |
You do not need to know the workflow names. Just write something like:
- “Review the work in this conversation and suggest one experiment for doing it better with AI next time.”
- “Help me understand my latest Superpowered report and choose one next step with me.”
- “Assess how I work with AI toward my current goal. Show me the full report before saving anything.”
To understand each part of your result, read how to interpret your result.
#Nine tools
| Tool | What it does |
|---|---|
get_my_superpowered_state | Reads your current Superpowered profile and access state. The assistant calls it first. |
get_ai_first_coaching_principles | Reads the ten AI-first principles that coaching builds on. |
get_coaching_methods | Selects a coaching method for the area you want to improve. It never receives your work content and stores only the offered method so it does not repeat. |
list_my_assessments | Lists your assessments. |
read_my_assessment_report | Reads one of your confirmed reports as text. |
list_my_coaching_recommendations | Lists your coaching recommendations, newest first. |
get_my_coaching_recommendation | Reads one complete recommendation. |
start_my_superpowered_assessment | Starts an assessment and gives the assistant the current workflow and privacy rules. |
submit_my_superpowered_assessment | Saves the assessment only after you have confirmed the complete report. |
#What is sent to Superpowered
- Your work content, meaning conversations, files, and code, stays in the AI tool. During coaching, Superpowered receives only general inputs such as the area and language.
- From an assessment, only the finished report you reviewed and confirmed is saved, together with the AI tool and model it came from when known.
- The connector works only with the signed-in person's data. It cannot see colleagues' or company data.
- Data that Superpowered returns to the assistant is processed by the AI tool's provider under its own terms.
For more on data processing, see the security and GDPR FAQ.
#Superpowered Platform: full MCP for company programs
The full platform includes everything personal, plus report exports, Space pages, organization statistics, campaigns, and organization management. It is not in the Claude directory; you add it as a custom connector.
The 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 the 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.”
- “List my coaching recommendations and find the themes that repeat.”
- “Find the material for our workshop in Space and download it.”
- “Read our organization statistics for the last 30 days and prepare the CSV.” A team lead receives only their teams.
- “Who on our team has not finished the assessment yet?”
- “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.” - “Prepare campaign activation from October 15 to October 30. Before both confirmations, show the recipients, message content, and send times.”
#Manual setup by application
On an individual account, open Customize → Connectors in Claude, select +, and choose Add custom connector. Enter the server address, add the connector, and sign in through OAuth.
On Team and Enterprise accounts, an owner first adds the connector under Organization settings → Connectors → Add → Custom → Web. Members then connect their own Superpowered account under Customize → Connectors. Leave custom OAuth Client ID and secret empty.
If new tools do not appear after a role or permission change, disconnect and reconnect the connector.
Run this command in a terminal:
claude mcp add --transport http --scope user superpowered https://sp.aimee.coach/api/mcpThen open Claude Code, type /mcp, and start sign-in for the superpowered server. OAuth opens in your browser. Check the status with claude mcp list. To sign in again, choose Clear authentication in /mcp and authenticate once more.
In ChatGPT Desktop or Codex, open Settings → MCP servers → Add server. Choose Streamable HTTP, name the server Superpowered Platform, enter the server address, save it, and restart the app. Then choose Authenticate for the server.
In Codex CLI or the IDE extension, you can store the same connection in ~/.codex/config.toml:
[mcp_servers.superpowered]
url = "https://sp.aimee.coach/api/mcp"Start sign-in with codex mcp login superpowered, and check 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 use your local Codex configuration. In a company workspace, an admin creates the app:
- Turns on developer mode for the people who should use it.
- Opens Workspace settings → Apps → Create, enters the server address, chooses OAuth, and selects Scan Tools.
- Reviews the discovered tools and makes the app available to selected groups.
- Each person then connects their own Superpowered account and enables the app from the tools menu in a new chat.
ChatGPT keeps the tool list as the admin approved it. New tools do not appear on their own; the admin must refresh the list and approve them.
Create ~/.cursor/mcp.json for a personal connection, or .cursor/mcp.json in a project:
{
"mcpServers": {
"superpowered": {
"url": "https://sp.aimee.coach/api/mcp"
}
}
}Then open Customize → Tools & MCP, enable the server, and complete OAuth sign-in. Do not add headers, keys, or custom scopes.
After signing in, approve access to your own Superpowered data, assessment saving, Space pages, and any organizations where you have an eligible role or lead a team. Organization management is a separate approval. Then ask the assistant to call get_my_profile. One real data read confirms the server, sign-in, and permissions.
#How many tools you get
The table shows the maximum after you approve every permission. Your actual list depends on your role and on what you approve when connecting.
| Your role | Available catalog |
|---|---|
| Organization member or individual | 22 personal and Space tools. Total 22. |
| Team lead | 22 personal and Space + 5 organization tools for led teams. Total 27. |
| Organization partner | 22 personal and Space + 16 read-only organization tools. Total 38. |
| Organization admin | 22 personal and Space + 17 organization read tools. After enabling management, also 29 change tools and 5 tools for confirming them safely. Total up to 73. |
| Organization owner | 22 personal and Space + 17 organization read tools. After enabling management, also 32 change tools and 5 tools for confirming them safely. Total up to 76. |
Without Space access, 20 personal tools remain. Partners, team leads, and regular members cannot change the organization through MCP. A person with several roles receives their combined catalog without duplicates.
#Personal and Space tools: 22
These tools work only with your account and the content you can access.
| Tool | What it does |
|---|---|
get_my_profile | Reads your name, language, assessment and recommendation counts, and current Superpowered result. |
get_my_superpowered_state | Reads your current profile and access state. |
list_my_assessments | Lists your assessments with status, date, and source: platform or MCP. |
get_my_assessment | Reads one of your assessments without answers or transcripts. |
get_my_report | Reads a stored structured report. |
read_my_assessment_report | Reads a confirmed report as Markdown text. |
export_my_report | Returns a stored report as Markdown or HTML, including the filename. |
get_my_report_share_link | Returns the existing public link to your ready report. |
list_my_coaching_recommendations | Lists your coaching recommendations, newest first. |
get_my_coaching_recommendation | Reads one complete recommendation. |
export_my_coaching_recommendations | Prepares one or all ready recommendations as Markdown. |
coach_my_work | Returns the coaching workflow for work from today, the last week, or a chosen period. |
get_ai_first_coaching_principles | Reads the ten AI-first principles. |
get_coaching_methods | Selects a coaching method for the area you want to improve. |
get_my_coaching_card | Reads a coaching card with its method, exercise, and prompt. |
coach_current_work | Current-work coaching workflow for clients that do not support MCP prompts. |
understand_my_report | Report explanation workflow for the same clients. |
take_superpowered_assessment | Assessment workflow for the same clients. |
start_my_superpowered_assessment | Starts an assessment based on your work in the AI tool. Requires paid access. |
submit_my_superpowered_assessment | Saves the assessment only after you have confirmed the complete report. |
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 a Space page. The link is valid for 120 seconds. |
#Organization data by role
The platform checks your membership, role, and led teams again on every request, so a role change takes effect the next time you use a tool.
Individual results are private. Through MCP, no one except the person it belongs to can read an assessment, a report, or a team check-in report. Team leads, admins, owners, and partners see coordination details and statistics to the same extent as in the platform.
| Tool | What it does | Availability |
|---|---|---|
list_my_organizations | Lists your organizations, role, read scope, and led teams. | Team lead, admin, owner, partner |
list_members | Lists members, roles, teams, language, and whether they have finished the assessment. It returns no scores, levels, profiles, or reports. | Everyone with organization read access |
list_teams | Lists teams and member counts. | Everyone with organization read access |
get_organization_statistics | Reads the same statistics as the platform. A team lead receives only their teams. | Everyone with organization read access |
export_organization_statistics | Prepares the statistics table as CSV. | Everyone with organization read access |
get_organization_context | Reads the approved company context and its status. | Admin, owner, partner |
list_campaigns | Lists the organization's assessment campaigns. | Admin, owner, partner |
get_campaign | Reads one campaign. | Admin, owner, partner |
get_checkin_participation | Shows check-in participation and status, without conversation content. | Admin, owner, partner |
get_upcoming_coaching_schedule | Reads the company AI check-in schedule for a chosen period. | Admin, owner, partner |
list_activity | Shows visit summaries for organization members. | Admin, owner, partner |
get_user_activity | Reads one member's recent visit times. | Admin, owner, partner |
list_organization_prompts | Lists prompts owned by the organization. | Admin, owner, partner |
get_organization_prompt | Reads one complete organization prompt and its metadata. | Admin, owner, partner |
list_sites | Lists Space pages for the organization or one of its teams. | Admin, owner, partner |
get_site | Reads metadata for one Space page. | Admin, owner, partner |
get_organization_invite_link | Reads the organization's current invite link. | Admin, owner |
#Exports and files
The assistant receives text exports directly: export_my_report, export_my_coaching_recommendations, and export_organization_statistics return the content and filename. Download a Space page with download_my_space_site, which creates a secure link valid for 120 seconds.
For a large file, ask the assistant to verify the downloaded size and check that the file opens. If the download is interrupted, request a new link. An admin or owner downloads the full organization ZIP export directly in the platform.
#Organization management: 29 tools for admins, 32 for owners
You must explicitly allow organization management when signing in. If you connected MCP earlier for reading only, reconnect and allow management. Partners, team leads, and regular members cannot change the organization through MCP.
Every change starts with a preview. Removing, canceling, ending, hiding, archiving, and revoking require two separate confirmations. If an action sends or schedules email, the assistant shows who receives what, why, and when before you confirm. Nothing can be permanently deleted through MCP: people's accounts, assessments, reports, and content versions stay.
#Five tools for executing a change safely
| Tool | What it does |
|---|---|
preview_customer_mutation | Shows the exact change before it runs. It changes nothing. |
confirm_customer_mutation | Records a confirmation. For a change that removes something, it requests a second one. |
get_customer_mutation_status | Shows the status and result of one change. |
list_customer_mutation_audit | Lists the history of changes made through MCP in the organization. |
list_customer_communication_recipients | Shows the current recipients of an invitation or campaign before you confirm sending. |
A standard change goes preview → confirmation → execution. A change that removes something goes preview → first confirmation → second confirmation → execution. If the target record or your permissions change in between, the assistant must prepare a new preview. Invitations and campaigns use the platform's prepared templates; you cannot send a custom email through MCP.
#Organization settings: 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 menu label for supported languages. |
update_organization_default_locale | Changes the organization default language. |
set_organization_ai_coach | Turns the AI coach on or off for the organization. |
set_organization_prompt_external_actions | Turns external actions for organization prompts on or off. |
#Teams and membership: 7 tools
| Tool | What it changes | Availability |
|---|---|---|
create_team | Creates a team. If a team with the same name already exists, it reuses it. | Admin, owner |
set_member_team | Assigns a member to a team or removes their team assignment. | Admin, owner |
set_team_lead_teams | Sets the exact list of teams a member leads. | Admin, owner |
set_member_note | Sets an internal note about a member. | Admin, owner |
set_member_locale_override | Sets or clears a member's language override. | Admin, owner |
update_member_role | Promotes a member to admin or demotes an admin to member. It cannot change the owner or the caller's own role. | Owner only |
remove_organization_member | Removes a person from the organization and from their teams. | Owner only |
Two confirmations are required to remove a member, remove or replace a team assignment, remove a led team, clear a language override, or demote an admin to member.
#Campaigns: 6 tools
For admins and owners.
| Tool | What it changes |
|---|---|
create_campaign_draft | Creates a campaign draft for the organization or a team. It sends and schedules nothing. |
update_campaign_draft | Changes the campaign start or end while it is still a draft. |
update_campaign_end_date | Changes the campaign end date. |
cancel_scheduled_campaign | After two confirmations, cancels a scheduled campaign and returns it to draft. |
end_active_campaign | After two confirmations, ends an active campaign. |
remove_campaign_reminder | After two confirmations, cancels one pending reminder. |
#Space and organization prompts: 8 tools
For admins and owners.
| Tool | What it changes |
|---|---|
create_organization_site | Creates an unpublished Space page for the organization or a team. |
update_organization_site | Saves changes as a new version; earlier versions stay. |
publish_organization_site | Publishes the current version to authorized people. |
unpublish_organization_site | After two confirmations, hides the page; content and versions stay. |
archive_organization_site | After two confirmations, archives the page; content and versions stay. |
create_organization_prompt | Creates an organization prompt for a specific language. |
update_organization_prompt | Updates a prompt; the previous version stays. |
archive_organization_prompt | After two confirmations, archives a prompt; its versions stay. |
#Invitations and bulk import: 3 tools
For admins and owners.
| Tool | What it does |
|---|---|
rotate_organization_invite_link | Creates an invite link. Replacing an existing link requires two confirmations, and the old link stops working immediately. |
invite_organization_member | Creates an invitation and sends it to the given email. Admins can invite members; only the owner can invite an admin. |
bulk_import_members | Adds several members with an optional team and language. If a running campaign would email anyone, the assistant says so first and requests two confirmations. |
#Campaign activation and reminders: 2 tools
For admins and owners.
| Tool | What it does |
|---|---|
activate_campaign | After two confirmations, activates the campaign and schedules the start email and reminders. |
add_campaign_reminder | Adds a reminder. For a draft it only saves it; for an active campaign it schedules it after two confirmations. |
#Revoking an old MCP key: 1 tool
Owner only.
| Tool | What it changes |
|---|---|
revoke_organization_mcp_key | After two confirmations, invalidates one older organization MCP key. |
New keys are no longer issued. Use the OAuth setup described above to connect.
#When the connection does not work
| What you see | What to do |
|---|---|
| You cannot add Superpowered Professional in Claude | On a Team or Enterprise account, the organization owner must allow it under Organization settings → Connectors. |
The assistant reports premium_required | You do not have active paid Superpowered access. Get it through your own purchase or a company program. Your sign-in and connection stay valid. |
Couldn't register with Superpowered Platform's sign-in service | Check the exact server address with no trailing slash. Do not add a custom OAuth Client ID. Disconnect, delete, and add the connector again. |
invalid_scope | Remove manually entered scopes, especially openid, profile, or email, and reconnect. |
| Space or assessment tools are missing | Reconnect the server and allow Space and assessment saving on the consent screen. |
| Organization tools are missing | Check your role and your consent to organization access. A regular member who does not lead a team has personal tools only. A team lead should confirm in the platform that they still lead the team. |
| Organization reads work, but change tools are missing | Reconnect MCP, allow organization management, and confirm that you are still an admin or owner. |
| New tools are missing in ChatGPT | The workspace admin must refresh the app's tool list and approve it. |
| The assistant says a change preview is stale | The target record or your permissions changed in the meantime. Ask for a new preview. |
| An invitation or campaign preview reports changed recipients | Ask the assistant to reload the recipients and create a new preview. Do not reuse the old confirmation. |
| A Space download stops early | Request a new 120-second link and ask the assistant to download the complete file. |
Connection issue after an earlier connection | Start a new sign-in. If the error remains, send support@aibility.cz the client name and version, the time, and the error reference that starts with ofid_. Never send tokens or returned data. |
| The server is added, but the assistant does not use it | Check the server status in the client settings or with /mcp, then ask the assistant directly to call get_my_superpowered_state. |
For help signing in to Superpowered, see the signing in and access FAQ.