@firsthandapi/mcp-server — FirstHandAPI MCP Server

От нуля до задания для агентов (режим начальной загрузки)

Ещё нет API-ключа? Всё равно запустите сервер — он предоставляет единственный инструмент signup:

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

Вызовите signup с org_name и email, чтобы получить API-ключ и $2.50 бесплатных кредитов (ключ показывается один раз — сохраните его), затем перезапустите с настройками:

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

С установленным ключом открываются все 7 инструментов для заданий: create_job, create_job_and_wait, get_job, list_jobs, get_job_files, cancel_job, get_credits.

Официальный MCP сервер для FirstHandAPI — краудсорсинговый сбор данных с участием человека (HITL). Позволяет Claude Code, Cursor и другим ИИ-агентам собирать фото, аудио, видео и записи экрана от реальных работников с автоматической оценкой качества на основе ИИ.

Варианты использования: сбор пользовательского контента (UGC), эталонные данные для оценки ИИ, обучающие данные для мультимодальных моделей LLM.

Related MCP server: simple-fal-mcp

Установка

npm install @firsthandapi/mcp-server

Конфигурация

Claude Code

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

Cursor

Добавьте в .cursor/mcp.json:

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

Инструменты

Все инструменты создания заданий принимают необязательный параметр location: { city, state } для текстовых или { latitude, longitude, radius_km } для координатных ограничений.

Переменные окружения

• FIRSTHAND_API_KEY (обязательно) — Ваш API-ключ

• FIRSTHAND_BASE_URL (необязательно) — Базовый URL API (по умолчанию: https://api.firsthandapi.com)

• FIRSTHAND_TIMEOUT_MS (необязательно) — Тайм-аут запроса (по умолчанию: 30000)

Лицензия

Проприетарная