MCP.Market

FirstHandAPI MCP server

by firsthandapi.com·com.firsthandapi/mcp-server·v0.3.1
No reviews yet

Post crowdsourced content collection jobs and fetch approved files via FirstHandAPI

C58/100grade C
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
C58/100

full report

Adoption
Growing

0 stars75 downloads/wk

Reviews

Write one

Nobody has reviewed FirstHandAPI yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

FirstHandAPI tools (8, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • cancel_jobwrite action

    Cancel a pending content collection job. Only works if not yet started by a contributor.

  • create_jobwrite action

    Create a human-in-the-loop (HITL) crowdsourced media collection job. Real human workers capture photos, video, audio, screen recordings, and screen captures. Use cases: UGC collection, ground truth data for AI evaluation, LLM training data, human verification of AI outputs. AI ensemble (Claude Vision + Whisper) auto-scores quality 1-5 stars. Approved files delivered via S3 with pre-signed URLs.

  • create_job_and_waitwrite action

    Create a human-in-the-loop crowdsourced media collection job and wait for completion. Real workers capture photos, video, audio, or screen recordings. AI scores quality. Returns approved files with download URLs. Best for UGC, ground truth, or training data collection workflows.

  • get_credits

    Get the current credit balance for the authenticated organization. Returns the balance in cents.

  • get_job

    Get the status of a human-in-the-loop media collection job. Returns job progress, AI quality scores, and approved file counts.

  • get_job_files

    Retrieve AI-scored and human-verified approved files (photos, video, audio, screen recordings) for a completed collection job, including pre-signed S3 download URLs and auto-generated annotation metadata (object labels, scene classification, OCR text extraction, color palettes, speaker counts, transcripts, and more).

  • list_jobs

    List recent human-in-the-loop media collection jobs. Shows status, AI quality scores, and file counts for each job.

  • signupwrite action

    Create a FirstHandAPI buyer account and receive an API key plus $2.50 in free credits.

Public scan report

scanner v0.1.10 · 2026-11-02 · same rubric, same numbers if you re-run it

no findings
  • Code scan7 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancerepository not readable: repo not found3/15
  • Maintainer identityverified namespace with website, no repo4/10
Overall 58/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How FirstHandAPI compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
58/100
higher than 13% of 48,255 servers
Tools
8
the typical server has 7
Tools that change things
50%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
75
more than 56% of 12,191 servers with a package

What its tools let an agent do: 4 read · 2 create · 1 change · 1 delete

Install FirstHandAPI in Claude Code, Cursor or VS Code

Runs npx -y @firsthandapi/mcp-server on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-server -- npx -y @firsthandapi/mcp-server
Add to Cursor

What the publisher says

From the FirstHandAPI repository's README, as published. We do not edit it. Read it on GitHub

ARCHIVED 2026-08-22 — FirstHandAPI is shut down and this server no longer works.

api.firsthandapi.com is permanently offline. Every tool in this MCP

server returns a network error, and the @firsthandapi/mcp-server npm

package is deprecated on all versions. The signup flow below cannot

issue keys.

Write-up of what was built and why it was killed:

Kept read-only as a reference implementation of an MCP server with a

keyless bootstrap tool.

@firsthandapi/mcp-server — FirstHandAPI MCP Server

Zero-to-job for agents (bootstrap mode)

No API key yet? Start the server anyway — it exposes a single signup tool:

npx @firsthandapi/mcp-server        # no env var needed

Call signup with an org_name and email to receive an API key and $2.50 in free credits (the key is shown once — save it), then restart configured:

claude mcp add firsthandapi -e FIRSTHAND_API_KEY=fh_live_... -- npx @firsthandapi/mcp-server

With the key set, all 7 job tools unlock: createjob, createjobandwait, getjob, listjobs, getjobfiles, canceljob, getcredits.

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

All job creation tools accept an optional location parameter: { city, state } for text-based or { latitude, longitude, radius_km } for coordinate-based constraints.

Environment Variables

  • FIRSTHANDAPIKEY (required) — Your API key
  • FIRSTHANDBASEURL (optional) — API base URL (default: https://api.firsthandapi.com)
  • FIRSTHANDTIMEOUTMS (optional) — Request timeout (default: 30000)

License

Proprietary

Nothing above is checked by us. What we check is on the safety report.

FirstHandAPI: common questions

Is FirstHandAPI MCP server safe?
With care: it is graded C, so read the findings first (58/100). Read the FirstHandAPI safety report
How do I install FirstHandAPI?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does FirstHandAPI need an API key?
Yes. The registry entry asks for FIRSTHAND_API_KEY.
Is FirstHandAPI maintained?
The last commit was 74 days ago (2026-08-22). The latest release is v0.3.1.
How does FirstHandAPI compare with other MCP servers?
safety score 58/100 (higher than 13% of 48,255 servers); tools 8 (the typical server has 7); tools that change things 50% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.