unstuck-ai

Name: unstuck-ai
Author: dtdannen

@dtdannen

Repository Homepage

About unstuck-ai

MCP Server to ask humans for help

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "unstuckmcp": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is unstuck-ai?

unstuck-ai is an MCP server that enables AI agents to instantly pay humans sats (Bitcoin) to solve visual roadblocks such as captchas, web navigation, and computer use tasks. It operates via a Nostr marketplace and includes both the MCP server and a web app where humans can bid on tasks, complete them, and receive payment.

How to use unstuck-ai?

Set up the MCP server by installing dependencies (cd mcp_server && pip install -r requirements.txt), configuring environment variables in mcp_server/.env (Digital Ocean Spaces credentials and a Nostr Wallet Connect string), then start the server with fastmcp run unstuck_ai/server.py:mcp --transport sse. In another terminal, run goose session --with-remote-extension http://127.0.0.1:8000/sse and prompt Goose to use the unstuck-ai tool for visual help.

Key features of unstuck-ai

AI agents pay humans sats for visual task assistance
Integrates with Nostr protocol for marketplace communication
Includes a web app job board and workspace for humans
Supports screenshot uploads via Digital Ocean Spaces or any boto3 provider
Uses kind 5109/6109 Nostr events for task requests and responses
Compatible with Block's Goose (version 1.0.x+) via remote MCP extension

Use cases of unstuck-ai

AI agent needing human help to solve a captcha during a workflow
Agent stuck on web page navigation (e.g., clicking a button, filling a form)
Agent requiring human assistance for computer‑use tasks like opening an application

FAQ from unstuck-ai

What is the Nostr event kind used?

The MCP server sends a kind 5109 event to request visual computer interaction help and listens for kind 7000 events with invoices and prices from humans.

What credentials are required?

You need a Nostr private key (for the AI agent), a Nostr Wallet Connect string (to pay invoices), and Digital Ocean Spaces credentials (or any boto3 provider for screenshot storage).

Can I use this with any MCP client?

The README provides instructions specifically for Block's Goose. It is an MCP server, so it may work with other MCP‑compatible clients, but only Goose setup is documented.

Is the project fully complete?

No. The README lists many development items marked as incomplete, including executing the human's action automatically (clicking, dragging) and moving screenshot hosting to a Blossom server.

How does a human get paid?

A human selects a job on the web app, generates a Lightning invoice for the amount, broadcasts a kind 7000 event, and once the AI agent pays the invoice, the human sends the result.

Comments

More Other MCP servers

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K