@firsthandapi/mcp-server — FirstHandAPI MCP Server

Official MCP server for FirstHandAPI — human-in-the-loop (HITL) crowdsourced data collection. Enables Claude Code, Cursor, and other AI agents to collect photos, audio, video, and screen recordings from real human workers with automated AI quality scoring.

Use cases: UGC collection, ground truth data for AI evaluation, LLM training data for multimodal models.

Installation

npm install @firsthandapi/mcp-server

Configuration

Claude Code

{
  "mcpServers": {
    "firsthand": {
      "command": "npx",
      "args": ["@firsthandapi/mcp-server"],
      "env": {
        "FIRSTHAND_API_KEY": "fh_live_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "firsthand": {
    "command": "npx @firsthandapi/mcp-server",
    "env": { "FIRSTHAND_API_KEY": "fh_live_..." }
  }
}

Tools

| Tool | Description | |------|-------------| | create_job | Post a content collection job | | get_job | Get job status and details | | create_job_and_wait | Post a job and wait for completion | | list_jobs | List all jobs with filters | | cancel_job | Cancel an open job | | get_job_files | Get approved files with download URLs | | get_credits | Check credit balance |

Environment Variables

• FIRSTHAND_API_KEY (required) — Your API key
• FIRSTHAND_BASE_URL (optional) — API base URL (default: https://api.firsthandapi.com)
• FIRSTHAND_TIMEOUT_MS (optional) — Request timeout (default: 30000)

License

Proprietary