Tool reference book_hour_with_ben
book_hour_with_ben
Spend one of the signed-in person's diamonds on a one-to-one hour with Ben, at an open hour from my_bookings (pass its start exactly as listed, and name the hour by its label, never by a weekday you work out). The diamond is held at once and spent when Ben's calendar confirms, usually within a minute; if the hour is not booked it comes back. The answer's booking has its own label. Before the hour starts the person can move it with move_booking, or cancel it with cancel_booking and get the diamond back.
- Needs sign-in · 1 gold
- Changes something – ask first
Input
| Field | Type | Required | Notes |
|---|---|---|---|
start | string (date-time) | Yes | The start of an open hour exactly as my_bookings lists it, e.g. "2026-09-17T13:30:00.000+02:00". |
timeZone | string | No | The person's time zone, e.g. "Europe/Berlin". Defaults to Berlin. · at most 64 characters |
topic | string | No | What the person wants to work on in the hour, in a sentence or two. · at most 500 characters |
Over HTTP
curl -X POST https://pirateskills.com/api/public/agent/tools/book_hour_with_ben \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{ "start": "<start>" }'From the CLI
pirateskills run book_hour_with_ben --json '{ "start": "<start>" }' # asks y/N firstOver MCP
Call book_hour_with_ben on https://pirateskills.com/mcp. The tool is marked as one that changes something, so a well-behaved client asks the person first. Connect over MCP
JSON Schema
{
"type": "object",
"properties": {
"start": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "The start of an open hour exactly as my_bookings lists it, e.g. \"2026-09-17T13:30:00.000+02:00\"."
},
"timeZone": {
"description": "The person's time zone, e.g. \"Europe/Berlin\". Defaults to Berlin.",
"type": "string",
"maxLength": 64
},
"topic": {
"description": "What the person wants to work on in the hour, in a sentence or two.",
"type": "string",
"maxLength": 500
}
},
"required": [
"start"
]
}