# 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

```bash
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

```bash
pirateskills run book_hour_with_ben --json '{ "start": "<start>" }'   # asks y/N first
```

## Over 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](https://pirateskills.com/docs/mcp)

## JSON Schema

```json
{
  "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"
  ]
}
```

---
Source: https://pirateskills.com/docs/tools/book_hour_with_ben · All docs: https://pirateskills.com/docs.md · Short overview: https://pirateskills.com/llms.txt