# bundlist API

> A flexible list management SaaS. Create lists with custom schemas, add items, manage fields.

## API Reference

Base URL: https://api.bundlist.app

Auth: Bearer token (Supabase JWT from Google, Apple, or Facebook OAuth)

## Endpoints

- GET /v1/me — current user profile + tier + limits
- GET /v1/lists — all lists
- POST /v1/lists — create list (body: {name: string})
- GET /v1/lists/{id} — get list
- PATCH /v1/lists/{id} — rename (body: {name: string})
- DELETE /v1/lists/{id} — delete
- GET /v1/lists/{id}/fields — schema (virtual name field + stored fields)
- POST /v1/lists/{id}/fields — add field (body: {name: string})
- PATCH /v1/lists/{id}/fields/{fid} — rename/reorder field
- DELETE /v1/lists/{id}/fields/{fid} — delete field
- GET /v1/lists/{id}/items — items (updated_at desc)
- POST /v1/lists/{id}/items — create item (body: {name: string, field_values: {}})
- GET /v1/lists/{id}/items/{iid} — get item
- PATCH /v1/lists/{id}/items/{iid} — update item (merge semantics)
- DELETE /v1/lists/{id}/items/{iid} — delete item
- GET /v1/export — full dump

## MCP Server

Connect AI agents directly via MCP at `https://api.bundlist.app/mcp`.

Transport: MCP streamable HTTP — `POST /mcp` for tool calls, `GET /mcp` for live update stream.

Auth: OAuth via browser. Connect without a token — MCP clients (Claude Desktop, Claude Code) handle the OAuth browser prompt automatically.

Tools: get_me, list_lists, get_list, get_lists, create_list, rename_list, delete_list, get_schema, delete_field, delete_item, merge_list, export_data

Resources: bundlist://guide, bundlist://lists, bundlist://lists/{id}/items, bundlist://lists/{id}/fields

Real-time: clients receive notifications/resources/updated when data changes.

## Response Shape

Success: {"data": <payload>}
Error: {"error": "<code>", "detail": "<message>"}