Claude
Add Ballpark as a connector in Claude, or register it in Claude Code. You will be asked to sign in to Ballpark the first time you use a tool. Get Claude at claude.ai.
Claude Code command
claude mcp add --transport http ballpark https://edge.ballparkhq.com/api/mcp
In Claude.ai or Claude Desktop: Settings, Connectors, Add custom connector, then paste the server URL.
ChatGPT and Codex
Add Ballpark as a custom connector in ChatGPT, or add it to Codex’s MCP configuration. Get ChatGPT at chatgpt.com.
Codex config (config.toml)
[mcp_servers.ballpark]url = "https://edge.ballparkhq.com/api/mcp"
Cursor
Add Ballpark to Cursor’s MCP settings and your agent can draft, refine and launch studies from your editor. Get Cursor at cursor.com.
Cursor config (~/.cursor/mcp.json)
{ "mcpServers": { "ballpark": { "url": "https://edge.ballparkhq.com/api/mcp" } } }
Any MCP client
Ballpark is a standard remote MCP server over Streamable HTTP with OAuth. Windsurf, Gumloop, Zapier Agents and any client that supports remote servers can connect with the URL alone. See the connection guide.
Server URL
https://edge.ballparkhq.com/api/mcp
How it works
Connect in three steps
No API keys, no SDKs. Add the server, sign in once, and start describing studies.
$
claude mcp add --transport http ballpark …
Added HTTP MCP server ballpark
01
Add the server
Paste the Ballpark MCP URL into your AI tool, or run the one-line command for your client. No API key is needed.
Ballpark wants to access your workspace
Scopes: projects:write, usertests:write
[ Approve ]
02
Sign in once
The first time your agent uses a Ballpark tool, you will be asked to sign in and approve access. Ballpark uses OAuth, so your agent never sees your password and you can revoke access at any time.
You
Create a 10-minute unmoderated test of our new checkout prototype with 30 UK online shoppers who bought something on their phone this month
Agent
Drafted 6 tasks and 4 follow-up questions. Suggested audience: 41,200 matching panelists. Preview and launch: app.ballparkhq.com/…
03
Describe the study
Tell your agent what you want to learn. It drafts the study, suggests an audience from the panel, previews the cost, and gives you a link to review and launch in Ballpark.
Capabilities
What your agent can do in Ballpark
The same tools the Ballpark app uses, available to whichever assistant you already work in.
Draft studies
Turn a research goal into a full study with tasks, questions and screeners.
Refine in plain language
Ask for changes the way you would ask a colleague: make the tasks more specific, add a first-impressions question, drop the leading one.
Find an audience
Search a panel of over 3 million participants across 150 countries and get a matching audience for your study.
Preview the cost
See what a recruitment order would cost before you commit. Launching and payment happen in your Ballpark workspace.
Search your workspace
Find past studies by topic or name so your agent can build on what you already learned.
Query results
Ask questions about responses, watch the patterns emerge, and pull quotes and findings straight into your doc or ticket.
Prompts to try
Say it the way you would say it to a researcher
“
Draft a 5-question survey on why customers cancel, for people who churned in the last 60 days
“
Turn this research brief into an unmoderated prototype test with a screener for UK small business owners
“
Find 50 US parents of toddlers who shop online weekly and tell me what that audience costs
“
What did participants in my last onboarding study say about the permissions step?
FAQ
Frequently asked questions
Do I need an API key?
Which AI tools are supported?
Can my agent launch a study or spend money without me?
Is it safe to connect my workspace?
Can I use this with the API too?
Which clients show the interactive preview?
Building something bigger?
The developer docs cover the MCP tools, authentication and the GraphQL API.