Omnispindle is the coordination spine of the Madness Interactive ecosystem — a Python FastMCP server with 38 tools that lets AI agents manage tasks, capture knowledge, coordinate sessions, track…
FastMCP Todo Server is an MCP project maintained in the danedens/omnispindle repository. The maintainer describes its purpose as “Omnispindle is the coordination spine of the Madness Interactive ecosystem — a Python FastMCP server with 38 tools that lets AI agents manage tasks, capture…”. Read the project documentation for the complete scope.
The project provides a local client configuration using omnispindle-stdio. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares OMNISPINDLE_MODE, OMNISPINDLE_TOOL_LOADOUT, MCP_USER_EMAIL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| add_todo | Create a task with project, priority, target agent, notes, and metadata |
| query_todos | MongoDB-style filter queries with projection, limit, offset, since change detection, and graph_root for dependency subgraph traversal |
| update_todo | Patch any fields; metadata is deep-merged. Supports $push/$pull on array fields (e.g. metadata.blockers) for dependency linking |
| delete_todo | Remove a task |
| get_todo | Fetch a single task by ID |
| complete_todo | Stage for review with optional comment; writes to audit log. Sets status to review, not completed |
| list_todos_by_status | Filter by status: pending initial in_progress blocked review completed |
| search_todos | Tokenized multi-word fuzzy text search |
| list_project_todos | Recent tasks for a specific project |
| add_lesson | Capture a lesson with language, topic, and tags |
| get_lesson | Fetch by ID |
| update_lesson | Patch lesson content or metadata |
| delete_lesson | Remove |
| search_lessons | Text search across lesson fields |
| grep_lessons | Regex pattern search |
| list_lessons | Browse all lessons, with brief mode for summaries |
| inventorium_sessions_list | List sessions, optionally filtered by project |
| inventorium_sessions_get | Fetch a session by ID |
| inventorium_sessions_create | Start a new AI work session |
| inventorium_sessions_spawn | Spawn a child session from a parent, linked to a todo |
| inventorium_sessions_fork | Fork a session with optional message inheritance |
| inventorium_sessions_genealogy | Full ancestor/descendant trace for a session |
| inventorium_sessions_tree | Visual session tree for a project |
| inventorium_todos_link_session | Link a todo to a session |
| create_quest | Create an epic goal container (Quest → Chains → Todos). Use instead of add_todo for multi-step objectives |
| check_quest | Progress report: % complete, per-chain status, next actions, blockers. Agent orientation tool |
| list_quests | List quests filtered by status/project |
| link_quest | Add an existing todo to a quest chain retroactively (creates chain on demand) |
| update_quest | Update quest fields: name, description, status, success_criteria, metadata |
| get_context_bundle | One call: recent todos, lessons, session state, project stats for an agent's working context |
| find_relevant | Semantic similarity search across todos and lessons. Returns honest empty when nothing clears the relevance threshold — no regex fallback noise |
| preflight_rag | Pre-task lessons check: call before starting work, classifies past solutions vs pitfalls |
| query_todo_logs | Audit log queries: filter by type, project, date range |
| list_projects | Enumerate known projects from filesystem |
| point_out_obvious | Logs an observation with configurable sarcasm. Useful for marking known issues during automated runs. |
| bring_your_own | Inject a Python, JavaScript, or shell function as a live MCP tool at runtime |
| Loadout | Tools |
| full | 38 |
| basic | 15 |
| minimal | 4 |
| lessons | 8 |
| admin | 16 |
| write_only | 6 |
| read_only | 16 |
| lightweight | 13 |
| agent_preflight | 6 |
| refine | 13 |
{
"mcpServers": {
"omnispindle": {
"command": "omnispindle-stdio",
"env": {
"OMNISPINDLE_MODE": "api",
"OMNISPINDLE_TOOL_LOADOUT": "basic",
"MCP_USER_EMAIL": "you@example.com"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| OMNISPINDLE_MODE | Declared in the maintainer’s client configuration. | Check documentation |
| OMNISPINDLE_TOOL_LOADOUT | Declared in the maintainer’s client configuration. | Check documentation |
| MCP_USER_EMAIL | Declared in the maintainer’s client configuration. | Yes |
Queries the NIST National Vulnerability Database (NVD) via its API.
Scans projects for security vulnerabilities and automatically updates vulnerable dependencies using Trivy.
Search 1,032 verified smart contract vulnerability findings from Sherlock audits by pattern.
Remote MCP for A2A dependency inspector MCP, structured receipts, audit logs, and reviewer-ready evi
Remote MCP for A2A failure replay MCP, structured receipts, audit logs, and reviewer-ready evidence.
A comprehensive Model Context Protocol (MCP) server for ABP.IO framework with 48+ tools for application development, UI generation, and management