SupaThings MCP

Implementation Reference

• src/index.ts:1397-1419 (handler)

  The tool implementation for 'get-tagged-items' which filters tasks by tag from the database.

    "get-tagged-items",
    {
      tag: z.string().describe("Tag title to filter by"),
      detail: z.enum(["compact", "full"]).optional().describe("Response detail level. Defaults to compact."),
      limit: z.number().int().positive().optional().describe("Maximum number of items to return"),
    },
    async ({ tag, detail, limit }) => {
      const requestedDetail = detail ?? "compact";
      const items = await withDatabase((db) =>
        applyLimit(
          getAllTasks(db).filter(
            (task) => !task.trashed && task.tags.includes(tag)
          ),
          limit
        ).map((task) => toTaskView(task, requestedDetail))
      );
      return buildTextResponse(`Found ${items.length} items tagged "${tag}"`, {
        items,
        detail: requestedDetail,
        limit: limit ?? null,
      });
    }
  );