Connect your AI assistant to your Swayable test results, or call the REST API from your own tools. Ask in plain English which creative moved brand love, how it did with your target segment, or for a stakeholder-ready summary.
What you can do
| Capability | Description |
|---|---|
| Browse your tests | List your organization’s tests and see which have results available. |
| Read results | Lift for every metric and creative compared with the control group, with 95% confidence intervals. |
| Explore segments | The same results for each audience segment configured on your test. |
| Follow trackers | Tracker results over time, one reading per date. |
| See a preview | Up to 20 fixed example entries that show the shape of a test’s data. |
| Use your own tools | The REST API returns the same data as JSON for warehouses, BI dashboards and scripts. |
Requirements
- A Swayable account in an organization with results access.
- A personal API key.
- Claude Code, Codex CLI, Gemini CLI or another MCP client that supports remote servers with custom headers. The REST API needs no MCP client.
Need a key? Ask your Swayable Client Success Manager. Each person gets their own key, delivered securely. Keep your key out of emails, chat messages, AI prompts, shared documents and URLs. Your API key is separate from your Swayable sign-in.
Quick start
This example uses Claude Code. For Codex, Gemini CLI and other clients, see Connect your AI assistant.
1. Enter your key at a hidden prompt
printf 'API key: '; IFS= read -r -s SWAYABLE_API_KEY; printf '\n'
2. Add the connection
claude mcp add --transport http --scope user swayable-results \
https://results.swayable.com/mcp \
--header "Authorization: Bearer ${SWAYABLE_API_KEY}"
unset SWAYABLE_API_KEY
3. Check that swayable-results shows as Connected, then start claude
claude mcp list
Then try
Paste this into Claude Code once it starts.
Example prompt
Use Swayable Results to list my tests and their availability. Ask me which test to explore, then summarize its results by creative, with the metric, value, unit and 95% interval for each finding.
Server URL
Both the MCP server and the REST API use stateless Streamable HTTP and return JSON.
MCP server
https://results.swayable.com/mcp
REST API
https://results.swayable.com/v1
Access and permissions
- You see only your own organization’s tests. Everyone with access in your organization sees the same list.
- Access is read-only. The API can’t change tests or start new analyses.
- New tests appear automatically. Results become available after a test is finalized, usually within 1 day.
- API keys are personal and can be revoked at any time by your Client Success Manager.