{
  "serverInfo": {
    "name": "listomancy",
    "title": "Listomancy",
    "version": "1.0.0"
  },
  "description": "Search Listomancy's hand-written checklists and routines, read them as structured data, and publish new lists behind a shareable link (exports to Markdown, Todoist CSV and text).",
  "transport": {
    "type": "streamable-http",
    "url": "https://listomancy.com/mcp"
  },
  "capabilities": {
    "tools": true
  },
  "authentication": {
    "required": false,
    "schemes": [
      "bearer"
    ],
    "description": "No key needed to read or to create a few lists. Call the register_agent tool for an API key with higher limits."
  },
  "tools": [
    {
      "name": "search_lists",
      "description": "Search Listomancy's hand-written checklists and routines by words (every word must match the title, description or an item). Empty query lists them all. Returns title, description, item count and the page URL."
    },
    {
      "name": "get_list",
      "description": "Full content of one list by slug (the last part of its URL): sections with their items, plus the page, Markdown, Todoist CSV and text export URLs, the embed URL and a QR code URL."
    },
    {
      "name": "create_list",
      "description": "Publish a new list and get its public link (page, exports, QR). Give either \"items\" (flat) or \"sections\" (grouped). Lists are immutable and unlisted (not indexed, not in the catalogue); to change one, create a new one with from_slug. Without an API key: 5 lists per day; with a key from register_agent: 50."
    },
    {
      "name": "register_agent",
      "description": "Optional. Issue an API key for your agent (shown once, keep it) and send it as \"Authorization: Bearer <key>\" to get higher rate limits (120 requests per minute, 50 created lists per day). Not needed to read or to create a few lists."
    }
  ],
  "documentation": "https://listomancy.com/agents",
  "openapi": "https://listomancy.com/openapi.json",
  "contact": "contact@listomancy.com"
}