Progress Demo

Built with mcp-use  

Showcase of ctx.reportProgress, server.sendNotification, ctx.elicit(), and ctx.sample(). Demonstrates long-running tasks with live progress bars, user confirmation dialogs, LLM sampling, and error handling patterns.

Try it now

Connect to the hosted instance:

https://crimson-river-pzsz1.run.mcp-use.com/mcp

Or open the Inspector to test it interactively.

Setup on ChatGPT

1. Open Settings > Apps and Connectors > Advanced Settings and enable Developer Mode
2. Go to Connectors > Create, name it "Progress Demo", paste the URL above
3. In a new chat, click + > More and select the Progress Demo connector

Setup on Claude

1. Open Settings > Connectors > Add custom connector
2. Paste the URL above and save

Features

• Progress reporting — ctx.reportProgress with live progress bar widget
• Elicitation — ctx.elicit() for user confirmation before destructive actions
• Sampling — ctx.sample() to call the LLM from within a tool
• Notifications — server.sendNotification for real-time alerts
• Error handling — graceful error patterns with ErrorBoundary

Tools

Tool	Description
process-data	Long-running task with progress reporting and live widget
fetch-report	Fetch a report using LLM sampling
delete-dataset	Destructive action requiring user confirmation via elicitation
search-external	External search with notification on completion
failing-tool	Intentionally failing tool to demonstrate error handling

Available Widgets

Widget	Preview
progress-view

Local development

git clone https://github.com/mcp-use/mcp-progress-demo.git
cd mcp-progress-demo
npm install
npm run dev

Deploy

npx mcp-use deploy

Built with

• mcp-use — MCP server framework

License

MIT