Chorus

Starts a book of voice, video and written messages for one person, and returns the single link the organiser sends to everyone taking part. Gathering is free and the people recording need no app and no account. Use this as soon as somebody wants to collect messages from a group for one person, whether or not there is an occasion. The first call emails the organiser an eight digit code and makes nothing. Call it again with the same details and the code, and the book is made in their account.

{
  "type": "object",
  "properties": {
    "subject_name": {
      "type": "string",
      "description": "Who the book is for, as the organiser says it, for example Mum."
    },
    "organiser_email": {
      "type": "string",
      "description": "The organiser’s email. The book belongs to this address and they get in with an eight digit code."
    },
    "code": {
      "type": "string",
      "description": "The eight digit code emailed to the organiser. Leave it out on the first call to have one sent."
    },
    "occasion": {
      "type": "string",
      "description": "A big birthday, A wedding, A new baby, As they grow, In memory, or Something else. Plain words are matched to one of those."
    },
    "closes_on": {
      "type": "string",
      "description": "The day collecting stops, as 2026-11-14. Allow three weeks before the day if a printed copy is wanted."
    },
    "expecting": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Who is expected to record, by name or role, so book_status can say who is still out. Never email addresses."
    },
    "answer_with": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Any of voice, video and written. Voice and written when not said."
    },
    "lead_with": {
      "type": "string",
      "description": "Which of those is the big button on a contributor’s phone."
    },
    "questions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Questions to ask, if the organiser wants their own. The set for the occasion is used when this is left out."
    }
  },
  "required": [
    "subject_name",
    "organiser_email"
  ]
}

Returns the link to forward to contributors, the link that plays every message straight through, and a short message the organiser can paste alongside.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    }
  },
  "required": [
    "book"
  ]
}

Records who is expected to record. Somebody with an email address can be written to by send_it_out and reminded by chase_the_missing; somebody with only a name is reached in a group chat and their name is what the chase reads out. Adding a person sends nothing on its own.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    },
    "people": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The people, each as a name, or as a name and an email address. A name on its own is somebody reached in a group chat."
    }
  },
  "required": [
    "book",
    "people"
  ]
}

Emails the invitation once to every person added with an address, and hands back a tap that opens WhatsApp, a text or a mail draft with the message and the link already written, for the family group and for anyone with no address. Nobody is written to twice by this tool, and a caller sends a limited number of emails a day.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    },
    "also_email": {
      "type": "boolean",
      "description": "Leave it out to send the invitation. Set it false to get the taps only and send nothing."
    }
  },
  "required": [
    "book"
  ]
}

Works out who is still out, emails a reminder to the ones with an address, and hands back a message naming them, ready for the group chat and ready for one person. A person gets at most one reminder a day and three in all, and never one after they have asked to stop.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    },
    "also_email": {
      "type": "boolean",
      "description": "Leave it out to send the reminder. Set it false to get the message and the taps only."
    }
  },
  "required": [
    "book"
  ]
}

Returns who is in with their name and relationship, how many voices, videos and written messages have landed, how many carried a photo, who the organiser is still waiting on, and the days left before collecting stops.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    }
  },
  "required": [
    "book"
  ]
}

Call it with the email address the book belongs to and Chorus sends that address an eight digit code, returning nothing about the books. Call it again with the address and the code and it hands back every book on that account with its handle. Holding the mailbox is the proof, so a book cannot be found by guessing an address.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address the book belongs to."
    },
    "code": {
      "type": "string",
      "description": "The eight digit code that was emailed. Leave it out on the first call to have one sent."
    }
  },
  "required": [
    "email"
  ]
}

Changes the settings the organiser can change on the site: the day collecting stops, the questions people are asked, whether they may send voice, video or writing, and which one the button offers first. Nobody is told about a change.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    },
    "closes_on": {
      "type": "string",
      "description": "The day collecting stops, as a date. It means stop collecting rather than finished."
    },
    "questions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The questions people are asked, up to twelve."
    },
    "answer_with": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Any of voice, video and written."
    },
    "lead_with": {
      "type": "string",
      "description": "Which one the big button offers first."
    }
  },
  "required": [
    "book"
  ]
}

Returns the second link, which asks the person the book is for about their own life rather than about somebody else. It refuses on a memorial, a new baby and an as they grow book, where the person cannot answer, and it is never the link to put in a group chat.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    }
  },
  "required": [
    "book"
  ]
}

Returns every message with who left it and what they said. A written message reads back whatever was paid; a voice or a video is written out on the tier that includes the words, and where it is not, the tool says so rather than half-answering.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    }
  },
  "required": [
    "book"
  ]
}

Stops new messages arriving and returns the final counts with the gift link. Nothing is deleted and nothing is finished; it can be reopened.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    }
  },
  "required": [
    "book"
  ]
}

Reopens a book that was closed or whose date ran out, and returns the collecting link to send round again.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    },
    "closes_on": {
      "type": "string",
      "description": "A new day to stop collecting, as 2026-11-14."
    }
  },
  "required": [
    "book"
  ]
}

Returns a payment link for one of the three ways to keep the book: voices, book, or keepsake, which is the printed hardcover. Stripe shows the price and takes the card and, on the keepsake, the postal address. This tool never takes a card and never names a price. Read the prices from https://choruskeepsake.com/llms.txt when the person asks what it costs.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    },
    "option": {
      "type": "string",
      "description": "voices, book, or keepsake. Only the keepsake is printed and posted."
    }
  },
  "required": [
    "book",
    "option"
  ]
}

Returns whether the book has been paid for and which option was bought, and on a printed one the stage the printer is at with the tracking.

{
  "type": "object",
  "properties": {
    "book": {
      "type": "string",
      "description": "The handle start_book gave you."
    }
  },
  "required": [
    "book"
  ]
}