API and MCP access
What you can do
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.
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
Ask your Swayable Client Success Manager. Each person gets their own key.
An MCP client
Claude Code, Codex CLI, Gemini CLI or another MCP client that supports remote servers with custom headers. The REST API needs no MCP client.
Server URL
Point your MCP client at this address. Both the MCP server and the REST API use stateless Streamable HTTP and return JSON.
MCP server URL
https://results.swayable.com/mcp
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.
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.