unstuck-ai
@dtdannen
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.
More Other MCP servers
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
Awesome Mlops
visengerA curated list of references for MLOps
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Nginx UI
0xJackyYet another WebUI for Nginx
Unity MCP ✨
justinpbarnettUnity 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.
Comments