Public – no key neededRead onlySearch the Pirate Skills knowledge: the Growth Codex, the Builder Codex and Insights. Returns the best matching chapters with a link; for a signed-in person each also carries a short excerpt. Without sign-in it returns titles and links only (which codex, the title, the url): the person signs in for the excerpts. Cite the url of every chapter you use in your answer.
- querystringrequired · 2–200 characters
- limitintegeroptional, default 5 · 1–20
curl -X POST https://pirateskills.com/api/public/agent/tools/search_knowledge \
-H "content-type: application/json" \
-d '{ "query": "<query>" }'
Public – no key neededRead onlyUpcoming Pirate Skills events, soonest first by date, with a link to each event page (a Forge session links the Forge page, where the seat is sold) and, for a signed-in person, whether they are registered. A Forge cohort appears only as its start – the first session of its Build or Grow part; its weekly sessions are never listed here. Present them in that date order, and give each event its one line from `about` – what it is and who it is for – so the person knows what they are looking at (an event without `about` is a one-off; its subtitle says it). When the person asks about their own Forge cohort or its sessions, use my_forge_sessions instead. `cadence` is how often that event's format meets – weekly only for the Forge (every week of a six-week phase), monthly for Vibe Coding Cologne, the Pirate Lab and AI Compass, quarterly for the Vibe Hackathon, one-off otherwise; give each event its own and never carry one event's cadence over to the others. `when` is the day and time to quote, in Berlin time; `startsAt`/`endsAt` are the same moment in UTC, for working with, never for quoting (the Captain's copy leaves them out, and gives a subtitle an earlier event already carried as null).
- typestringoptional
- Filter by event type label, e.g. "Pirate Lab" or "Vibe Coding Cologne". Omit for all.
- limitintegeroptional, default 10 · 1–50
curl -X POST https://pirateskills.com/api/public/agent/tools/list_events \
-H "content-type: application/json" \
-d '{}'
Public – no key neededRead onlyWhat Pirate Skills sells right now, with prices, read live (only what is on sale appears, and only what create_checkout sells): the Pirate Pass and the Forge Pass (monthly, prices before VAT, three-month minimum), which replace the Pirate Forge tiers (those are listed only until the passes are on sale), and a Captain on Deck session with Ben (the price is per session; up to 10 in one checkout) while it is on sale – each bought with create_checkout. `priceText` is the price to quote: euros, plus US dollars once a dollar price is set (both in one string, "€ / $"), with the person's likely currency first. An offer marked purchasable false carries a note saying why (a Pirate Pass holder cannot buy the Forge Pass on top). Event tickets (the Vibe Hackathon) are not listed here: a ticket is bought on the event page from list_events, where the price depends on the date and tier. Free events are registered with register_for_event, and the free Codex is read with search_knowledge. Every purchase is paid by the person on Stripe's own page; no agent takes a card or charges anyone.
No inputs.
curl -X POST https://pirateskills.com/api/public/agent/tools/get_offers \
-H "content-type: application/json" \
-d '{}'
Needs sign-inChanges something – ask firstRegister the signed-in person for a free upcoming event by its id (from list_events). Paid events are not registered here: the answer carries the event page where a ticket is bought.
- eventIdstringrequired · 1–128 characters
curl -X POST https://pirateskills.com/api/public/agent/tools/register_for_event \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{ "eventId": "<eventId>" }'
Needs sign-inChanges something – ask first, takes something awayCancel the signed-in person's own registration for an event by its id.
- eventIdstringrequired · 1–128 characters
curl -X POST https://pirateskills.com/api/public/agent/tools/cancel_registration \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{ "eventId": "<eventId>" }'
What the signed-in person has access to on Pirate Skills: the Codex, event series, the Forge, tools — with when and how each was unlocked.
No inputs.
curl -X POST https://pirateskills.com/api/public/agent/tools/my_access \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{}'
Needs sign-inChanges something – ask firstStart a purchase for the signed-in person and get back a Stripe checkout link, for an offer key from get_offers: the Pirate Pass or the Forge Pass, Captain on Deck sessions while they are on sale, or a Pirate Forge tier while one is still listed. `quantity` (1–10, default 1) is only for Captain on Deck sessions (`captain_on_deck_session`): one checkout buys that many sessions, one diamond each; any other offer with a quantity is refused. `currency` (`eur` or `usd`) is what Stripe charges in; leave it out and the checkout follows the caller's country when the request carries one – euros in Europe, dollars elsewhere – else euros. An offer without a dollar price is charged in euros either way. Event tickets are not sold here: send the person to the event page from list_events. Give the person the link; they pay on Stripe's page themselves. No agent ever charges a card, and nothing is charged until the person completes that page. The sale is credited to the agent that started it.
- offerKeystringrequired · 1–64 characters
- quantityintegeroptional · 1–10
- How many Captain on Deck sessions to buy, 1–10. Only for captain_on_deck_session; omit for every other offer.
- currency"eur" | "usd"optional
- The currency Stripe charges in. Omit to follow the caller's country (Europe: eur, elsewhere: usd), or eur when it is unknown.
curl -X POST https://pirateskills.com/api/public/agent/tools/create_checkout \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{ "offerKey": "<offerKey>" }'
The signed-in person's wallet: `gold.balance` and `diamonds` are counts; `emerald` is the pass they hold, in words ("Pirate Pass until 17 Oct 2026", "Forge Pass until …" or "no pass") – emerald is never a number, so never give it as one. Also how much of this month's gold drip is left and what they earned, the next refill date, when earned gold expires next (earned gold keeps twelve months, oldest first; `gold.expiresNext` is the amount and day within 60 days, or null), and the recent history. What gold is and buys, for the person: https://pirateskills.com/gold.
- limitintegeroptional, default 10 · 1–50
curl -X POST https://pirateskills.com/api/public/agent/tools/my_wallet \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{}'
The signed-in person's referral link, the people who signed up through it (first name and initial), and what each brought: gold or a diamond already paid, rewards pending with their pay date, and rewards not paid with the reason. Referrals pay nothing on signup; they pay when someone brought shows up to their first event, buys, or joins the Forge, after a wait and not at all if the purchase is refunded in that time. What each outcome pays right now and the wait in days are in `terms`, read from the live rules; `terms.on` false means rewards are paused.
No inputs.
curl -X POST https://pirateskills.com/api/public/agent/tools/my_referrals \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{}'
The signed-in person's name and email as Pirate Skills knows them.
No inputs.
curl -X POST https://pirateskills.com/api/public/agent/tools/my_profile \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{}'
The Pirate Forge live sessions the signed-in person can still join: each upcoming quarter's Build phase (weeks 1–6) and Grow phase (weeks 7–12), sessions left, and whether they are in. Empty with hasAccess false when they hold no active Forge access.
No inputs.
curl -X POST https://pirateskills.com/api/public/agent/tools/my_forge_sessions \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{}'
Needs sign-inChanges something – ask firstJoin the signed-in person to Pirate Forge live sessions: a whole cohort from now on (phase "all") or one phase ("build" or "grow"), by quarter key from my_forge_sessions. Only sessions still ahead are added; needs active Forge access. The answer says whether the calendar invite went out or Ben adds it by hand.
- quarterKeystringrequired
- The quarter, e.g. "2026_q4" (from my_forge_sessions).
- phase"build" | "grow" | "all"required
- "build" (weeks 1–6), "grow" (weeks 7–12), or "all" for the whole cohort from now on.
curl -X POST https://pirateskills.com/api/public/agent/tools/join_forge_cohort \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{ "quarterKey": "<quarterKey>", "phase": "build" }'
The signed-in person's time with Ben. Their hours with Ben: how many diamonds they hold (one diamond = one hour, one to one), their bookings with status (held, confirmed, cancelled) and join link, and the open hours ahead they can book with book_hour_with_ben. And the free 30-minute intro call (introCall): their upcoming one with its join link, or, when they have none, the open times they can book with book_intro_call. Each booking has its `id`, `label`, `canCancel` and `canMove`: cancel one with cancel_booking, move one with move_booking to an open time of the same kind (`openHours` for an hour with Ben, `introCall.moveTimes` for the free intro call). Booking, moving and cancelling happen here; `url` is a page to fall back to only if booking here fails. Each open time has `label` (weekday, date, time and time zone, worked out for the person's time zone, e.g. "Thursday, 17 September · 10:00–10:30 (Berlin time)") and `day`: quote `label` exactly as it is, and never work out a weekday or a date from `start` yourself. Pass `start` exactly as listed to book. `openDays` and `introCall.openDays` group the times by day; `bookableUntil` is the last day the calendar takes bookings for. Pass their time zone to get the times in it. Pass `purpose` when the person wants to book (intro_call or hour_with_ben): the next two weeks are listed, and a chat that can show a time picker shows one.
- timeZonestringoptional · at most 64 characters
- The person's time zone, e.g. "Europe/Berlin". Defaults to Berlin.
- limitintegeroptional, default 20 · 1–40
- How many open hours, and how many intro-call times, to list.
- purpose"intro_call" | "hour_with_ben"optional
- What the person wants to book right now: intro_call (the free 30-minute call) or hour_with_ben (one diamond). Omit when they only ask about their bookings.
curl -X POST https://pirateskills.com/api/public/agent/tools/my_bookings \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{}'
Needs sign-inChanges something – ask firstSpend 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.
- startstring (date-time)required
- The start of an open hour exactly as my_bookings lists it, e.g. "2026-09-17T13:30:00.000+02:00".
- timeZonestringoptional · at most 64 characters
- The person's time zone, e.g. "Europe/Berlin". Defaults to Berlin.
- topicstringoptional · at most 500 characters
- What the person wants to work on in the hour, in a sentence or two.
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>" }'
Needs sign-inChanges something – ask firstBook the signed-in person a free 30-minute intro call with Ben, at a time from my_bookings (introCall.openTimes; pass its start exactly as listed, and name the time by its label, never by a weekday you work out). Book it here: do not send the person to a booking page unless this refuses or fails. No diamond, nothing charged; the calendar invite comes from cal.com. The answer's booking has its own label and join link; move it with move_booking, cancel it with cancel_booking. One upcoming free call per person at a time: while one stands, this refuses and names it. Offer the free 30-minute intro call with Ben when the person is interested in the Pirate Forge (the Forge Pass) or in working with Ben one to one – Captain on Deck, which people also call an in-house workshop, consulting or freelance work. Never offer it for the Pirate Pass or for an event ticket.
- startstring (date-time)required
- The start of a free intro-call time exactly as my_bookings lists it under introCall.openTimes, e.g. "2026-09-17T10:00:00.000+02:00".
- timeZonestringoptional · at most 64 characters
- The person's time zone, e.g. "Europe/Berlin". Defaults to Berlin.
- topicstringoptional · at most 500 characters
- What the person is deciding about (the Forge Pass, a Captain on Deck session) or wants to ask, in a sentence or two.
curl -X POST https://pirateskills.com/api/public/agent/tools/book_intro_call \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{ "start": "<start>" }'
Needs sign-inChanges something – ask firstMove one of the signed-in person's own upcoming bookings (the free intro call or an hour with Ben, by its id from my_bookings, where canMove is true) to another open time of the same kind: for an hour with Ben a start from openHours, for the free intro call a start from introCall.moveTimes. Pass the start exactly as listed, and name the new time by its label, never by a weekday you work out. Nothing is charged: an hour keeps its diamond, the call stays free, and the calendar sends the updated invite. The answer's booking has the new label. Refused, with a reason, for a booking that is not theirs, already cancelled, begun, still waiting for the calendar, or a time that is not open.
- bookingIdstring (uuid)required
- The id of one of the person's own upcoming bookings, exactly as my_bookings lists it.
- startstring (date-time)required
- The new start, exactly as my_bookings lists it for that kind of booking: openHours for an hour with Ben, introCall.moveTimes for the free intro call, e.g. "2026-09-18T11:30:00.000+02:00".
- timeZonestringoptional · at most 64 characters
- The person's time zone, e.g. "Europe/Berlin". Defaults to the booking's own.
curl -X POST https://pirateskills.com/api/public/agent/tools/move_booking \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{ "bookingId": "<bookingId>", "start": "<start>" }'
Needs sign-inChanges something – ask first, takes something awayCancel one of the signed-in person's own upcoming bookings by its id from my_bookings (where canCancel is true): the free intro call, or an hour with Ben, whose diamond comes back in their wallet. Name the booking by its label when you ask for their yes. Refused, with a reason, for a booking that is not theirs, already cancelled, or already begun.
- bookingIdstring (uuid)required
- The id of one of the person's own upcoming bookings, exactly as my_bookings lists it.
- reasonstringoptional · at most 300 characters
- Why, in the person's words, when they gave one. Optional.
curl -X POST https://pirateskills.com/api/public/agent/tools/cancel_booking \
-H "Authorization: Bearer $PIRATESKILLS_API_KEY" \
-H "content-type: application/json" \
-d '{ "bookingId": "<bookingId>" }'