Turn
Achieve infinite conversation turns in a single API request via turn-mcp. Self-hosted MCP server with browser console for human-in-the-loop AI agents.
What is Turn?
Turn is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to achieve infinite conversation turns in a single api request via turn-mcp. self-hosted mcp server with browser console for human-in-the-loop ai agents.
Achieve infinite conversation turns in a single API request via turn-mcp. Self-hosted MCP server with browser console for human-in-the-loop AI agents.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Achieve infinite conversation turns in a single API request
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx turnConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Turn
Turn MCP Server (turn-mcp) enables human-in-the-loop AI agents by providing infinite conversation turns within a single API request. It acts as a pause-and-resume checkpoint system, letting AI agents pause mid-task, surface a question or decision to a human via a browser console, wait for a reply, then continue execution without losing context. This makes it ideal for long-running agentic workflows where periodic human oversight or approval is required.
Prerequisites
- Node.js 18+ installed on the system that will run the server
- An MCP-compatible client such as Claude Desktop, Cursor, VS Code, or Claude Code
- Optional: Docker if you prefer containerized deployment
- Optional: TURN_MCP_API_KEY set if you want authenticated access to the server
Clone and build the server
Clone the turn-mcp repository and install dependencies, then build the TypeScript source.
git clone https://github.com/shiahonb777/turn-mcp
cd turn-mcp
npm install
npm run buildStart the server
Run the server using the platform-specific start script, or launch it directly with npm. By default it listens on port 3737.
npm start
# macOS: double-click start.command
# Windows: double-click start.bat
# Linux: bash start.shConfigure environment variables (optional)
Set environment variables to customize port, timeouts, authentication, and optional integrations such as Telegram or webhook notifications.
export TURN_MCP_HTTP_PORT=3737
export TURN_MCP_DEFAULT_TIMEOUT_SECONDS=600
export TURN_MCP_API_KEY=your_secret_key
export TURN_MCP_VIEWER_API_KEY=viewer_key
export TURN_MCP_WEBHOOK_URL=https://your-endpoint/hookConnect via HTTP transport (Cursor, VS Code, Claude Code)
For IDE-based MCP clients that support HTTP/SSE transport, point your client at the running server's /mcp endpoint.
{
"mcpServers": {
"turn-mcp": {
"url": "http://127.0.0.1:3737/mcp"
}
}
}Connect via stdio transport (Claude Desktop)
For desktop clients that spawn MCP servers as child processes, configure the stdio entrypoint.
{
"mcpServers": {
"turn-mcp": {
"command": "node",
"args": ["/path/to/turn-mcp/dist/server-stdio.js"]
}
}
}Open the browser console
Navigate to http://localhost:3737 in your browser. This is the human-facing console where you receive agent pause notifications and send replies to continue execution.
Turn Examples
Client configuration (HTTP transport)
HTTP transport configuration for Cursor, VS Code, or Claude Code pointing at the locally running turn-mcp server.
{
"mcpServers": {
"turn-mcp": {
"url": "http://127.0.0.1:3737/mcp"
}
}
}Prompts to try
Example prompts that exercise human-in-the-loop pause and resume workflows.
- "Research competitors for our product, pause and show me the list before writing the report"
- "Draft three different versions of this email, use turn.wait after each one so I can pick a direction"
- "Run the deployment checklist step by step; pause before any destructive operation and wait for my approval"
- "Analyze this dataset, summarize findings, then wait for my feedback before generating visualizations"Troubleshooting Turn
Agent times out waiting for a human reply
Increase TURN_MCP_DEFAULT_TIMEOUT_SECONDS (default is 600 seconds). Set it to a larger value like 3600 for tasks where human review may take longer.
Browser console shows 'Unauthorized' when connecting
You have set TURN_MCP_API_KEY. Open the console at http://localhost:3737 and enter the same key in the authentication dialog, or clear the env var to disable auth for local use.
IDE client cannot connect to the server
Verify the server is running with npm start and that port 3737 is not blocked by a firewall. Confirm your MCP client config uses url: "http://127.0.0.1:3737/mcp" for HTTP transport.
Frequently Asked Questions about Turn
What is Turn?
Turn is a Model Context Protocol (MCP) server that achieve infinite conversation turns in a single api request via turn-mcp. self-hosted mcp server with browser console for human-in-the-loop ai agents. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Turn?
Follow the installation instructions on the Turn GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Turn?
Turn works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Turn free to use?
Yes, Turn is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Turn Alternatives — Similar Coding Agents Servers
Looking for alternatives to Turn? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Turn in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Turn?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.