
Acme Todo
- Updated August 21, 2025
- ritza-co/acme-todo
Acme Todo MCP is a MCP server that exposes a simple todo list over streamable HTTP so you can validate MCP client integrations.
About
Acme Todo MCP is a deliberately simple Model Context Protocol server that backs a basic todo list, published by Ritza as a teaching remote for streamable-http MCP. Developers and agent developers use it to verify Claude Code, Cursor, or Codex can register a remote URL, list tools, and mutate state before trusting billing, auth, or data APIs. It belongs in Build under integrations: the value is proving your MCP pipeline, not shipping a task manager product. Connect to the hosted endpoint on mcp.ritzademo.com or study the ritza-co/acme-todo GitHub repo to mirror the pattern locally. Complexity is beginner—expect toy data and demo stability only. After it works, swap the URL for production servers using the same configuration steps. This is a developer-tools demo MCP, not a productivity suite or marketplace skill pack.
- Minimal todo-list MCP for learning and demos
- Hosted streamable-http at mcp.ritzademo.com
- Open-source reference github.com/ritza-co/acme-todo
- Version 1.0.0 on MCP schema 2025-09-29
- No local install required for the hosted remote
Acme Todo by the numbers
- Data as of Jul 7, 2026 (Skillselion catalog sync)
claude mcp add --transport http acme-todo https://mcp.ritzademo.com/mcp/ritza-rzx-our91Add your badge
Show developers this MCP server is listed on Skillselion. Paste this into your README.
| Transport | HTTP |
|---|---|
| Auth | None |
| Last updated | August 21, 2025 |
| Repository | ritza-co/acme-todo ↗ |
What it does
Learn and test MCP client wiring with a minimal hosted todo-list server before you connect production APIs.
Who is it for?
Best when you're learning MCP and want a zero-risk remote server and an open-source repo to copy patterns from.
Skip if: Skip if you need a real task system, multi-user auth, or SLA-backed production infrastructure.
What you get
You confirm tool calls and list CRUD against a harmless remote todo server, then reuse the same setup for real integrations.
- Working end-to-end MCP tool calls against a todo list
- Reusable integration pattern for swapping in production MCP URLs
By the numbers
- Server version 1.0.0
- Hosted remote path includes mcp.ritzademo.com (streamable-http)
- Reference repository: github.com/ritza-co/acme-todo
README.md
Simple Todo API - Flask Implementation
A Flask server implementation of the Simple Todo API defined in acmetodo.yaml.
Setup
- Install dependencies:
pip install -r requirements.txt
- Run the server:
python app.py
The server will start on http://localhost:5000
API Endpoints
GET /todos- List all todosPOST /todos- Create a new todoGET /todos/{id}- Get a specific todoPUT /todos/{id}- Replace a todoPATCH /todos/{id}- Update a todoDELETE /todos/{id}- Delete a todo
Example Usage
# List all todos
curl http://localhost:5000/todos
# Create a new todo
curl -X POST http://localhost:5000/todos \
-H "Content-Type: application/json" \
-d '{"title": "Buy groceries", "completed": false}'
# Get a specific todo
curl http://localhost:5000/todos/1
# Update a todo
curl -X PATCH http://localhost:5000/todos/1 \
-H "Content-Type: application/json" \
-d '{"completed": true}'
# Delete a todo
curl -X DELETE http://localhost:5000/todos/1
Data Format
Todos have the following structure:
id(integer, read-only) - Unique identifiertitle(string, required) - Todo titlecompleted(boolean, default: false) - Completion statusdueDate(string, optional) - Due date in YYYY-MM-DD format
Recommended MCP Servers
How it compares
Tutorial remote MCP demo, not a PM skill or enterprise todo SaaS.
FAQ
Who is com.ritzademo/acme-todo for?
Developers and developers learning MCP who need a tiny hosted server to test Claude Code, Cursor, or other clients before real APIs.
When should I use com.ritzademo/acme-todo?
Use it during Build when you are wiring your first remote MCP or debugging tool discovery and authentication flow with safe sample data.
How do I add com.ritzademo/acme-todo to my agent?
Add the remote MCP URL from the Ritza demo (streamable-http on mcp.ritzademo.com per the server manifest) in your client’s MCP config, or clone github.com/ritza-co/acme-todo to run your own instance.