@firsthandapi/mcp-server
This server is an archived MCP server for FirstHandAPI that originally let agents sign up for an API key and then manage human-in-the-loop data collection jobs; the service is now shut down and every tool returns a network error.
Bootstrap signup (no API key needed): call
signupwithorg_nameandemailto create an account, receive an API key, and get $2.50 in free credits (key shown once).Job creation:
create_jobposts a content collection job;create_job_and_waitposts and waits for completion.Job management:
get_jobfetches status/details,list_jobslists jobs with filters,cancel_jobcancels an open job.Result retrieval:
get_job_filesgets approved files with download URLs.Account/balance:
get_creditschecks the credit balance.Location constraints: job creation tools optionally accept
{ city, state }or{ latitude, longitude, radius_km }.Configuration: uses
FIRSTHAND_API_KEY(required for job tools), with optionalFIRSTHAND_BASE_URLandFIRSTHAND_TIMEOUT_MS.Deprecated: the project was archived 2026-08-22;
api.firsthandapi.comis permanently offline and the npm package is deprecated.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@firsthandapi/mcp-server create a job to collect 10 photos of dogs in Central Park"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ARCHIVED 2026-08-22 — FirstHandAPI is shut down and this server no longer works.
api.firsthandapi.comis permanently offline. Every tool in this MCP server returns a network error, and the@firsthandapi/mcp-servernpm package is deprecated on all versions. Thesignupflow below cannot issue keys.Write-up of what was built and why it was killed: https://jjfisher.dev/writing/2026-w34-firsthandapi-postmortem
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 neededCall 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-serverWith the key set, all 7 job tools unlock: create_job, create_job_and_wait,
get_job, list_jobs, get_job_files, cancel_job, get_credits.
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.
Related MCP server: simple-fal-mcp
Installation
npm install @firsthandapi/mcp-serverConfiguration
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 |
| Post a content collection job |
| Get job status and details |
| Post a job and wait for completion |
| List all jobs with filters |
| Cancel an open job |
| Get approved files with download URLs |
| Check credit balance |
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
FIRSTHAND_API_KEY(required) — Your API keyFIRSTHAND_BASE_URL(optional) — API base URL (default: https://api.firsthandapi.com)FIRSTHAND_TIMEOUT_MS(optional) — Request timeout (default: 30000)
License
Proprietary
Available Tools
1 toolsignupA
Create a FirstHandAPI buyer account and receive an API key plus $2.50 in free credits. Use this when the server is running without FIRSTHAND_API_KEY. The key is shown ONCE — store it, then restart the MCP server with FIRSTHAND_API_KEY set to unlock the job tools.
Inputs: email (required), org_name (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
Only one tool exists, so there is no possibility of confusion or overlap. Its purpose is clearly defined as account creation and API key retrieval.
With a single tool, naming is perfectly consistent by definition. The verb-form 'signup' is clear and unambiguous, even if it doesn't follow a verb_noun pattern.
The server's own description mentions 'job tools' that will be unlocked after restart, yet only signup is exposed. A single tool is too few for the apparent broader API scope, making the tool set feel thin and incomplete.
The server is described as a FirstHandAPI MCP server with the intent to provide job tools, but only signup is available. This creates a severe gap—users can create an account but cannot perform any actual job operations, leaving the advertised surface almost entirely absent.
Related MCP Connectors
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
MCP Server for an Agent Task Marketplace
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for instruckt visual annotations. Enables AI agents to retrieve pending annotations, view screenshots, and resolve annotations.3106 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for fal model discovery, execution, pricing, and local media processing, enabling AI model workflows via natural language.153 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server for AgentHire, an AI talent marketplace enabling agents to browse jobs, apply, manage interviews, and handle offers. Supports employer job creation, candidate matching, and compliance tips.6 npmMIT
- FlicenseBqualityDmaintenanceMCP server for building a user-approved transcript corpus from Handy, optimizing post-processing prompts against LM Studio, and promoting winning inference settings.19-