Advertise
MCP.so
Sign In

toyMCP To-Do List Server MCP Server

@izaqyos

Repository

Basic information

Category

Developer Tools

Transports

stdio

Author

izaqyos

About toyMCP To-Do List Server MCP Server

This is a simple example server implementing a To-Do list CRUD API using the Model Context Protocol (MCP) concepts, specifically using JSON-RPC 2.0 over HTTP. It uses Node.js, Express, and PostgreSQL (via Docker) for persistence.

toyMCP To-Do List Server MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "toyMCP": {
      "command": "docker",
      "args": [
        "compose",
        "up",
        "-d",
        "db"
      ]
    }
  }
}

toyMCP To-Do List Server MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is toyMCP To-Do List Server?

toyMCP To-Do List Server is a simple example server that implements a To-Do list CRUD API using the Model Context Protocol (MCP) concepts, specifically JSON-RPC 2.0 over HTTP. It uses Node.js, Express, and PostgreSQL (via Docker) for persistence, and includes an AI-powered agent framework for natural language interaction.

How to use toyMCP To-Do List Server?

Set up prerequisites: Node.js, npm, Docker, and Docker Compose. Clone the repository, run npm install, start PostgreSQL with docker compose up -d db, then start the server with npm start. The JSON-RPC endpoint is at http://localhost:3000/rpc. Authenticate by logging in at /auth/login with username and password to obtain a JWT token, then include it as an Authorization: Bearer <token> header in subsequent requests. Use curl to call methods like todo.list, todo.add, todo.remove, or mcp.discover. For natural language management, use the agent framework in the agent-framework/ directory.

Key features of toyMCP To-Do List Server

  • JSON-RPC 2.0 API over HTTP
  • CRUD operations for todo items
  • JWT-based authentication
  • PostgreSQL persistence via Docker
  • Interactive Swagger UI documentation
  • AI-powered natural language agent framework
  • Unit, integration, and end-to-end tests

Use cases of toyMCP To-Do List Server

  • Manage a personal todo list via API calls
  • Integrate with AI agents using natural language
  • Serve as a learning example for MCP and JSON-RPC
  • Automated testing of CRUD operations

Frequently asked questions

1

What is the default port and endpoint?

The server listens on port 3000 by default (configurable via the `PORT` environment variable), and the JSON-RPC endpoint is at `/rpc`.

2

How do I authenticate?

Send a POST request to `/auth/login` with your username and password. Copy the token from the response, then include it as an `Authorization: Bearer <token>` header in all subsequent requests to protected endpoints.

3

What are the available JSON-RPC methods?

The methods are `todo.list`, `todo.add`, `todo.remove`, and `mcp.discover` (which describes the service and its available methods).

4

What are the dependencies?

The server requires Node.js, npm, Docker, and Docker Compose for the PostgreSQL database. The agent framework can use local Ollama or OpenAI cloud models.

5

How can I reset the database?

Use the `clean_start.sh` script, which stops and removes the database container, restarts it, and then starts the server fresh.

Comments

More Developer Tools MCP servers

Eddyter AI Rich Text Editor MCP

EddyterAI

Set up and manage the Eddyter AI rich text editor by talking to your AI agent — for Claude, Cursor, Codex and other MCP tools. A Model Context Protocol server that lets AI tools add Eddyter to a React, Next.js, Vite or R

9

Jaybird Digital

Steve Wheeler

Jaybird Digital lets you build a website for you in the conversation. Tell your ai about your business and what you want, and it writes the pages and saves them to Jaybird. You get a link to view the site right away, wi

directree

coburn2716

directree MCP server — query the honest software directory from any AI assistant

Perfex CRM

themesic

Turn Perfex CRM into an AI-ready workspace. This MCP server exposes your full REST API to Claude, ChatGPT and any AI agent, so leads, invoices and tasks are one prompt away.

1

offprompt

offprompt

MCP server that lets Claude Code, Cursor or Codex ask you for API keys on a local page and write them to .env. The agent only ever sees key names.

2
Advertise