List attachments
list_attachmentsList media attachments — images, documents, audio, video, stickers — across every
conversation the user can read (or one connected number's, with phone), or
within one when conversation_id is given, most recent
first, cursor-paginated, each entry carrying its conversation and the URL that serves the raw
file. Only attachments whose bytes Werify actually holds are listed. Filter with type,
with query (words in the file name or caption) and/or a start_date/end_date window
("the invoice they sent in July" → type: "document" + the July window; "the contract" →
query: "contract"). The url serves the file over plain HTTPS: it
accepts this MCP server's own Authorization: Bearer token — a client that can make
HTTP requests fetches it directly and can analyze images and PDFs — and in a browser it
opens with the user's Werify login, so a client that cannot fetch URLs should hand the
link to the user. Audio content is better read as inline transcripts via
get_conversation. Only conversations the user owns or has been shared are accessible.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_attachments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Optional filter: image, document, audio or video. | |
| limit | No | Entries per page, 1–200 (default 50). | |
| phone | No | Optional: one of the user's connected numbers, as list_connected_numbers returns it. Without conversation_id, lists only that number's conversations; ignored with it. | |
| query | No | Optional words to find in the file name or the caption. Case-insensitive substring match: every word must appear in one or the other, not semantic. | |
| cursor | No | The `next_cursor` from a previous page; omit for the first page. | |
| end_date | No | Optional ISO 8601 date (YYYY-MM-DD) upper bound. | |
| start_date | No | Optional ISO 8601 date (YYYY-MM-DD) lower bound. | |
| conversation_id | No | Optional: one conversation id (from `search_conversations` or `list_contacts`). Omit it to list across every conversation the user can read. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Its name; absent with conversation_id. | |
| next_step | No | Present only when capture is paused for billing on one of the user's numbers — what is here still lists, but no new media is arriving. Relay it to the user. | |
| attachments | No | ||
| next_cursor | No | Pass back as `cursor` for the next (older) page, with the same conversation_id, or none if this page had none. It already carries the type, query, phone and date filters. `null` means there are no more attachments. | |
| conversation_id | No | The conversation asked for; absent when the list spans every conversation. |