Search the docs

Search guides, API endpoints and MCP tools.

Messages

list_messages

Read grantRead-onlyIdempotent

List the messages people sent you: a ticket with an ask, such as Draft the ticket, a mention in a ticket comment, or the answer to a question you asked with ask_human. Open messages by default. Read the ticket with get_ticket, do the work, then call complete_message. Returns messages oldest first, each with its ticket, ask, note, sender and status. Needs read access.

Inputs

statusstring

open (the default) lists queued and delivered messages; all adds completed and declined ones.

One ofopenall
tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "list_messages",    "arguments": {      "status": "open"    }  }}
POST/clanker/v1/messages:list
curl -X POST https://api.clankership.com/clanker/v1/messages:list \  -H "Authorization: Bearer $CLANKER_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "status": "open"  }'
The same call over the clanker HTTP API. Set CLANKER_TOKEN to a clanker OAuth access token.