Agent Spark is your human insights analyst. You can access Agent Spark directly through our platform, via your favorite LLM tool or via Slack's native MCP client feature.
This article covers how to connect Agent Spark to your Slackbot using Slack's native MCP client feature. For more information on how to access Agent Spark in other ways, including via other LLM tools, see our article on how to access Agent Spark.
The connector for Slack is compatible with all our syndicated data sets depending on your subscription.
If you’re a Free user you can only use Agent Spark via our platform.
How to connect Agent Spark to Slackbot
Getting started is simple - just follow these two quick steps:
One-time setup by your IT or Development teams (Workspace admin)
Configuration by the Workspace users/members (End user)
Below are the steps for both IT or Development teams and Workspace users/members to enable the connector in your workspace. Click on each to expand.
For IT or Development teams (Required first)
For IT or Development teams (Required first)
Go to api.slack.com/apps and create a new app (or use an existing one) for your workspace
In the left sidebar, go to Features -> MCP Servers and click Get Started
Enter the connection details:
Name: GWI Spark
Auth type: Dynamic Client Registration
Identify URL: Leave blank
Account Identifier: Leave blank
Note: If Dynamic Client Registration doesn’t complete successfully, switch to Manual OAuth and enter GWI’s OAuth authorization URL, token URL, and client credentials instead. Contact your GWI account team if you need these values.
Save. This automatically adds the mcp:connect bot scope to the app.
Install (or reinstall) the app to your workspace under OAuth & Permissions -> Install to Workspace
If your workspace has app approval turned on, changing the app’s permission scopes (which happens automatically when you add or edit an MCP server) means you can’t self-install anymore. Instead of an “Install” button, you’ll see Request to Workspace Install. Clicking it sends an approval request to a workspace Owner/Admin, and the Bot User OAuth Token only regenerates once they approve it. Budget time for this step, it isn’t instant.
If your organization is on Enterprise Grid, install the app at the org level (Org Level Apps) rather than a single workspace, so it’s available to everyone who needs it.
After installing, you should be able to see GWI Spark listed under MCP Server Connection Details.
For Workspace users / members (After IT setup is completed)
For Workspace users / members (After IT setup is completed)
Open a direct message with Slackbot (not the GWI Spark app itself).
Click the Apps icon in the message toolbar and find GWI Spark under Available
Click to connect. You’ll be redirected to the GWI sign-in page, use your GWI credentials to sign in
Review the requested permissions and click Allow
Once connected, ask Slackbot a Spark-style question directly, e.g. “What data sets do I have access to?” or “How do young parents discover brands?”
Note: Please be aware that GWI provides the connectors only, and your use of your LLM to access Agent Spark is your own responsibility. You should check that you have the required rights and permissions to use your LLM with our connector. We require you not to allow your LLM to train on our data. We always recommend that you use paid or enterprise LLM accounts.
Troubleshooting
App not visible to Slackbot: Confirm the app has the mcp:connect bot scope (this is added automatically when the MCP server is saved) and that you’ve reinstalled the app since the most recent config change. On Enterprise Grid, confirm the app is installed at the org level, not just a single workspace.
OAuth errors: If Dynamic Client Registration fails, switch to Manual OAuth. Check Features -> MCP Servers -> Logs for the specific connection error before assuming the problem is on Slack’s side.
Access denied during sign-in: Confirm with your GWI contact that your email address or domain is enabled for your organization’s Spark MCP access.
Slackbot won’t respond / message limit reached: Business+ workspaces are capped at 15 Slackbot messages per user per week, reset every Monday. This limit is shared across all of Slackbot’s uses, not just GWI Spark queries.