# bundlist

Manage personal lists with custom fields. Create and organize lists, add and update items with structured field data, and search your content — all without leaving your AI assistant.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add bundlist/app

# Browse available tools
npx -y @smithery/cli@latest tool list bundlist/app

# Get full schema for a tool
npx -y @smithery/cli@latest tool get bundlist/app list_lists

# Call a tool
npx -y @smithery/cli@latest tool call bundlist/app list_lists '{}'
```

## Direct MCP Connection

Endpoint: `https://lists--bundlist.run.tools`

## Tools (12)

- `list_lists` — Return all lists owned by the current user, with field and item counts.
- `get_list` — Get a single list by ID. Pass include_items=true to embed all items in the response. Use item_fields to project only sp…
- `get_lists` — Fetch multiple lists by ID in a single call. Silently skips IDs that are not found or not owned by the current user. Su…
- `get_schema` — Get the field schema for a list — the field names and IDs that define the columns. Call this before merge_list to get v…
- `get_limits` — Get the current user's service tier, per-tier limits (max lists, items per list, fields per list), and an upgrade_url. …
- `export_data` — Export all lists, field schemas, and items for the current user as structured JSON.
- `create_list` — Create a new empty list. Subject to the user's list count limit — call get_limits to check remaining capacity.
- `rename_list` — Rename an existing list. Has no effect on its fields or items.
- `merge_list` — Non-destructively create or update fields and items in a list in a single call. Fields without an id are created by nam…
- `delete_list` — Permanently delete a list and all its fields and items. This action cannot be undone.
- `delete_field` — Permanently delete a field from a list's schema. Existing field_values for that field are orphaned in items but not rem…
- `delete_item` — Permanently delete an item from a list. This action cannot be undone.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get bundlist/app <tool-name>
```

## Resources

- `bundlist://guide`
- `bundlist://lists`

## Prompts (2)

- `populate_list` (topic, list_id) — Given a topic or pasted content, create or update a bundlist list with an appropriate schema and pre-filled items.
- `review_limits` — Check the current user's tier, remaining capacity, and upgrade options.