Server definition
- Hash
- sha256:75093d360e5201e95a71f0efee8bb079158c4a0b11f76435ce1d6ad572c3d14a
- What it is
- What a remote MCP server returned when asked what it offers: 26 tools
The blob, as servednamed by its sha256
{
"instructions": "MentorCruise public MCP. Help users discover mentors, apply, and pay from credits.\n\n## Typical flow\n1. search_mentors with the user's goal/skills/budget.\n2. Pick 2-3 mentors from the results (see selection rules below).\n3. get_mentor_profile and/or get_sessions_or_services for the ones the user wants more detail on.\n4. If the user only wants a link: create_booking_link (ongoing mentorship) or the booking_url from get_sessions_or_services (one-off session), or book_session after the user is signed in.\n5. If they want you to apply for them: on Claude Code, Cursor, or ChatGPT with Connect, call apply_to_mentor directly after Connect — do not use register_mentee or verify_email (the client manages OAuth and ignores tokens from verify_email). On clients without Connect: register_mentee → verify_url + verify_email → apply_to_mentor with Bearer on later calls.\n6. list_applications / get_application for status, Pinax messages, and action_required. send_application_message to reply. withdraw_application when can_withdraw is true.\n7. When payable is true, pay_application. If credits are short, top up and retry.\n **Paying from MCP:** Most clients (Claude Code, Cursor) cannot send HTTP Payment headers on tool calls. If the host has a Stripe agent wallet, pass payment_credential on top_up_credits or pay_application. Otherwise call open_dashboard, have the human pay in the browser, then retry.\n8. After mentorship starts: list_conversations, get_messages, send_message (TalkJS). Book intro calls with list_intro_call_slots / book_intro_call. Book mentorship calls with list_mentorship_call_slots / book_mentorship_call. Book a one-off session with list_session_slots / book_session.\n9. open_dashboard mints a one-use browser URL so the human can see ongoing applications and mentorships.\n\n## Auth\nPrimary path: OAuth Connect (/mcp in Claude Code). Connect already includes email verification in the browser — same mentee account as the site.\n\nregister_mentee / verify_email are legacy fallbacks for MCP clients that do not manage OAuth and can send the returned JWT themselves. Never use them on Claude Code, Cursor, or ChatGPT with Connect — the client ignores verify_email tokens and keeps its own OAuth header.\n\nDiscovery tools need no auth. Every public tool is listed on tools/list. Search before the user signs in.\n\nWrite tools (apply, pay, message, book, withdraw) need Connect or a Bearer token. Never tell the user you cannot apply, message, pay, or book on MentorCruise — use the tools. If a write call returns auth_required, the MCP client should open Connect in the browser automatically — ask the human to finish email verification and click Allow, then retry the same tool. Do not ask them to run /mcp or claude mcp login unless Connect never appeared, or the error is token_expired (expired OAuth — run /mcp to reconnect). Until Connect completes, fall back to create_booking_link or booking_url instead of refusing.\n\nIn-chat sign-in without Connect: register_mentee then verify_email, then send Authorization: Bearer <access>. Hosted OAuth Connect is preferred in Claude Code because it manages the Bearer header for you. Unauthenticated write calls return auth_required (HTTP 401 with WWW-Authenticate). Unverified JWTs return email_unverified.\n\n## Selection rules (apply in order)\n1. The search results are already ranked by composite quality. Trust the ranking – don't reorder by superficial keyword similarity in job_title or headline.\n2. STRONGLY prefer mentors with review_count > 0. A mentor with zero reviews next to mentors who have reviews makes the recommendation feel weak.\n3. Only fall back to 0-review mentors when fewer than 2 reviewed mentors match. If you do show one, acknowledge it as a 'newer mentor.'\n4. Tie-break by: more reviews → top_mentor=true.\n5. Diversify naturally (different companies / backgrounds) – but never sacrifice quality for diversity.\n6. Show 2-3 mentors. If only 1 result, broaden filters and retry up to 2-3 times before showing the single result with a note that the niche is narrow.\n\n## Query construction\n- `query`: 1-4 keywords (role, skill, expertise). NEVER include the words 'mentor' or 'coach'. Examples: 'python', 'product management', 'startup'. NOT 'a python mentor for startups'.\n- Only use HARD filters (skills, languages, budget, response time) when the user explicitly asked for them. Over-filtering shrinks the pool.\n- For region / language, use the structured list args, not the free-text query.\n\n## Don't expose internals, and don't assume pricing cadence\nTranslate quality signals into natural language: 'highly rated' instead of '4.92 rating', 'starting at $150' instead of 'lowest_price_usd: 150'. Never mention internal field names.\nCRITICAL: `lowest_price_usd` is the cheapest offering – could be a ONE-OFF session OR a monthly subscription. Don't say '/mo' unless you have confirmed via get_sessions_or_services that it's a subscription. Default phrasing: 'starting at $X' (no /mo).\n\n## After recommending\nYou are NOT a mentor or coach. If the user asks for study plans, intro-message drafts, interview prep, salary advice, code review, or any guidance beyond which mentor to pick – redirect: 'That's exactly what [mentor] is there for, they'll tailor it to your situation.' You MAY send an application when the user asks you to, using their own words.\n\n## Showing more mentors\nIf the user asks for 'more' or 'different' mentors:\n- First time: re-call search_mentors with the SAME constraints and pick mentors you haven't shown yet.\n- Second time: ask one short clarifying question (skill / experience / budget / language), then re-search with adjusted criteria.\n- Never show a mentor twice unless the user asks for them by name.",
"tools": [
{
"description": "Send a mentorship application to a mentor on the signed-in mentee's behalf. Requires Authorization: Bearer and a verified email. goal must be a real, specific message (min 50 characters). Optional plan_hash selects a pricing plan from get_sessions_or_services. The mentor is notified after a spam check. This does not charge yet; when they accept, call pay_application.",
"inputSchema": {
"properties": {
"first_name": {
"default": "",
"title": "First Name",
"type": "string"
},
"goal": {
"title": "Goal",
"type": "string"
},
"introduction": {
"default": "",
"title": "Introduction",
"type": "string"
},
"last_name": {
"default": "",
"title": "Last Name",
"type": "string"
},
"mentee_question": {
"default": "",
"title": "Mentee Question",
"type": "string"
},
"plan_hash": {
"default": "",
"title": "Plan Hash",
"type": "string"
},
"service_expectations": {
"default": "",
"title": "Service Expectations",
"type": "string"
},
"time_expectations": {
"default": 0,
"title": "Time Expectations",
"type": "integer"
},
"timeline": {
"default": 0,
"title": "Timeline",
"type": "integer"
},
"timezone": {
"default": "UTC",
"title": "Timezone",
"type": "string"
},
"user_info": {
"default": 0,
"title": "User Info",
"type": "integer"
},
"username": {
"title": "Username",
"type": "string"
}
},
"required": [
"username",
"goal"
],
"title": "apply_to_mentorArguments",
"type": "object"
},
"name": "apply_to_mentor",
"outputSchema": {
"$defs": {
"PinaxMessageItem": {
"description": "One Pinax message on an application thread.",
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentee, mentor, or other.",
"title": "Sender"
},
"sent_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent At"
}
},
"title": "PinaxMessageItem",
"type": "object"
}
},
"description": "One open application from apply_to_mentor / list_applications.",
"properties": {
"action_required": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "reply_to_mentor, waiting_on_mentor, book_intro_call, or start_mentorship.",
"title": "Action Required"
},
"can_withdraw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when withdraw_application will succeed.",
"title": "Can Withdraw"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to pay_application.",
"title": "Hash"
},
"intro_call_scheduled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Intro Call Scheduled"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"messages": {
"items": {
"$ref": "#/$defs/PinaxMessageItem"
},
"title": "Messages",
"type": "array"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL that accepts an MPP credential if credits are short.",
"title": "Pay Url"
},
"payable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentor accepted and payment is due.",
"title": "Payable"
},
"plan_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Plan Hash"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"sent_message_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent Message Id"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "draft, new, pending, accepted, rejected, withdrawn.",
"title": "Status"
},
"status_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status Note"
},
"unread": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentee has an unread Pinax message.",
"title": "Unread"
}
},
"title": "MachineApplicationItem",
"type": "object"
}
},
{
"description": "Book an intro call on an accepted application. Requires Authorization: Bearer. start is an ISO-8601 datetime from list_intro_call_slots. Does not retry other slots on failure.",
"inputSchema": {
"properties": {
"application_hash": {
"title": "Application Hash",
"type": "string"
},
"start": {
"title": "Start",
"type": "string"
}
},
"required": [
"application_hash",
"start"
],
"title": "book_intro_callArguments",
"type": "object"
},
"name": "book_intro_call",
"outputSchema": {
"$defs": {
"MachineApplicationItem": {
"description": "One open application from apply_to_mentor / list_applications.",
"properties": {
"action_required": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "reply_to_mentor, waiting_on_mentor, book_intro_call, or start_mentorship.",
"title": "Action Required"
},
"can_withdraw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when withdraw_application will succeed.",
"title": "Can Withdraw"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to pay_application.",
"title": "Hash"
},
"intro_call_scheduled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Intro Call Scheduled"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"messages": {
"items": {
"$ref": "#/$defs/PinaxMessageItem"
},
"title": "Messages",
"type": "array"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL that accepts an MPP credential if credits are short.",
"title": "Pay Url"
},
"payable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentor accepted and payment is due.",
"title": "Payable"
},
"plan_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Plan Hash"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"sent_message_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent Message Id"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "draft, new, pending, accepted, rejected, withdrawn.",
"title": "Status"
},
"status_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status Note"
},
"unread": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentee has an unread Pinax message.",
"title": "Unread"
}
},
"title": "MachineApplicationItem",
"type": "object"
},
"MachineChallenge": {
"description": "MPP Challenge parameters returned on payment_required.",
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable charge purpose.",
"title": "Description"
},
"expires": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO-8601 expiry.",
"title": "Expires"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "HMAC-bound challenge id.",
"title": "Id"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'charge'.",
"title": "Intent"
},
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'stripe'.",
"title": "Method"
},
"opaque": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url JSON bound to this mentee.",
"title": "Opaque"
},
"realm": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "MPP realm, e.g. mentorcruise.com.",
"title": "Realm"
},
"request": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url JSON amount/currency.",
"title": "Request"
}
},
"title": "MachineChallenge",
"type": "object"
},
"MachineMentorshipItem": {
"description": "One active mentorship.",
"properties": {
"active": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Active"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"fee_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Fee Usd"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to open_dashboard as mentorship_hash.",
"title": "Hash"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
}
},
"title": "MachineMentorshipItem",
"type": "object"
},
"PinaxMessageItem": {
"description": "One Pinax message on an application thread.",
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentee, mentor, or other.",
"title": "Sender"
},
"sent_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent At"
}
},
"title": "PinaxMessageItem",
"type": "object"
}
},
"description": "pay_application / top_up_credits, including payment_required.",
"properties": {
"amount_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Charge or top-up amount in whole USD.",
"title": "Amount Usd"
},
"application": {
"anyOf": [
{
"$ref": "#/$defs/MachineApplicationItem"
},
{
"type": "null"
}
],
"default": null
},
"application_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Application Hash"
},
"available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Available"
},
"billing_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Billing Note"
},
"booking_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Booking Hash"
},
"calendar_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Calendar Link"
},
"challenge": {
"anyOf": [
{
"$ref": "#/$defs/MachineChallenge"
},
{
"type": "null"
}
],
"default": null,
"description": "MPP challenge. Present when error is payment_required."
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "usd",
"title": "Currency"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "payment_required, invalid_payment, auth_required, not_found, etc.",
"title": "Error"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "charge",
"title": "Intent"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "intro_call, mentorship_call, or session.",
"title": "Kind"
},
"mentorship": {
"anyOf": [
{
"$ref": "#/$defs/MachineMentorshipItem"
},
{
"type": "null"
}
],
"default": null
},
"mentorship_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentorship Hash"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "stripe",
"title": "Method"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL to retry with an MPP Payment credential.",
"title": "Pay Url"
},
"receipt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url MPP receipt.",
"title": "Receipt"
},
"setup_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Setup Id"
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'paid', 'topped_up', or absent on payment_required.",
"title": "Status"
},
"www_authenticate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "WWW-Authenticate Payment header value from the REST 402.",
"title": "Www Authenticate"
}
},
"title": "MachinePaymentResponse",
"type": "object"
}
},
{
"description": "Book a mentorship call on an active mentorship. Requires Authorization: Bearer. start is an ISO-8601 datetime from list_mentorship_call_slots.",
"inputSchema": {
"properties": {
"mentorship_hash": {
"title": "Mentorship Hash",
"type": "string"
},
"start": {
"title": "Start",
"type": "string"
}
},
"required": [
"mentorship_hash",
"start"
],
"title": "book_mentorship_callArguments",
"type": "object"
},
"name": "book_mentorship_call",
"outputSchema": {
"$defs": {
"MachineApplicationItem": {
"description": "One open application from apply_to_mentor / list_applications.",
"properties": {
"action_required": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "reply_to_mentor, waiting_on_mentor, book_intro_call, or start_mentorship.",
"title": "Action Required"
},
"can_withdraw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when withdraw_application will succeed.",
"title": "Can Withdraw"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to pay_application.",
"title": "Hash"
},
"intro_call_scheduled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Intro Call Scheduled"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"messages": {
"items": {
"$ref": "#/$defs/PinaxMessageItem"
},
"title": "Messages",
"type": "array"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL that accepts an MPP credential if credits are short.",
"title": "Pay Url"
},
"payable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentor accepted and payment is due.",
"title": "Payable"
},
"plan_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Plan Hash"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"sent_message_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent Message Id"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "draft, new, pending, accepted, rejected, withdrawn.",
"title": "Status"
},
"status_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status Note"
},
"unread": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentee has an unread Pinax message.",
"title": "Unread"
}
},
"title": "MachineApplicationItem",
"type": "object"
},
"MachineChallenge": {
"description": "MPP Challenge parameters returned on payment_required.",
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable charge purpose.",
"title": "Description"
},
"expires": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO-8601 expiry.",
"title": "Expires"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "HMAC-bound challenge id.",
"title": "Id"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'charge'.",
"title": "Intent"
},
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'stripe'.",
"title": "Method"
},
"opaque": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url JSON bound to this mentee.",
"title": "Opaque"
},
"realm": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "MPP realm, e.g. mentorcruise.com.",
"title": "Realm"
},
"request": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url JSON amount/currency.",
"title": "Request"
}
},
"title": "MachineChallenge",
"type": "object"
},
"MachineMentorshipItem": {
"description": "One active mentorship.",
"properties": {
"active": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Active"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"fee_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Fee Usd"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to open_dashboard as mentorship_hash.",
"title": "Hash"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
}
},
"title": "MachineMentorshipItem",
"type": "object"
},
"PinaxMessageItem": {
"description": "One Pinax message on an application thread.",
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentee, mentor, or other.",
"title": "Sender"
},
"sent_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent At"
}
},
"title": "PinaxMessageItem",
"type": "object"
}
},
"description": "pay_application / top_up_credits, including payment_required.",
"properties": {
"amount_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Charge or top-up amount in whole USD.",
"title": "Amount Usd"
},
"application": {
"anyOf": [
{
"$ref": "#/$defs/MachineApplicationItem"
},
{
"type": "null"
}
],
"default": null
},
"application_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Application Hash"
},
"available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Available"
},
"billing_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Billing Note"
},
"booking_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Booking Hash"
},
"calendar_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Calendar Link"
},
"challenge": {
"anyOf": [
{
"$ref": "#/$defs/MachineChallenge"
},
{
"type": "null"
}
],
"default": null,
"description": "MPP challenge. Present when error is payment_required."
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "usd",
"title": "Currency"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "payment_required, invalid_payment, auth_required, not_found, etc.",
"title": "Error"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "charge",
"title": "Intent"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "intro_call, mentorship_call, or session.",
"title": "Kind"
},
"mentorship": {
"anyOf": [
{
"$ref": "#/$defs/MachineMentorshipItem"
},
{
"type": "null"
}
],
"default": null
},
"mentorship_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentorship Hash"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "stripe",
"title": "Method"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL to retry with an MPP Payment credential.",
"title": "Pay Url"
},
"receipt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url MPP receipt.",
"title": "Receipt"
},
"setup_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Setup Id"
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'paid', 'topped_up', or absent on payment_required.",
"title": "Status"
},
"www_authenticate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "WWW-Authenticate Payment header value from the REST 402.",
"title": "Www Authenticate"
}
},
"title": "MachinePaymentResponse",
"type": "object"
}
},
{
"description": "Book a one-off session: charge credits (top up via MPP if short), then reserve the chosen Cal slot. Requires Authorization: Bearer. setup_id and start come from get_sessions_or_services and list_session_slots. If credits are short this returns payment_required; pass payment_credential or pay via open_dashboard in the browser, then retry.",
"inputSchema": {
"properties": {
"payment_credential": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Credential"
},
"setup_id": {
"title": "Setup Id",
"type": "integer"
},
"start": {
"title": "Start",
"type": "string"
}
},
"required": [
"setup_id",
"start"
],
"title": "book_sessionArguments",
"type": "object"
},
"name": "book_session",
"outputSchema": {
"$defs": {
"MachineApplicationItem": {
"description": "One open application from apply_to_mentor / list_applications.",
"properties": {
"action_required": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "reply_to_mentor, waiting_on_mentor, book_intro_call, or start_mentorship.",
"title": "Action Required"
},
"can_withdraw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when withdraw_application will succeed.",
"title": "Can Withdraw"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to pay_application.",
"title": "Hash"
},
"intro_call_scheduled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Intro Call Scheduled"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"messages": {
"items": {
"$ref": "#/$defs/PinaxMessageItem"
},
"title": "Messages",
"type": "array"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL that accepts an MPP credential if credits are short.",
"title": "Pay Url"
},
"payable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentor accepted and payment is due.",
"title": "Payable"
},
"plan_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Plan Hash"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"sent_message_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent Message Id"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "draft, new, pending, accepted, rejected, withdrawn.",
"title": "Status"
},
"status_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status Note"
},
"unread": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentee has an unread Pinax message.",
"title": "Unread"
}
},
"title": "MachineApplicationItem",
"type": "object"
},
"MachineChallenge": {
"description": "MPP Challenge parameters returned on payment_required.",
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable charge purpose.",
"title": "Description"
},
"expires": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO-8601 expiry.",
"title": "Expires"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "HMAC-bound challenge id.",
"title": "Id"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'charge'.",
"title": "Intent"
},
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'stripe'.",
"title": "Method"
},
"opaque": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url JSON bound to this mentee.",
"title": "Opaque"
},
"realm": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "MPP realm, e.g. mentorcruise.com.",
"title": "Realm"
},
"request": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url JSON amount/currency.",
"title": "Request"
}
},
"title": "MachineChallenge",
"type": "object"
},
"MachineMentorshipItem": {
"description": "One active mentorship.",
"properties": {
"active": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Active"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"fee_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Fee Usd"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to open_dashboard as mentorship_hash.",
"title": "Hash"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
}
},
"title": "MachineMentorshipItem",
"type": "object"
},
"PinaxMessageItem": {
"description": "One Pinax message on an application thread.",
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentee, mentor, or other.",
"title": "Sender"
},
"sent_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent At"
}
},
"title": "PinaxMessageItem",
"type": "object"
}
},
"description": "pay_application / top_up_credits, including payment_required.",
"properties": {
"amount_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Charge or top-up amount in whole USD.",
"title": "Amount Usd"
},
"application": {
"anyOf": [
{
"$ref": "#/$defs/MachineApplicationItem"
},
{
"type": "null"
}
],
"default": null
},
"application_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Application Hash"
},
"available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Available"
},
"billing_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Billing Note"
},
"booking_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Booking Hash"
},
"calendar_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Calendar Link"
},
"challenge": {
"anyOf": [
{
"$ref": "#/$defs/MachineChallenge"
},
{
"type": "null"
}
],
"default": null,
"description": "MPP challenge. Present when error is payment_required."
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "usd",
"title": "Currency"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "payment_required, invalid_payment, auth_required, not_found, etc.",
"title": "Error"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "charge",
"title": "Intent"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "intro_call, mentorship_call, or session.",
"title": "Kind"
},
"mentorship": {
"anyOf": [
{
"$ref": "#/$defs/MachineMentorshipItem"
},
{
"type": "null"
}
],
"default": null
},
"mentorship_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentorship Hash"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "stripe",
"title": "Method"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL to retry with an MPP Payment credential.",
"title": "Pay Url"
},
"receipt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url MPP receipt.",
"title": "Receipt"
},
"setup_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Setup Id"
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'paid', 'topped_up', or absent on payment_required.",
"title": "Status"
},
"www_authenticate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "WWW-Authenticate Payment header value from the REST 402.",
"title": "Www Authenticate"
}
},
"title": "MachinePaymentResponse",
"type": "object"
}
},
{
"description": "Generate booking deep-links for an ONGOING MENTORSHIP (subscription / PricingPlan). Returns:\n - apply_url: where the user starts the subscription. Optional plan_hash pre-selects a specific plan.\n - inquiry_url: free question before committing (no booking).\n - requires_intro_call: when true, the mentor offers an intro call (free or paid – see intro_call_note). apply_url already routes the user to the scheduler first — mention the intro call when sharing it.\n\nIMPORTANT: this tool is for ongoing mentorships only. For ONE-OFF SESSIONS, use the `booking_url` from get_sessions_or_services directly — those bookings go through /sessions/<slug>/book/, NOT /apply/.\n\nThe user must click the link and sign in via the browser — this tool does NOT book on their behalf.",
"inputSchema": {
"properties": {
"intent": {
"default": "",
"title": "Intent",
"type": "string"
},
"plan_hash": {
"default": "",
"title": "Plan Hash",
"type": "string"
},
"username": {
"title": "Username",
"type": "string"
}
},
"required": [
"username"
],
"title": "create_booking_linkArguments",
"type": "object"
},
"name": "create_booking_link",
"outputSchema": {
"description": "Return shape of create_booking_link (ongoing mentorship only).",
"properties": {
"apply_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Where the user starts the subscription. The user must click and sign in; this tool does not book on their behalf.",
"title": "Apply Url"
},
"booking_route": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "apply",
"description": "Always 'apply'.",
"title": "Booking Route"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Error code: 'not_found' or 'rate_limit_exceeded'. Absent on success.",
"title": "Error"
},
"inquiry_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Free-question link before committing (no booking).",
"title": "Inquiry Url"
},
"intro_call_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Guidance about the intro call (free or paid); present only when requires_intro_call is true.",
"title": "Intro Call Note"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable error detail.",
"title": "Message"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What to do with the links.",
"title": "Next Step"
},
"requires_intro_call": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "When true, apply_url routes to the scheduler first; mention the intro call (see intro_call_note for free vs paid).",
"title": "Requires Intro Call"
},
"username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Echoes the requested username on a not_found error.",
"title": "Username"
}
},
"title": "BookingLinkResponse",
"type": "object"
}
},
{
"description": "Return the signed-in mentee's name, email, credit balance, and a one-use dashboard URL. Requires Authorization: Bearer.",
"inputSchema": {
"properties": {},
"title": "get_accountArguments",
"type": "object"
},
"name": "get_account",
"outputSchema": {
"description": "get_account.",
"properties": {
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Whole-dollar credit balance.",
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "One-use signed-in dashboard URL. Expires in 30 minutes.",
"title": "Dashboard Url"
},
"email": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Email"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "auth_required, email_unverified, or rate_limit_exceeded.",
"title": "Error"
},
"first_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "First Name"
},
"last_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Last Name"
},
"mail_verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Mail Verified"
},
"mentee_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentee Id"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
}
},
"title": "MachineAccountResponse",
"type": "object"
}
},
{
"description": "Read one application the signed-in mentee owns: status, action_required, whether they can withdraw, and the Pinax message thread. Requires Authorization: Bearer. application_hash comes from list_applications.",
"inputSchema": {
"properties": {
"application_hash": {
"title": "Application Hash",
"type": "string"
}
},
"required": [
"application_hash"
],
"title": "get_applicationArguments",
"type": "object"
},
"name": "get_application",
"outputSchema": {
"$defs": {
"PinaxMessageItem": {
"description": "One Pinax message on an application thread.",
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentee, mentor, or other.",
"title": "Sender"
},
"sent_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent At"
}
},
"title": "PinaxMessageItem",
"type": "object"
}
},
"description": "One open application from apply_to_mentor / list_applications.",
"properties": {
"action_required": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "reply_to_mentor, waiting_on_mentor, book_intro_call, or start_mentorship.",
"title": "Action Required"
},
"can_withdraw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when withdraw_application will succeed.",
"title": "Can Withdraw"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to pay_application.",
"title": "Hash"
},
"intro_call_scheduled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Intro Call Scheduled"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"messages": {
"items": {
"$ref": "#/$defs/PinaxMessageItem"
},
"title": "Messages",
"type": "array"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL that accepts an MPP credential if credits are short.",
"title": "Pay Url"
},
"payable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentor accepted and payment is due.",
"title": "Payable"
},
"plan_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Plan Hash"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"sent_message_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent Message Id"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "draft, new, pending, accepted, rejected, withdrawn.",
"title": "Status"
},
"status_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status Note"
},
"unread": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentee has an unread Pinax message.",
"title": "Unread"
}
},
"title": "MachineApplicationItem",
"type": "object"
}
},
{
"description": "Fetch the full public profile for a single MentorCruise mentor. Use the `username` from a search_mentors result. Returns name, headline, company, bio, skills, languages, rating, monthly price, response time, open spots, and the public profile URL. Returns {'error': 'not_found'} if the mentor doesn't exist or is hidden.",
"inputSchema": {
"properties": {
"username": {
"title": "Username",
"type": "string"
}
},
"required": [
"username"
],
"title": "get_mentor_profileArguments",
"type": "object"
},
"name": "get_mentor_profile",
"outputSchema": {
"description": "Return shape of get_mentor_profile (a full public profile).",
"properties": {
"bio": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Plain-text biography (HTML stripped).",
"title": "Bio"
},
"company": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Current company.",
"title": "Company"
},
"does_calls": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether the mentor offers video calls.",
"title": "Does Calls"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Error code: 'not_found' or 'rate_limit_exceeded'. Absent on success.",
"title": "Error"
},
"headline": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "One-line self-description.",
"title": "Headline"
},
"industries": {
"description": "Industry tags.",
"items": {
"type": "string"
},
"title": "Industries",
"type": "array"
},
"job_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Current role.",
"title": "Job Title"
},
"languages": {
"description": "Languages spoken.",
"items": {
"type": "string"
},
"title": "Languages",
"type": "array"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Display location.",
"title": "Location"
},
"lowest_price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Cheapest offering in USD (subscription or one-off).",
"title": "Lowest Price Usd"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable error detail.",
"title": "Message"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Full name.",
"title": "Name"
},
"open_spots": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Mentee slots currently open.",
"title": "Open Spots"
},
"open_to_inquiries": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether the mentor accepts free inquiries.",
"title": "Open To Inquiries"
},
"profile_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Absolute URL to the profile image.",
"title": "Profile Image Url"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Absolute URL to the public profile.",
"title": "Profile Url"
},
"rating": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Average review rating (0-5), or null if unrated.",
"title": "Rating"
},
"response_time_hours": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Median response time in hours; may be fractional.",
"title": "Response Time Hours"
},
"review_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Number of reviews.",
"title": "Review Count"
},
"skills": {
"description": "Skill tags.",
"items": {
"type": "string"
},
"title": "Skills",
"type": "array"
},
"tags": {
"description": "Free-form tags.",
"items": {
"type": "string"
},
"title": "Tags",
"type": "array"
},
"tools": {
"description": "Tools/technologies.",
"items": {
"type": "string"
},
"title": "Tools",
"type": "array"
},
"top_mentor": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Top Mentor status.",
"title": "Top Mentor"
},
"username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Mentor slug.",
"title": "Username"
}
},
"title": "MentorProfileResponse",
"type": "object"
}
},
{
"description": "Read TalkJS messages from a mentor conversation. Requires Authorization: Bearer. conversation_id is the hash from list_conversations. Newest first. Pass starting_after with a message id to page into older messages.",
"inputSchema": {
"properties": {
"conversation_id": {
"title": "Conversation Id",
"type": "string"
},
"limit": {
"default": 20,
"title": "Limit",
"type": "integer"
},
"starting_after": {
"default": "",
"title": "Starting After",
"type": "string"
}
},
"required": [
"conversation_id"
],
"title": "get_messagesArguments",
"type": "object"
},
"name": "get_messages",
"outputSchema": {
"$defs": {
"TalkJSMessageItem": {
"description": "One TalkJS message. Emails and TalkJS user hashes are stripped.",
"properties": {
"attachment_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Attachment Name"
},
"attachment_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Attachment Url"
},
"created_at": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Unix time in milliseconds.",
"title": "Created At"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentor, mentee, system, or other.",
"title": "Sender"
},
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Text"
}
},
"title": "TalkJSMessageItem",
"type": "object"
}
},
"description": "get_messages.",
"properties": {
"conversation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Conversation Id"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"messages": {
"items": {
"$ref": "#/$defs/TalkJSMessageItem"
},
"title": "Messages",
"type": "array"
},
"next_starting_after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Starting After"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
}
},
"title": "MachineMessageListResponse",
"type": "object"
}
},
{
"description": "List the mentorship plans (ongoing subscriptions) and one-off sessions a mentor offers. Use this after get_mentor_profile when the user is comparing what they'd get for the money.\n\nTWO DIFFERENT BOOKING ROUTES — pay attention to `booking_route` on each item:\n - `subscriptions[]` (ongoing mentorship): book via the apply flow. Each subscription item already includes its `booking_url`. You can also pass its `hash` to create_booking_link(plan_hash=...).\n - `one_off_sessions[]`: book directly on the session page. Each item includes its `booking_url` — share THAT URL with the user, do NOT route a one-off session through create_booking_link.\n\nTop-level `requires_intro_call` flags whether this mentor offers an intro call before signup (free or paid). When true, all subscription booking_urls route the user to the scheduler first. Read `intro_call_note` for whether it is free or paid, and mention that to the user when you share the link.",
"inputSchema": {
"properties": {
"username": {
"title": "Username",
"type": "string"
}
},
"required": [
"username"
],
"title": "get_sessions_or_servicesArguments",
"type": "object"
},
"name": "get_sessions_or_services",
"outputSchema": {
"$defs": {
"PricingPlanItem": {
"description": "An ongoing-mentorship subscription plan.",
"properties": {
"booking_route": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "apply",
"description": "Always 'apply' for subscriptions.",
"title": "Booking Route"
},
"booking_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Deep link to start this subscription (the /apply/ route).",
"title": "Booking Url"
},
"call_length_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Length of each call in minutes.",
"title": "Call Length Min"
},
"calls_per_month": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Calls included per month.",
"title": "Calls Per Month"
},
"hands_on": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether the plan includes hands-on help.",
"title": "Hands On"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Plan hash; pass to create_booking_link(plan_hash=...).",
"title": "Hash"
},
"monthly_price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Monthly price in USD.",
"title": "Monthly Price Usd"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Plan name.",
"title": "Name"
},
"open_spots": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Open slots on this plan.",
"title": "Open Spots"
},
"quarterly_available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether a quarterly billing option exists.",
"title": "Quarterly Available"
},
"response_time_hours": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Expected response time in hours; may be fractional.",
"title": "Response Time Hours"
},
"tasks": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether the plan includes task/assignment support.",
"title": "Tasks"
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "subscription",
"description": "Always 'subscription'.",
"title": "Type"
}
},
"title": "PricingPlanItem",
"type": "object"
},
"SessionItem": {
"description": "A one-off bookable session.",
"properties": {
"available": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Slots currently available.",
"title": "Available"
},
"booking_route": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "session",
"description": "Always 'session' for one-off sessions.",
"title": "Booking Route"
},
"booking_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Direct booking URL (the /sessions/ route). Share this URL directly; do NOT route through create_booking_link.",
"title": "Booking Url"
},
"duration_min": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Session length in minutes.",
"title": "Duration Min"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Session setup id.",
"title": "Id"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Session name.",
"title": "Name"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "One-off price in USD.",
"title": "Price Usd"
},
"type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "session",
"description": "Always 'session'.",
"title": "Type"
}
},
"title": "SessionItem",
"type": "object"
}
},
"description": "Return shape of get_sessions_or_services.",
"properties": {
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Error code: 'not_found' or 'rate_limit_exceeded'. Absent on success.",
"title": "Error"
},
"intro_call_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Guidance about the intro call (free or paid); null when the mentor offers none.",
"title": "Intro Call Note"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable error detail.",
"title": "Message"
},
"one_off_sessions": {
"description": "One-off bookable sessions.",
"items": {
"$ref": "#/$defs/SessionItem"
},
"title": "One Off Sessions",
"type": "array"
},
"requires_intro_call": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "When true, every subscription booking_url routes to the scheduler first; mention the intro call (see intro_call_note for free vs paid).",
"title": "Requires Intro Call"
},
"subscriptions": {
"description": "Ongoing mentorship plans, cheapest first.",
"items": {
"$ref": "#/$defs/PricingPlanItem"
},
"title": "Subscriptions",
"type": "array"
},
"username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Mentor slug.",
"title": "Username"
}
},
"title": "SessionsServicesResponse",
"type": "object"
}
},
{
"description": "List the signed-in mentee's open applications (draft, sent, pending payment, accepted). Requires Authorization: Bearer. Use pay_application when payable is true.",
"inputSchema": {
"properties": {},
"title": "list_applicationsArguments",
"type": "object"
},
"name": "list_applications",
"outputSchema": {
"$defs": {
"MachineApplicationItem": {
"description": "One open application from apply_to_mentor / list_applications.",
"properties": {
"action_required": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "reply_to_mentor, waiting_on_mentor, book_intro_call, or start_mentorship.",
"title": "Action Required"
},
"can_withdraw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when withdraw_application will succeed.",
"title": "Can Withdraw"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to pay_application.",
"title": "Hash"
},
"intro_call_scheduled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Intro Call Scheduled"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"messages": {
"items": {
"$ref": "#/$defs/PinaxMessageItem"
},
"title": "Messages",
"type": "array"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL that accepts an MPP credential if credits are short.",
"title": "Pay Url"
},
"payable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentor accepted and payment is due.",
"title": "Payable"
},
"plan_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Plan Hash"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"sent_message_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent Message Id"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "draft, new, pending, accepted, rejected, withdrawn.",
"title": "Status"
},
"status_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status Note"
},
"unread": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentee has an unread Pinax message.",
"title": "Unread"
}
},
"title": "MachineApplicationItem",
"type": "object"
},
"PinaxMessageItem": {
"description": "One Pinax message on an application thread.",
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentee, mentor, or other.",
"title": "Sender"
},
"sent_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent At"
}
},
"title": "PinaxMessageItem",
"type": "object"
}
},
"description": "list_applications.",
"properties": {
"applications": {
"items": {
"$ref": "#/$defs/MachineApplicationItem"
},
"title": "Applications",
"type": "array"
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
}
},
"title": "MachineApplicationListResponse",
"type": "object"
}
},
{
"description": "List MentorCruise's top-level mentor categories. Use this to ground recommendations in real category labels before calling search_mentors with a free-text query.",
"inputSchema": {
"properties": {},
"title": "list_categoriesArguments",
"type": "object"
},
"name": "list_categories",
"outputSchema": {
"$defs": {
"CategoryItem": {
"description": "A top-level mentor category.",
"properties": {
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Category id/value for grounding search queries.",
"title": "Id"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable category label.",
"title": "Label"
}
},
"title": "CategoryItem",
"type": "object"
}
},
"description": "Return shape of list_categories.",
"properties": {
"categories": {
"description": "Top-level mentor categories.",
"items": {
"$ref": "#/$defs/CategoryItem"
},
"title": "Categories",
"type": "array"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Error code, e.g. 'rate_limit_exceeded'. Absent on success.",
"title": "Error"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable error detail.",
"title": "Message"
}
},
"title": "CategoriesResponse",
"type": "object"
}
},
{
"description": "List the signed-in mentee's TalkJS conversations (active mentorships and intro sessions). Requires Authorization: Bearer. Application threads before mentorship starts are Pinax; use get_application for those.",
"inputSchema": {
"properties": {},
"title": "list_conversationsArguments",
"type": "object"
},
"name": "list_conversations",
"outputSchema": {
"$defs": {
"MachineConversationItem": {
"description": "One TalkJS conversation the mentee belongs to.",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to get_messages / send_message.",
"title": "Id"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentorship or intro_session.",
"title": "Kind"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
},
"unread": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Unread"
}
},
"title": "MachineConversationItem",
"type": "object"
}
},
"description": "list_conversations.",
"properties": {
"conversations": {
"items": {
"$ref": "#/$defs/MachineConversationItem"
},
"title": "Conversations",
"type": "array"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
}
},
"title": "MachineConversationListResponse",
"type": "object"
}
},
{
"description": "List open intro-call slots for an accepted application. Requires Authorization: Bearer. Available only when the mentor accepted and the intro call is not yet scheduled. Pick a start and call book_intro_call.",
"inputSchema": {
"properties": {
"application_hash": {
"title": "Application Hash",
"type": "string"
},
"timezone": {
"default": "UTC",
"title": "Timezone",
"type": "string"
}
},
"required": [
"application_hash"
],
"title": "list_intro_call_slotsArguments",
"type": "object"
},
"name": "list_intro_call_slots",
"outputSchema": {
"$defs": {
"SlotItem": {
"description": "One bookable calendar start time.",
"properties": {
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO-8601 datetime.",
"title": "Start"
}
},
"title": "SlotItem",
"type": "object"
}
},
"description": "list_*_slots tools.",
"properties": {
"application_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Application Hash"
},
"available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Available"
},
"booking_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Booking Url"
},
"calendar_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Calendar Link"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"mentorship_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentorship Hash"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"setup_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Setup Id"
},
"slots": {
"items": {
"$ref": "#/$defs/SlotItem"
},
"title": "Slots",
"type": "array"
},
"timezone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Timezone"
}
},
"title": "MachineSlotsResponse",
"type": "object"
}
},
{
"description": "List open mentorship-call slots for an active mentorship. Requires Authorization: Bearer. mentorship_hash comes from list_mentorships. If the mentor only has an external calendar link, this returns not_available plus that link.",
"inputSchema": {
"properties": {
"mentorship_hash": {
"title": "Mentorship Hash",
"type": "string"
},
"timezone": {
"default": "UTC",
"title": "Timezone",
"type": "string"
}
},
"required": [
"mentorship_hash"
],
"title": "list_mentorship_call_slotsArguments",
"type": "object"
},
"name": "list_mentorship_call_slots",
"outputSchema": {
"$defs": {
"SlotItem": {
"description": "One bookable calendar start time.",
"properties": {
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO-8601 datetime.",
"title": "Start"
}
},
"title": "SlotItem",
"type": "object"
}
},
"description": "list_*_slots tools.",
"properties": {
"application_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Application Hash"
},
"available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Available"
},
"booking_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Booking Url"
},
"calendar_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Calendar Link"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"mentorship_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentorship Hash"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"setup_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Setup Id"
},
"slots": {
"items": {
"$ref": "#/$defs/SlotItem"
},
"title": "Slots",
"type": "array"
},
"timezone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Timezone"
}
},
"title": "MachineSlotsResponse",
"type": "object"
}
},
{
"description": "List the signed-in mentee's active mentorships with dashboard URLs. Requires Authorization: Bearer. Use open_dashboard with kind=mentorship and mentorship_hash to mint a one-use login link.",
"inputSchema": {
"properties": {},
"title": "list_mentorshipsArguments",
"type": "object"
},
"name": "list_mentorships",
"outputSchema": {
"$defs": {
"MachineMentorshipItem": {
"description": "One active mentorship.",
"properties": {
"active": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Active"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"fee_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Fee Usd"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to open_dashboard as mentorship_hash.",
"title": "Hash"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
}
},
"title": "MachineMentorshipItem",
"type": "object"
}
},
"description": "list_mentorships.",
"properties": {
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"mentorships": {
"items": {
"$ref": "#/$defs/MachineMentorshipItem"
},
"title": "Mentorships",
"type": "array"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
}
},
"title": "MachineMentorshipListResponse",
"type": "object"
}
},
{
"description": "List open one-off session slots for a mentor's SessionSetup. Requires Authorization: Bearer. setup_id comes from get_sessions_or_services one_off_sessions[].id. Then call book_session with a start.",
"inputSchema": {
"properties": {
"setup_id": {
"title": "Setup Id",
"type": "integer"
},
"timezone": {
"default": "UTC",
"title": "Timezone",
"type": "string"
}
},
"required": [
"setup_id"
],
"title": "list_session_slotsArguments",
"type": "object"
},
"name": "list_session_slots",
"outputSchema": {
"$defs": {
"SlotItem": {
"description": "One bookable calendar start time.",
"properties": {
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO-8601 datetime.",
"title": "Start"
}
},
"title": "SlotItem",
"type": "object"
}
},
"description": "list_*_slots tools.",
"properties": {
"application_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Application Hash"
},
"available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Available"
},
"booking_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Booking Url"
},
"calendar_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Calendar Link"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"mentorship_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentorship Hash"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"setup_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Setup Id"
},
"slots": {
"items": {
"$ref": "#/$defs/SlotItem"
},
"title": "Slots",
"type": "array"
},
"timezone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Timezone"
}
},
"title": "MachineSlotsResponse",
"type": "object"
}
},
{
"description": "Mint a one-use browser URL that signs the mentee into their dashboard. kind is 'applications' (default), 'home', or 'mentorship' (pass mentorship_hash). Requires Authorization: Bearer. The link expires in 30 minutes and works once.",
"inputSchema": {
"properties": {
"kind": {
"default": "applications",
"title": "Kind",
"type": "string"
},
"mentorship_hash": {
"default": "",
"title": "Mentorship Hash",
"type": "string"
}
},
"title": "open_dashboardArguments",
"type": "object"
},
"name": "open_dashboard",
"outputSchema": {
"description": "open_dashboard.",
"properties": {
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "One-use URL. Open in a browser. Expires in 30 minutes.",
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"expires_in_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Expires In Seconds"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
}
},
"title": "MachineDashboardResponse",
"type": "object"
}
},
{
"description": "Pay for an accepted application from the mentee's credit balance. Requires Authorization: Bearer. If credits are short this returns payment_required. MCP clients cannot send HTTP Payment headers — pass payment_credential if the host wallet provides an MPP object, or use open_dashboard and pay in the browser, then retry.",
"inputSchema": {
"properties": {
"application_hash": {
"title": "Application Hash",
"type": "string"
},
"payment_credential": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Credential"
}
},
"required": [
"application_hash"
],
"title": "pay_applicationArguments",
"type": "object"
},
"name": "pay_application",
"outputSchema": {
"$defs": {
"MachineApplicationItem": {
"description": "One open application from apply_to_mentor / list_applications.",
"properties": {
"action_required": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "reply_to_mentor, waiting_on_mentor, book_intro_call, or start_mentorship.",
"title": "Action Required"
},
"can_withdraw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when withdraw_application will succeed.",
"title": "Can Withdraw"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to pay_application.",
"title": "Hash"
},
"intro_call_scheduled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Intro Call Scheduled"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"messages": {
"items": {
"$ref": "#/$defs/PinaxMessageItem"
},
"title": "Messages",
"type": "array"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL that accepts an MPP credential if credits are short.",
"title": "Pay Url"
},
"payable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentor accepted and payment is due.",
"title": "Payable"
},
"plan_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Plan Hash"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"sent_message_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent Message Id"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "draft, new, pending, accepted, rejected, withdrawn.",
"title": "Status"
},
"status_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status Note"
},
"unread": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentee has an unread Pinax message.",
"title": "Unread"
}
},
"title": "MachineApplicationItem",
"type": "object"
},
"MachineChallenge": {
"description": "MPP Challenge parameters returned on payment_required.",
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable charge purpose.",
"title": "Description"
},
"expires": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO-8601 expiry.",
"title": "Expires"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "HMAC-bound challenge id.",
"title": "Id"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'charge'.",
"title": "Intent"
},
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'stripe'.",
"title": "Method"
},
"opaque": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url JSON bound to this mentee.",
"title": "Opaque"
},
"realm": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "MPP realm, e.g. mentorcruise.com.",
"title": "Realm"
},
"request": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url JSON amount/currency.",
"title": "Request"
}
},
"title": "MachineChallenge",
"type": "object"
},
"MachineMentorshipItem": {
"description": "One active mentorship.",
"properties": {
"active": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Active"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"fee_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Fee Usd"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to open_dashboard as mentorship_hash.",
"title": "Hash"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
}
},
"title": "MachineMentorshipItem",
"type": "object"
},
"PinaxMessageItem": {
"description": "One Pinax message on an application thread.",
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentee, mentor, or other.",
"title": "Sender"
},
"sent_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent At"
}
},
"title": "PinaxMessageItem",
"type": "object"
}
},
"description": "pay_application / top_up_credits, including payment_required.",
"properties": {
"amount_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Charge or top-up amount in whole USD.",
"title": "Amount Usd"
},
"application": {
"anyOf": [
{
"$ref": "#/$defs/MachineApplicationItem"
},
{
"type": "null"
}
],
"default": null
},
"application_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Application Hash"
},
"available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Available"
},
"billing_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Billing Note"
},
"booking_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Booking Hash"
},
"calendar_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Calendar Link"
},
"challenge": {
"anyOf": [
{
"$ref": "#/$defs/MachineChallenge"
},
{
"type": "null"
}
],
"default": null,
"description": "MPP challenge. Present when error is payment_required."
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "usd",
"title": "Currency"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "payment_required, invalid_payment, auth_required, not_found, etc.",
"title": "Error"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "charge",
"title": "Intent"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "intro_call, mentorship_call, or session.",
"title": "Kind"
},
"mentorship": {
"anyOf": [
{
"$ref": "#/$defs/MachineMentorshipItem"
},
{
"type": "null"
}
],
"default": null
},
"mentorship_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentorship Hash"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "stripe",
"title": "Method"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL to retry with an MPP Payment credential.",
"title": "Pay Url"
},
"receipt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url MPP receipt.",
"title": "Receipt"
},
"setup_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Setup Id"
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'paid', 'topped_up', or absent on payment_required.",
"title": "Status"
},
"www_authenticate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "WWW-Authenticate Payment header value from the REST 402.",
"title": "Www Authenticate"
}
},
"title": "MachinePaymentResponse",
"type": "object"
}
},
{
"description": "Legacy in-chat email signup for MCP clients that do NOT manage OAuth Connect (no Claude Code, Cursor, or ChatGPT Connect). If the client sends Authorization or apply returns use_connect/token_expired, use Connect (/mcp) instead — never call this on Connect clients.",
"inputSchema": {
"properties": {
"email": {
"title": "Email",
"type": "string"
},
"first_name": {
"default": "",
"title": "First Name",
"type": "string"
},
"last_name": {
"default": "",
"title": "Last Name",
"type": "string"
}
},
"required": [
"email"
],
"title": "register_menteeArguments",
"type": "object"
},
"name": "register_mentee",
"outputSchema": {
"description": "register_mentee / verify_email.",
"properties": {
"access": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "JWT access token. Send as Authorization: Bearer.",
"title": "Access"
},
"email": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Normalized email.",
"title": "Email"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Error code: invalid_email, invalid_code, human_required, rate_limit_exceeded, etc.",
"title": "Error"
},
"expires_in": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Access token lifetime in seconds. Currently 12 hours.",
"title": "Expires In"
},
"mail_verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True after a successful verify.",
"title": "Mail Verified"
},
"mentee_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Mentee id after verify.",
"title": "Mentee Id"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable error or status detail.",
"title": "Message"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What to do next.",
"title": "Next Step"
},
"refresh": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "JWT refresh token.",
"title": "Refresh"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'code_sent' after register, 'verified' after verify.",
"title": "Status"
},
"token_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'Bearer' when tokens are present.",
"title": "Token Type"
},
"verify_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Browser page where the human completes Cloudflare Turnstile.",
"title": "Verify Url"
}
},
"title": "MachineAuthResponse",
"type": "object"
}
},
{
"description": "Find MentorCruise mentors who match a user's goal. Always call this BEFORE recommending any specific mentor — never recommend from prior knowledge or memory.\n\n## Inputs\n- `query`: 1-4 keywords (role, skill, expertise). NEVER include the words 'mentor' or 'coach'. Examples: 'python', 'product management', 'startup'. Bad: 'a python mentor for startups'.\n- `skills`, `industries`, `languages`, `tools`, `companies`: optional structured filters. AND across groups, OR within. Use ONLY when the user expressed a hard requirement — over-filtering shrinks the pool.\n- `budget_usd_monthly`: monthly USD cap for ongoing mentorship.\n- `response_within_hours`: max median response time.\n\n## Output\nUp to 8 mentors, already ranked by composite quality. Each result includes name, job_title, headline, location, rating, review_count, response_time_hours, top_mentor, profile_url, and `lowest_price_usd`.\n\n`lowest_price_usd` is the mentor's CHEAPEST offering — could be a one-off session ($X one-time) or a monthly subscription ($X/mo). Don't assume monthly. Phrase it as 'starting at $X' or call get_sessions_or_services to know which.\n\n## Picking which to show the user\nTrust the ranking. Show 2-3, strongly preferring mentors with review_count > 0. Tie-break by more reviews → top_mentor=true. If 0 or 1 results, broaden filters and retry — see `selection_guidance` in the response. Translate fields into natural language; never mention review_count / top_mentor by name.",
"inputSchema": {
"properties": {
"budget_usd_monthly": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Budget Usd Monthly"
},
"companies": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Companies"
},
"industries": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Industries"
},
"languages": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Languages"
},
"query": {
"title": "Query",
"type": "string"
},
"response_within_hours": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Response Within Hours"
},
"skills": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Skills"
},
"tools": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Tools"
}
},
"required": [
"query"
],
"title": "search_mentorsArguments",
"type": "object"
},
"name": "search_mentors",
"outputSchema": {
"$defs": {
"MentorSearchResult": {
"description": "One mentor in a search_mentors result, already ranked by quality.",
"properties": {
"headline": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "One-line self-description.",
"title": "Headline"
},
"industries": {
"description": "Industry tags.",
"items": {
"type": "string"
},
"title": "Industries",
"type": "array"
},
"job_title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Current role, e.g. 'Staff Engineer'.",
"title": "Job Title"
},
"languages": {
"description": "Languages the mentor speaks.",
"items": {
"type": "string"
},
"title": "Languages",
"type": "array"
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Display location, e.g. 'Berlin, DE'.",
"title": "Location"
},
"lowest_price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Cheapest offering in USD - may be a one-off session or a monthly subscription. Phrase as 'starting at $X'; call get_sessions_or_services to know which.",
"title": "Lowest Price Usd"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Mentor's full name.",
"title": "Name"
},
"profile_image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Profile image path; run through the cdn.mentorcruise.com image transform.",
"title": "Profile Image"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Absolute URL to the public profile.",
"title": "Profile Url"
},
"rating": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Average review rating (0-5), or null if unrated.",
"title": "Rating"
},
"response_time_hours": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Median response time in hours; may be fractional (e.g. 1.5).",
"title": "Response Time Hours"
},
"review_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Number of reviews. Strongly prefer mentors with a review count > 0.",
"title": "Review Count"
},
"skills": {
"description": "Skill tags.",
"items": {
"type": "string"
},
"title": "Skills",
"type": "array"
},
"top_mentor": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Whether the mentor holds Top Mentor status. Tie-breaker only; never mention by name.",
"title": "Top Mentor"
},
"username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Slug for follow-up tool calls (get_mentor_profile, create_booking_link).",
"title": "Username"
}
},
"title": "MentorSearchResult",
"type": "object"
}
},
"description": "Return shape of search_mentors.",
"properties": {
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Error code, e.g. 'rate_limit_exceeded'. Absent on success.",
"title": "Error"
},
"mentors": {
"description": "Up to 8 mentors, ranked by composite quality.",
"items": {
"$ref": "#/$defs/MentorSearchResult"
},
"title": "Mentors",
"type": "array"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable error detail.",
"title": "Message"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Suggested follow-up tool calls.",
"title": "Next Step"
},
"recovery_hints": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Present only when 0 results: suggestions for broadening the search.",
"title": "Recovery Hints"
},
"results_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Total matches found (may exceed the returned list).",
"title": "Results Count"
},
"selection_guidance": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "How to pick which mentors to show the user.",
"title": "Selection Guidance"
}
},
"title": "SearchResponse",
"type": "object"
}
},
{
"description": "Send a message on an open application's Pinax thread. Requires Authorization: Bearer. Use this before mentorship starts. After an active mentorship exists, use send_message instead. Do not include scheduling links.",
"inputSchema": {
"properties": {
"application_hash": {
"title": "Application Hash",
"type": "string"
},
"content": {
"title": "Content",
"type": "string"
}
},
"required": [
"application_hash",
"content"
],
"title": "send_application_messageArguments",
"type": "object"
},
"name": "send_application_message",
"outputSchema": {
"$defs": {
"PinaxMessageItem": {
"description": "One Pinax message on an application thread.",
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentee, mentor, or other.",
"title": "Sender"
},
"sent_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent At"
}
},
"title": "PinaxMessageItem",
"type": "object"
}
},
"description": "One open application from apply_to_mentor / list_applications.",
"properties": {
"action_required": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "reply_to_mentor, waiting_on_mentor, book_intro_call, or start_mentorship.",
"title": "Action Required"
},
"can_withdraw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when withdraw_application will succeed.",
"title": "Can Withdraw"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to pay_application.",
"title": "Hash"
},
"intro_call_scheduled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Intro Call Scheduled"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"messages": {
"items": {
"$ref": "#/$defs/PinaxMessageItem"
},
"title": "Messages",
"type": "array"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL that accepts an MPP credential if credits are short.",
"title": "Pay Url"
},
"payable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentor accepted and payment is due.",
"title": "Payable"
},
"plan_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Plan Hash"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"sent_message_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent Message Id"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "draft, new, pending, accepted, rejected, withdrawn.",
"title": "Status"
},
"status_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status Note"
},
"unread": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentee has an unread Pinax message.",
"title": "Unread"
}
},
"title": "MachineApplicationItem",
"type": "object"
}
},
{
"description": "Send a TalkJS message in an active mentorship or intro-session conversation. Requires Authorization: Bearer. conversation_id comes from list_conversations. For an application that is not yet a mentorship, use send_application_message.",
"inputSchema": {
"properties": {
"content": {
"title": "Content",
"type": "string"
},
"conversation_id": {
"title": "Conversation Id",
"type": "string"
}
},
"required": [
"conversation_id",
"content"
],
"title": "send_messageArguments",
"type": "object"
},
"name": "send_message",
"outputSchema": {
"description": "send_message.",
"properties": {
"conversation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Conversation Id"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Kind"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status"
}
},
"title": "MachineMessageSendResponse",
"type": "object"
}
},
{
"description": "Top up the signed-in mentee's credit balance. Mentorships are billed from credits, not from a Stripe Connect subscription on the agent's card. Without an MPP credential this returns payment_required. MCP clients cannot send HTTP Payment headers — pass payment_credential (Stripe shared payment token object) if the host wallet provides one, or use open_dashboard and pay in the browser, then retry.",
"inputSchema": {
"properties": {
"amount_usd": {
"title": "Amount Usd",
"type": "integer"
},
"payment_credential": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Credential"
}
},
"required": [
"amount_usd"
],
"title": "top_up_creditsArguments",
"type": "object"
},
"name": "top_up_credits",
"outputSchema": {
"$defs": {
"MachineApplicationItem": {
"description": "One open application from apply_to_mentor / list_applications.",
"properties": {
"action_required": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "reply_to_mentor, waiting_on_mentor, book_intro_call, or start_mentorship.",
"title": "Action Required"
},
"can_withdraw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when withdraw_application will succeed.",
"title": "Can Withdraw"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to pay_application.",
"title": "Hash"
},
"intro_call_scheduled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Intro Call Scheduled"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"messages": {
"items": {
"$ref": "#/$defs/PinaxMessageItem"
},
"title": "Messages",
"type": "array"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL that accepts an MPP credential if credits are short.",
"title": "Pay Url"
},
"payable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentor accepted and payment is due.",
"title": "Payable"
},
"plan_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Plan Hash"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"sent_message_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent Message Id"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "draft, new, pending, accepted, rejected, withdrawn.",
"title": "Status"
},
"status_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status Note"
},
"unread": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentee has an unread Pinax message.",
"title": "Unread"
}
},
"title": "MachineApplicationItem",
"type": "object"
},
"MachineChallenge": {
"description": "MPP Challenge parameters returned on payment_required.",
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable charge purpose.",
"title": "Description"
},
"expires": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO-8601 expiry.",
"title": "Expires"
},
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "HMAC-bound challenge id.",
"title": "Id"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'charge'.",
"title": "Intent"
},
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'stripe'.",
"title": "Method"
},
"opaque": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url JSON bound to this mentee.",
"title": "Opaque"
},
"realm": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "MPP realm, e.g. mentorcruise.com.",
"title": "Realm"
},
"request": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url JSON amount/currency.",
"title": "Request"
}
},
"title": "MachineChallenge",
"type": "object"
},
"MachineMentorshipItem": {
"description": "One active mentorship.",
"properties": {
"active": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Active"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"fee_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Fee Usd"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to open_dashboard as mentorship_hash.",
"title": "Hash"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
}
},
"title": "MachineMentorshipItem",
"type": "object"
},
"PinaxMessageItem": {
"description": "One Pinax message on an application thread.",
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentee, mentor, or other.",
"title": "Sender"
},
"sent_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent At"
}
},
"title": "PinaxMessageItem",
"type": "object"
}
},
"description": "pay_application / top_up_credits, including payment_required.",
"properties": {
"amount_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Charge or top-up amount in whole USD.",
"title": "Amount Usd"
},
"application": {
"anyOf": [
{
"$ref": "#/$defs/MachineApplicationItem"
},
{
"type": "null"
}
],
"default": null
},
"application_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Application Hash"
},
"available": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Available"
},
"billing_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Billing Note"
},
"booking_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Booking Hash"
},
"calendar_link": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Calendar Link"
},
"challenge": {
"anyOf": [
{
"$ref": "#/$defs/MachineChallenge"
},
{
"type": "null"
}
],
"default": null,
"description": "MPP challenge. Present when error is payment_required."
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "usd",
"title": "Currency"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"end": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "End"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "payment_required, invalid_payment, auth_required, not_found, etc.",
"title": "Error"
},
"intent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "charge",
"title": "Intent"
},
"kind": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "intro_call, mentorship_call, or session.",
"title": "Kind"
},
"mentorship": {
"anyOf": [
{
"$ref": "#/$defs/MachineMentorshipItem"
},
{
"type": "null"
}
],
"default": null
},
"mentorship_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentorship Hash"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "stripe",
"title": "Method"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL to retry with an MPP Payment credential.",
"title": "Pay Url"
},
"receipt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64url MPP receipt.",
"title": "Receipt"
},
"setup_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Setup Id"
},
"start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Start"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'paid', 'topped_up', or absent on payment_required.",
"title": "Status"
},
"www_authenticate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "WWW-Authenticate Payment header value from the REST 402.",
"title": "Www Authenticate"
}
},
"title": "MachinePaymentResponse",
"type": "object"
}
},
{
"description": "Legacy in-chat email confirmation for non-Connect MCP clients only. Returns a Bearer JWT only if the client will send it on later requests (most Connect clients will not). If Authorization is already sent, returns use_connect — run /mcp instead. Never invent the code.",
"inputSchema": {
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"email": {
"title": "Email",
"type": "string"
}
},
"required": [
"email",
"code"
],
"title": "verify_emailArguments",
"type": "object"
},
"name": "verify_email",
"outputSchema": {
"description": "register_mentee / verify_email.",
"properties": {
"access": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "JWT access token. Send as Authorization: Bearer.",
"title": "Access"
},
"email": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Normalized email.",
"title": "Email"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Error code: invalid_email, invalid_code, human_required, rate_limit_exceeded, etc.",
"title": "Error"
},
"expires_in": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Access token lifetime in seconds. Currently 12 hours.",
"title": "Expires In"
},
"mail_verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True after a successful verify.",
"title": "Mail Verified"
},
"mentee_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Mentee id after verify.",
"title": "Mentee Id"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Human-readable error or status detail.",
"title": "Message"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What to do next.",
"title": "Next Step"
},
"refresh": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "JWT refresh token.",
"title": "Refresh"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'code_sent' after register, 'verified' after verify.",
"title": "Status"
},
"token_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Always 'Bearer' when tokens are present.",
"title": "Token Type"
},
"verify_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Browser page where the human completes Cloudflare Turnstile.",
"title": "Verify Url"
}
},
"title": "MachineAuthResponse",
"type": "object"
}
},
{
"description": "Withdraw an open application the signed-in mentee owns. Requires Authorization: Bearer. Only works when list/get_application reports can_withdraw true (sent at least two days ago, no intro session). This cannot be undone.",
"inputSchema": {
"properties": {
"application_hash": {
"title": "Application Hash",
"type": "string"
}
},
"required": [
"application_hash"
],
"title": "withdraw_applicationArguments",
"type": "object"
},
"name": "withdraw_application",
"outputSchema": {
"$defs": {
"PinaxMessageItem": {
"description": "One Pinax message on an application thread.",
"properties": {
"content": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Content"
},
"id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Id"
},
"sender": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "mentee, mentor, or other.",
"title": "Sender"
},
"sent_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent At"
}
},
"title": "PinaxMessageItem",
"type": "object"
}
},
"description": "One open application from apply_to_mentor / list_applications.",
"properties": {
"action_required": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "reply_to_mentor, waiting_on_mentor, book_intro_call, or start_mentorship.",
"title": "Action Required"
},
"can_withdraw": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when withdraw_application will succeed.",
"title": "Can Withdraw"
},
"created_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Created At"
},
"credits_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Credits Usd"
},
"dashboard_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Dashboard Url"
},
"error": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Error"
},
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Pass to pay_application.",
"title": "Hash"
},
"intro_call_scheduled": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Intro Call Scheduled"
},
"mentor_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Name"
},
"mentor_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Mentor Username"
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Message"
},
"messages": {
"items": {
"$ref": "#/$defs/PinaxMessageItem"
},
"title": "Messages",
"type": "array"
},
"next_step": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Next Step"
},
"pay_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "REST URL that accepts an MPP credential if credits are short.",
"title": "Pay Url"
},
"payable": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentor accepted and payment is due.",
"title": "Payable"
},
"plan_hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Plan Hash"
},
"price_usd": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Price Usd"
},
"sent_message_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Sent Message Id"
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "draft, new, pending, accepted, rejected, withdrawn.",
"title": "Status"
},
"status_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Status Note"
},
"unread": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "True when the mentee has an unread Pinax message.",
"title": "Unread"
}
},
"title": "MachineApplicationItem",
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:75093d360e5201e95a71f0efee8bb079158c4a0b11f76435ce1d6ad572c3d14a | sha256sum