### GET /status

Source: https://todos.mctx.ai

Retrieves the current status of the user's todo list, including pending counts and session changes.

```APIDOC
## GET /status

### Description
Check todo status at the start of every session. Updates last_session_at on each call.

### Method
GET

### Endpoint
/status

### Response
#### Success Response (200)
- **pending_count** (integer) - Number of todos not yet done
- **overdue** (integer) - Number of todos past due date
- **abandoned** (integer) - Number of todos not touched in 30+ days
- **session_diff** (object) - Summary of changes since last session

### Response Example
{
  "pending_count": 5,
  "overdue": 1,
  "abandoned": 0,
  "session_diff": {}
}
```

--------------------------------

### GET /list_todos

Source: https://todos.mctx.ai

Retrieves a paginated list of todos with optional filtering.

```APIDOC
## GET /list_todos

### Description
List todos with optional filters. Excludes completed todos by default.

### Method
GET

### Endpoint
/list_todos

### Query Parameters
- **overdue** (boolean) - Optional - If true, show only overdue todos
- **cursor** (string) - Optional - Cursor for pagination

### Response
#### Success Response (200)
- **todos** (array) - List of todo objects
- **next_cursor** (string) - Cursor for next page

### Response Example
{
  "todos": [],
  "next_cursor": "abc-123"
}
```

--------------------------------

### POST /complete_todo

Source: https://todos.mctx.ai

Marks a specific todo as completed.

```APIDOC
## POST /complete_todo

### Description
Mark a todo as completed. Idempotent operation.

### Method
POST

### Endpoint
/complete_todo

### Request Body
- **id** (string) - Required - ID of the todo to complete

### Response
#### Success Response (200)
- **id** (string) - Todo ID
- **completed** (boolean) - Completion status

### Response Example
{
  "id": "123",
  "completed": true
}
```

--------------------------------

### POST /upsert_todo

Source: https://todos.mctx.ai

Creates a new todo or updates an existing one based on the provided ID.

```APIDOC
## POST /upsert_todo

### Description
Create or update a todo. Omit id to create a new todo; provide an existing id to update it.

### Method
POST

### Endpoint
/upsert_todo

### Request Body
- **id** (string) - Optional - ID of the todo to update
- **title** (string) - Required - Title of the todo
- **priority** (integer) - Optional - Priority level

### Response
#### Success Response (200)
- **id** (string) - Todo ID
- **title** (string) - Todo title
- **published_at** (string) - Creation timestamp

### Response Example
{
  "id": "123",
  "title": "Buy groceries",
  "published_at": "2023-10-27T10:00:00Z"
}
```

--------------------------------

### POST /delete_todo

Source: https://todos.mctx.ai

Soft-deletes a todo, making it recoverable for 30 days.

```APIDOC
## POST /delete_todo

### Description
Soft-delete a todo by ID. Recoverable within 30 days.

### Method
POST

### Endpoint
/delete_todo

### Request Body
- **id** (string) - Required - ID of the todo to delete

### Response
#### Success Response (200)
- **id** (string) - Todo ID
- **deleted** (boolean) - Deletion status

### Response Example
{
  "id": "123",
  "deleted": true
}
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.