Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
ritza-co avatar

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)
terminal
claude mcp add --transport http acme-todo https://mcp.ritzademo.com/mcp/ritza-rzx-our91

Add your badge

Show developers this MCP server is listed on Skillselion. Paste this into your README.

Listed on Skillselion
TransportHTTP
AuthNone
Last updatedAugust 21, 2025
Repositoryritza-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

  1. Install dependencies:
pip install -r requirements.txt
  1. Run the server:
python app.py

The server will start on http://localhost:5000

API Endpoints

  • GET /todos - List all todos
  • POST /todos - Create a new todo
  • GET /todos/{id} - Get a specific todo
  • PUT /todos/{id} - Replace a todo
  • PATCH /todos/{id} - Update a todo
  • DELETE /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 identifier
  • title (string, required) - Todo title
  • completed (boolean, default: false) - Completion status
  • dueDate (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.

Developer Toolsintegrationstesting

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.