Testable MCP for your AI app

You do not need to learn the interface. Tell ChatGPT, Claude or Grok what you need and it does the work in your Testable account.

Connect in 3 steps

• ChatGPT steps
• Claude steps
• Grok steps

You ask

Build a Flanker task in Testable: 8 practice and 96 test trials, keys F and J.

Example

You getFlanker tasktrial fileValidated

Example trial file rows

#Row	type	stim1	key	condition1
1	instructions
2	practice	>>>>>	j	congruent
3	practice	>><>>	f	incongruent
⋮	rows 4 to 9
10	test	<<><<	j	incongruent
⋮	rows 11 to 105

105 rowsinstructions, 8 practice, 96 test

What is MCP?MCP (Model Context Protocol) is the open standard that lets an AI app work inside another service. Testable Magic is the AI inside Testable. Testable MCP connects your own AI app to all your projects.

Connect your app

Three steps, once per app. No code.

• ChatGPT
• Claude
• Grok

ChatGPT

1. Add Testable

   Open chatgpt.com/plugins, select +, then Add custom MCP server. Fill in the form.

   Name

   Testable

   Server URL

   https://testable.org/mcpCopy the server URL

   Authentication

   OAuth

2. Install and sign in

   Select Create as a plugin, then install it from your personal plugins. ChatGPT opens Testable. Sign in and click Connect.

3. Ask

   In a new chat, type @ and pick Testable.

   List my Testable projects.

ChatGPT shows a notice for every custom server. Select I understand and want to continue. Menus look different? See the OpenAI guide to custom MCP servers.

Claude

1. Add Testable

   Open Customize, then Connectors, click + Add, then Add custom connector. Fill in the form.

   Name

   Testable

   Server URL

   https://testable.org/mcpCopy the server URL

2. Sign in

   Claude opens Testable. Sign in and click Connect.

3. Ask

   In a chat, open the + menu, choose Connectors and switch Testable on.

   List my Testable projects.

Works in Claude on the web and on the desktop. No option to add one? See the Anthropic guide to custom connectors.

Grok

1. Add Testable

   Open grok.com/connectors, click New Connector, then Custom. Fill in the form.

   Name

   Testable

   Server URL

   https://testable.org/mcpCopy the server URL

2. Sign in

   Grok opens Testable. Sign in and click Connect.

3. Ask

   In a new chat, ask for your projects.

   List my Testable projects.

Menus look different? See the Grok guide to connectors.

When your app lists your projects, you are connected. Any other app that supports remote MCP uses the same address.

What to ask

Say it as you would to a colleague. Name Testable and your project.

• BuildCreate a Testable project with a Stroop task: 4 practice and 40 test trials, keyboard responses.Copy the Build prompt
• EditCopy my Testable project "Go/No-go v2" and add 4 practice trials with feedback at the start.Copy the Edit prompt
• AnalyzeIn my Testable project "Stroop online", how many participants finished, and what are mean RT and accuracy by condition?Copy the Analyze prompt
• RecruitHow many respondents has my Testable Minds study for "Stroop online" collected so far?Copy the Recruit prompt

Any paradigm, custom tasks too

Classic tasks import ready-made from the Testable library. For anything else, your AI app writes the task as an HTML page.

1. mousetrack.html

   Your AI app writes it and uploads the page as a stimulus.

2. Participant view

   fishmammalwhale

   Participants see it as a trial, like any other.

3. Results

   response

   mammal

   path_points

   46

   The Testable SDK saves it in your results, with your extra columns.

Example: a mouse tracking task. Custom HTML stimuli reference

Built-in safeguards

• Your AI app acts as youIt sees only the projects you own or collaborate on.

• Technical identifiers stay withheldIP address, browser session id and completion code never reach your AI app.

• Live studies with results change only after you confirmUntil you do, Testable refuses the change.

• Testable Minds stays read-onlyYour AI app reads budget, studies, sessions and respondents.

For your ethics application: the responses you ask about go to the AI app you chose, under its terms. IP addresses, session ids and completion codes never do. Testable MCP connector lists every field the tools can return. Disconnect an app at any time under Account, then Testable MCP.

In a terminal or code editor

Claude Code, Codex and CursorSetup prompt, commands and tokens

Paste this into your coding agent. It asks you before it changes a config file.

Connect Testable (testable.org) to this agent. Read https://testable.org/docs/ai-agents/setup.md and follow the steps for the agent you are. Ask me before you change any config file. When it is done, run the "whoami" tool to check the connection.

Copy setup prompt

Claude Code

claude mcp add --transport http testable https://testable.org/mcp

Then run /mcp, choose testable and sign in through the browser.

Codex

codex mcp add testable --url https://testable.org/mcp

Sign in when Codex asks. If it does not, run codex mcp login testable.

Cursor

{
  "mcpServers": {
    "testable": {
      "url": "https://testable.org/mcp"
    }
  }
}

Add it to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project.

For a script with no browser, create a token under Account, then AI agents and send it as Authorization: Bearer <token>.

Ask AI about this page

Open this page in the AI app you use.

• ChatGPT (opens in a new tab)
• Claude (opens in a new tab)
• Grok (opens in a new tab)
• Gemini (opens in a new tab)

Message box empty? Copy the prompt

Read https://testable.org/docs/getting-started/use-testable-with-ai-agents/ and explain it to me as a researcher who runs online experiments on Testable: what Testable MCP lets my AI app do in my Testable account, how I connect the AI app I use, and how my projects and my participants' data stay protected. End with the first prompt I should try.

Copy prompt