humanbottasks

io.github.humanbottasksPublished by GitHub account humanbottasksv0.1.2Updated Nov 7, 2026

Human fallback for AI agents: delegate tasks to a human over MCP.

VerifiedSTDIODesktop onlyAI & ML

Overview

humanbottasks's local MCP server; no sign-in required; STDIO; 2 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open humanbottasks in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

humanbottasks

mcp-name: io.github.humanbottasks/humanbottasks

Gemanagter Human-Service-Layer fuer AI-Agenten. Ein AI-Agent delegiert ueber MCP eine Aufgabe, die er nicht selbst kann, an einen Menschen; der Mensch erledigt sie, der Agent ruft das Ergebnis ab.

MVP-Status

  • server.py MCP-Server (Tools: request_human_task, get_task_status)
  • store.py SQLite-Queue (tasks.db)
  • fulfill.py CLI fuer den Menschen (Tasks ansehen/erledigen)
  • demo.py End-to-End-Demo (Agent -> Task -> Mensch -> Ergebnis)
  • test_smoke.py Smoke-Test

Setup & Start

cd humanbottasksunset PYTHONPATHuv venvuv pip install "mcp<2"uv run server.py

Transporte

uv run server.py                                  # stdio (Claude Desktop, Cursor, lokale Frameworks)uv run server.py --transport streamable-http      # HTTP-Endpoint http://127.0.0.1:8000/mcp (lokal/Remote-Agents)uv run server.py --transport sse                  # Legacy-SSE http://127.0.0.1:8000/sse

Host/Port via Umgebungsvariablen: HBT_HOST (default 127.0.0.1), HBT_PORT (default 8000). Fuer Remote-Zugriff: HBT_HOST=0.0.0.0 setzen.

Install (fuer andere Builder, 1 Zeile)

uvx humanbottasks

Guide (Englisch)

  • GUIDE.md — Einfuehrung, Task-Typen, Beispiel-Loop, Transports
  • INTEGRATIONS.md — LangChain / CrewAI / n8n / Dify Beispiele

Task-Typen

verification · physical_action · subjective_judgment · ground_truth_labeling · prove_human

MCP-Clients (installiert + konfiguriert)

  • Claude Desktop: C:\Users\marku\AppData\Roaming\Claude\claude_desktop_config.json
  • Cursor: C:\Users\marku\.cursor\mcp.json
  • Windsurf: C:\Users\marku\.codeium\windsurf\mcp_config.json
  • Templates in config/ (falls neu einrichten noetig)

Naechste Schritte (Reihenfolge)

  1. Nachfrage-Test: Server laeuft, ein echter Agent ruft request_human_task.
  2. Website/Landing fuer Agent-Builder.
  3. Payments (Stripe/Circle) erst, wenn Nachfrage da ist.

Source: README.md at commit 299a236

Tools

2

request_human_task

Delegiere eine Aufgabe an einen menschlichen Arbeiter. Nutze das fuer alles, was du als KI nicht selbst erledigen kannst: physische Aktionen, Verifikation, subjektive Urteile oder Ground-Truth-Labeling. Args: task_type: Eine von 'verification', 'physical_action', 'subjective_judgment', 'ground_truth_labeling', 'prove_human'. description: Klare, konkrete Beschreibung der Aufgabe. max_price_usd: Maximalpreis in USD, den du bereit bist zu zahlen. Returns: Eine task_id, mit der du den Status abfragen kannst.

Parameterstask_typerequireddescriptionrequiredmax_price_usd

get_task_status

Status und Ergebnis einer delegierten Task abfragen. Args: task_id: Die task_id aus request_human_task. Returns: 'pending'/'done' plus Ergebnis, wenn fertig.

Parameterstask_idrequired

Version history

1
  1. v0.1.2LatestNov 3, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts