
turn-mcp
by shiahonb777·★ 24·Score 43
MCP server that enables infinite conversation turns in a single API request with human-in-the-loop capabilities.
Overview
turn-mcp-web is a self-hosted MCP server that transforms single agent requests into durable human-in-the-loop conversations. It provides tools like 'turn.wait' that pause execution and allow humans to respond through a browser console, with the same agent run continuing afterward. This approach maintains context across checkpoints, making it valuable for approvals, branching decisions, operator handoffs, review queues, and long-running workflows. The server supports multiple client connection methods including HTTP transport for IDE MCP clients, stdio for desktop clients, and a REST long-poll API for non-MCP frameworks.
Try asking AI
After installing, here are 7 things you can ask your AI assistant:
When to choose this
Choose turn-mcp when you need to maintain context across human intervention points in AI workflows, particularly for approval processes or branching decisions where restarting the conversation would lose state.
When NOT to choose this
Avoid this server if you need high-volume human-in-the-loop interactions (limited by max concurrent waits per session) or require a fully managed cloud solution without self-hosting.
Tools this server exposes
3 tools extracted from the READMEturn.waitPauses agent execution to wait for human input in the browser console
turn_waitAlternative alias for turn.wait to pause agent execution
turnShort alias for turn.wait to pause agent execution
Comparable tools
Installation
Quick Start
macOS
Double-click start.command
Windows
Double-click start.bat
Linux
bash start.shFrom Source
npm install
npm run build
npm start**MCP Configuration for Claude Desktop:**
{
"mcpServers": {
"turn-mcp-web": {
"url": "http://127.0.0.1:3737/mcp"
}
}
}FAQ
- What does 'infinite conversation turns' mean?
- It means maintaining context across multiple human-AI interactions within a single continuous agent execution, rather than starting a new conversation for each interaction.
- What MCP tools are provided?
- The server provides MCP tool aliases: `turn.wait`, `turn_wait`, and `turn` - all referring to the same pause-and-wait-for-human-reply functionality.
- Can I use this with non-MCP frameworks?
- Yes, it includes a REST long-poll API and a Python client for integrating with frameworks that don't support MCP directly.
Compare turn-mcp with
Last updated · Auto-generated from public README + GitHub signals.