ballparkhq.com
Ballpark is a research platform for creating and running surveys, usability tests, prototype tests, video feedback, and related studies. It serves product, marketing, consumer, and brand research teams and also offers AI-assisted workflows.
Ballpark exposes a GraphQL API authenticated by personal access tokens or OAuth 2.0, plus a streamable-HTTP MCP server at `https://edge.ballparkhq.com/api/mcp` that supports unauthenticated drafting/preview and OAuth for publishing to a workspace.
- Ballpark MCP serverdiscovered
- Ballpark GraphQL APIdiscovered
Sign in to your Ballpark account, then open Personal access token generator and generate a token for local development or internal scripts. Send it as Authorization: Bearer <token>. The docs state these tokens do not expire, so revoke them from your account settings if compromised.
Register an application at Ballpark OAuth applications. Ballpark supports OAuth 2.0 with optional PKCE for native/client-side apps. Use the authorization_code flow for confidential clients, or authorization_code + PKCE for public/native apps that need refresh tokens. Tokens are then used as Authorization: Bearer <access_token> when calling the API.
conventions · 1/8 published
- integrations.json✗
/.well-known/integrations.json - llms.txt✓https://ballparkhq.com/llms.txt
- API catalog✗
/.well-known/api-catalog - OpenAPI document✗
/api/schema/, /openapi.json, /swagger.json, /api/openapi.json, or /v1/openapi.json - MCP server card✗
/.well-known/mcp/server-card.json - OAuth protected resource✗
/.well-known/oauth-protected-resource - Agent card✗
/.well-known/agent-card.json - Agent skills✗
/.well-known/agent-skills/index.json
Publish these signals → /publishing