Overview
The Gainsight integration lets users connect their Gainsight instance so Alysio can query companies (accounts), users, CTAs (Calls to Action), activity timeline, and scoreboards on their behalf. Users can ask Alysio to list accounts or users, get object metadata (available fields), list and create/update CTAs, list activity timeline, and list scoreboards—all in natural language. The integration uses the user’s Gainsight credentials (access key and instance URL). For list and create/update operations, use the corresponding *_object_info (and for CTAs, cockpit_cta_config) tools first to get available fields and valid IDs. Supported capabilities / objects- Current user — Get the current login user’s information (e.g. for CTA owner).
- Company (accounts) — Object describe (fields); list companies with select, where, orderBy, pagination.
- User — Object describe (fields); list users with select and filters.
- CTA (Call to Action) — Object describe; cockpit CTA config (status, priority, type picklists); list CTAs; create CTA; update CTA.
- Activity timeline — Object describe; list activity timeline (e.g. by user, company) with select and filters.
- Scoreboard — Object describe; list scoreboards with select and filters.
Authentication
Method: API key (access key) and instance URL—not OAuth. Gainsight does not use OAuth for this integration. Users must obtain an access key and their Gainsight instance URL (e.g. from Gainsight administration or API settings) and configure them when connecting Gainsight to Alysio. The MCP sends requests using the stored credential (access key and instance URL) so requests are sent to the correct Gainsight instance with the correct authorization. Redirect URI: Not applicable—Gainsight connection uses access key and instance URL, not OAuth. Token handling- The access key and instance URL are stored as part of the user’s Gainsight connection.
- Each user/tenant has their own credential; the MCP sends the appropriate credential ID with each request so calls are isolated per connection.
- There is no OAuth refresh; if the access key or instance URL changes (e.g. key rotated, instance migrated), the user must update or re-create the connection in Settings → Integrations.
- On disconnect, that credential is no longer used and Gainsight tools will not be available until the user reconnects with a valid access key and instance URL.
- Access key — API access key from Gainsight (used for authorization in API requests).
- Instance URL — Your Gainsight instance base URL (e.g.
https://yourcompany.gainsightcloud.comor the URL provided by Gainsight). Requests are sent to this host.
| Credential | Purpose |
|---|---|
| Access key | Authenticates all API calls (users/me, object describe, company/user/CTA/activity/scoreboard list, CTA create/update). |
| Instance URL | Ensures requests target the correct Gainsight tenant. |
MCP Tools
The Gainsight MCP exposes the following tools. Users can invoke these capabilities through natural language in Alysio.| Tool | Description | Example user prompts |
|---|---|---|
gainsight_current_user_info | Returns the current login user’s information (e.g. for use as CTA owner). | ”Who am I in Gainsight?”, “Get current user for CTA owner.” |
gainsight_company_object_info | Returns object metadata (available fields) for the Gainsight Company object; use before list_account to choose select fields. | ”What fields does Company have?”, “Describe Company object.” |
gainsight_list_account | Lists companies with select fields, optional where filters, orderBy, and pagination; call company_object_info first for fields. | ”List our Gainsight accounts”, “Find companies by stage.” |
gainsight_user_object_info | Returns object metadata (available fields) for the Gainsight User object; use before list_user. | ”What fields does User have?”, “Describe User object.” |
gainsight_list_user | Lists users with select fields and optional filters; call user_object_info first for fields. | ”List Gainsight users”, “Get user IDs for CTAs.” |
gainsight_cta_object_info | Returns object metadata (available fields) for the CTA object; use before CTA list/create/update. | ”What fields does CTA have?”, “Describe CTA object.” |
gainsight_cockpit_cta_config | Returns CTA picklist config (status, priority, type IDs); use for valid statusId, priorityId, typeId when creating or updating CTAs. | ”Get CTA status and type options”, “What CTA priorities are available?” |
gainsight_create_cta | Creates a new CTA; requires fields such as name, ownerId, accountId, typeId, statusId, priorityId, dueDate; use object_info, list_account, current_user_info, and cockpit_cta_config to get IDs. | ”Create a CTA for Acme Corp”, “Add a new call to action.” |
gainsight_cta_list | Lists CTAs with select fields and optional filters; call cta_object_info first for fields. | ”List our CTAs”, “Find CTAs for this account.” |
gainsight_update_cta | Updates an existing CTA by Gsid; use cta_object_info, cta_list (for Gsid), cockpit_cta_config, and current_user_info as needed. | ”Update this CTA’s status”, “Change CTA due date.” |
gainsight_activity_timeline_object_info | Returns object metadata (available fields) for the Activity Timeline object; use before list_activity_timeline. | ”What fields does Activity Timeline have?”, “Describe Activity Timeline object.” |
gainsight_list_activity_timeline | Lists activity timeline with select fields and filters (e.g. user, company); use object_info, list_user, list_account for IDs. | ”List activity for this account”, “Get timeline for this user.” |
gainsight_scoreboard_object_info | Returns object metadata (available fields) for the Scoreboard object; use before scoreboard_list. | ”What fields does Scoreboard have?”, “Describe Scoreboard object.” |
gainsight_scoreboard_list | Lists scoreboards with select fields and optional filters; call scoreboard_object_info first for fields. | ”List our scoreboards”, “Get scoreboard data.” |
App Behavior
- API calls are made on-demand only when the user asks something that requires Gainsight data or an action (e.g. current user, object describe, list accounts/users/CTAs/activity/scoreboards, create/update CTA). There is no background sync; each request triggers the relevant Gainsight API call using the user’s stored credential.
- User asks: “Create a CTA for Acme Corp due next week.”
- Alysio routes the request to the Gainsight MCP.
- The MCP may call
gainsight_cta_object_infoandgainsight_cockpit_cta_configfor fields and valid IDs,gainsight_list_accountto get Acme’s company ID,gainsight_current_user_infofor ownerId, thengainsight_create_ctawith the built payload. - The request is sent to the user’s Gainsight instance URL using the stored access key.
- The MCP returns the create result; Alysio confirms in chat.
Troubleshooting
Common issues- Gainsight not connected — User has not configured Gainsight with an access key and instance URL. Fix: Add the Gainsight connection in Settings → Integrations and provide the access key and instance URL (no OAuth—credentials are entered or configured there).
- 401 Unauthorized — Access key invalid, expired, or revoked. Fix: Generate a new access key in Gainsight and update the connection in Settings → Integrations.
- Wrong instance or 404 — Instance URL incorrect or changed. Fix: Confirm the correct Gainsight instance URL (e.g. from Gainsight admin) and update the connection in Alysio.
- Invalid field or ID in request — List/create/update fails due to unknown field or invalid picklist/owner/account ID. Fix: Use the corresponding *_object_info (and for CTAs, gainsight_cockpit_cta_config) to get valid field names and IDs; use gainsight_list_account, gainsight_list_user, gainsight_current_user_info as needed for account and owner IDs.
- CTA create/update missing required fields — CTA API requires specific fields. Fix: Use gainsight_cta_object_info and gainsight_cockpit_cta_config to get required fields and valid status/priority/type IDs; include name, ownerId, accountId, typeId, statusId, priorityId, dueDate (or as required by your CTA configuration).
- Email: support@alysio.ai
- For Gainsight API details, see Gainsight NXT API and Developer Docs.