Preview a message to one dealership
messages_preview: shows the exact message that messages_send would send to one dealership, and sends nothing.
Who can use it
A connected assistant with the dealers:message permission, on an account that holds the messaging grant. Most accounts do not: for them these tools are not listed. Sign in with OAuth. See Authentication.
Arguments
| Argument | Type | Required | Meaning |
|---|---|---|---|
dealSetId | string | Yes | The id of the request, from deal_sets_list. |
rowKey | string | Yes | The row key of the one dealership, from deal_sets_get. |
text | string | Yes | The message text, as the buyer wants it said to the dealership. 1 to 1000 characters. |
idempotencyKey | string | Yes | A key made up for this one message. The preview and the send take the same key. |
What it returns
The text as the dealership would get it, how it would be sent (sms or email), whether it can be sent now, and a previewToken valid for a short time and only for this exact text, this row and this idempotencyKey. The result adds a note: show the buyer this exact message, and send it only if she asks you to.
Errors
A call the tool cannot do answers with isError: true and a body of the form { "error": { "code": "...", "message": "..." } }. Branch on error.code; the codes are on the Errors page. A missing or no longer valid token gets a sign-in challenge instead: a JSON-RPC error with code -32001 and a WWW-Authenticate header. See Authentication.
Example
A tools/call request to https://www.ridekick.com/api/mcp:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "messages_preview",
"arguments": {
"dealSetId": "9b2f7a3e-5c1d-4e8a-8f60-1d2c3b4a5e6f",
"rowKey": "4c1e9a70-2b3d-4f5a-9c88-7e6d5c4b3a21",
"text": "Is this car still available this week?",
"idempotencyKey": "msg-001"
}
}
}Related
Last updated