Datapoint MCP

Get real human opinions from inside any MCP client. Run surveys, A/B preference comparisons, ratings, and rankings on text, images, audio, and video — without leaving your editor.

Datapoint MCP is an MCP server that gives Claude, GPT, Gemini, and any other MCP-capable agent the ability to recruit real humans for evaluation tasks, then return aggregated results back into the conversation. Built on top of Datapoint AI.

Why

LLMs are great at generating options and bad at telling you which one a real person will prefer. Datapoint MCP closes that loop — your agent can hand off to a panel of real humans and pick up the results a few minutes later.

Use cases

Design & UX — A/B test logos, landing pages, screens, ad creative, copy
AI evaluation — human ratings of model outputs, side-by-side comparisons, hallucination checks
Preference data — collect RLHF / DPO pairs at scale
Dataset labeling — classification, ranking, captioning, content moderation
Product research — quick concept tests, naming, pricing reads
Human-in-the-loop checks — gate an agent before it ships something irreversible

Tools

Tool	Description
`setup`	Authenticate with your Datapoint AI account (opens browser)
`upload_media`	Upload local images, audio, or video so they can be used in a survey
`plan_survey`	Design a survey from a natural language description
`create_survey`	Launch a survey from a plan
`check_survey`	Check status, progress, and aggregated results
`get_survey_responses`	Get raw per-annotator responses (paginated)
`list_surveys`	List all your surveys
`pause_survey`	Pause task serving for an active survey (in-flight responses keep arriving)
`resume_survey`	Resume task serving for a paused survey
`check_balance`	Check your account balance
`add_credits`	Open a checkout link to top up your account

Install

Requires uv on your PATH.

Claude Code

As a plugin (recommended):

/plugin marketplace add impel-intelligence/datapoint-mcp
/plugin install datapoint@datapoint

To pick up new versions: /plugin marketplace update datapoint then /plugin update datapoint@datapoint.

As a raw MCP server (in ~/.claude/settings.json):

{
  "mcpServers": {
    "datapoint": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/impel-intelligence/datapoint-mcp.git", "datapoint-mcp"]
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

{
  "mcpServers": {
    "datapoint": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/impel-intelligence/datapoint-mcp.git", "datapoint-mcp"]
    }
  }
}

Restart Claude Desktop, then ask it to run setup.

Cursor

Add to ~/.cursor/mcp.json (or via Settings → MCP):

{
  "mcpServers": {
    "datapoint": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/impel-intelligence/datapoint-mcp.git", "datapoint-mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "datapoint": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/impel-intelligence/datapoint-mcp.git", "datapoint-mcp"]
    }
  }
}

VS Code (GitHub Copilot Chat / agent mode)

Add to your workspace .vscode/mcp.json:

{
  "servers": {
    "datapoint": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/impel-intelligence/datapoint-mcp.git", "datapoint-mcp"]
    }
  }
}

Any other MCP client

Run the binary over stdio:

uvx --from git+https://github.com/impel-intelligence/datapoint-mcp.git datapoint-mcp

Usage

Once installed, just ask:

"Survey 20 people: which logo do they prefer, A or B?"

"Get human ratings on these three model outputs — which sounds most natural?"

"Run a quick A/B test on these two landing-page headlines."

The agent calls plan_survey to design it, shows you the plan and cost, then calls create_survey to launch. Use check_survey to monitor progress and read aggregated results.

Run setup first to authenticate if you haven't already.

Chain surveys (multi-step flow)

Some surveys have dependent questions — the second only makes sense given a specific answer to the first. Describe it that way and Claude will plan a chain:

"Ask 20 listeners if they could understand the speaker in this clip. If yes, rate the audio quality 1–5. If not, skip the rating."

A chain ties 2–5 steps together into a single unit of annotator work: every step is served to the same annotator, in order, and a per-step skip_if rule can terminate the walk early. Claude will show you the full chain structure (steps, any skip conditions, cost) and wait for your confirmation before calling create_survey.

The cost shown in plan_survey is the upper bound (every walk completes every step); when skip_if rules fire, walks cost proportionally less.

Configuration

Environment variable	Description
`DATAPOINT_API_KEY`	API key (overrides saved config)
`DATAPOINT_BASE_URL`	API base URL (default: `https://api.trydatapoint.com/data-labelling/v1`)

How it compares

	Datapoint MCP	Mechanical Turk	Prolific	UserTesting
Run from inside an AI agent / IDE	✅	❌	❌	❌
Designed for AI/LLM evaluation	✅	⚠️	⚠️	❌
Pay-as-you-go via API	✅	✅	✅	❌
Supports media (image / audio / video)	✅	✅	✅	✅
Minutes to first response	✅	⚠️	⚠️	❌

License

MIT — see LICENSE.

datapoint-mcp