@firsthandapi/mcp-server — Servidor MCP de FirstHand

De cero a empleo para agentes (modo bootstrap)

¿Aún no tienes clave de API? Inicia el servidor igualmente — expone una única herramienta signup:

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

Llama a signup con un org_name y un email para recibir una clave de API y $2.50 en créditos gratuitos (la clave se muestra una sola vez — guárdala), luego reinicia con la configuración:

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

Con la clave configurada, se desbloquean las 7 herramientas de trabajos: create_job, create_job_and_wait, get_job, list_jobs, get_job_files, cancel_job, get_credits.

Servidor MCP oficial para FirstHandAPI — recopilación de datos colaborativa con intervención humana (HITL). Permite que Claude Code, Cursor y otros agentes de IA recopilen fotos, audio, video y grabaciones de pantalla de trabajadores humanos reales con puntuación de calidad automatizada por IA.

Casos de uso: recopilación de contenido generado por usuarios (UGC), datos de referencia para evaluación de IA, datos de entrenamiento para modelos multimodales.

Related MCP server: simple-fal-mcp

Instalación

npm install @firsthandapi/mcp-server

Configuración

Claude Code

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

Cursor

Agrega a .cursor/mcp.json:

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

Herramientas

Todas las herramientas de creación de trabajos aceptan un parámetro opcional location: { city, state } para restricciones basadas en texto o { latitude, longitude, radius_km } para restricciones basadas en coordenadas.

Variables de entorno

• FIRSTHAND_API_KEY (obligatoria) — Tu clave de API

• FIRSTHAND_BASE_URL (opcional) — URL base de la API (predeterminada: https://api.firsthandapi.com)

• FIRSTHAND_TIMEOUT_MS (opcional) — Tiempo de espera de las solicitudes (predeterminado: 30000)

Licencia

Propietaria