Passes SATCoach what the assistant already knows about a child's SAT plans (target score, past PSAT, SAT, or ACT scores, upcoming test dates, weekly practice time, and other help), and SATCoach sends the parent one email from hello@satcoach.ai with a link to set up SATCoach for their child. Only for a parent who wants SAT help for their child and wants SATCoach to follow up; not for a student asking for themselves, for answering questions about SATCoach, or for starting the free skill check. Requires the parent's yes after they've seen exactly what will be sent; consent must be true. Requires agent, the calling assistant's identity. Accepts only the child's first name; last names, school names, phone numbers, health, disability, or accommodation details, and other children's information must not be included, in note either. The reply is the same whether or not the parent already has an account, for example: "SATCoach sent a link to p•••@example.com. The email repeats only the child's first name, target score, and next test date. Everything shared shows on the page the link opens, after the parent signs in. The request is deleted in 7 days if the parent doesn't confirm."
View input schema
{
"type": "object",
"properties": {
"agent": {
"description": "Required. The calling assistant's identity: {name, e.g. \"Claude\"; provider, e.g. \"Anthropic\"; model?; surface: web (a browser chat site) | desktop_app (a computer app) | mobile_app (a phone or tablet app) | messaging_app (in a messaging app) | voice (spoken, not typed) | api_or_agent (called from code or an agent framework, not a chat app) | other (none of these); discoveredVia, how it found SATCoach; discoveredDetail?}. Plain text about the assistant, never the family: no links, markup, emails, phone numbers or web addresses. The parent sees only a fixed name such as \"Claude\".",
"type": "object",
"properties": {
"name": {
"type": "string"
},
"provider": {
"type": "string"
},
"model": {
"type": "string"
},
"surface": {
"type": "string",
"enum": [
"web",
"desktop_app",
"mobile_app",
"messaging_app",
"voice",
"api_or_agent",
"other"
]
},
"discoveredVia": {
"type": "string",
"enum": [
"user_named_satcoach",
"user_gave_link",
"web_search",
"mcp_registry",
"mcp_directory",
"assistant_app_store",
"prior_conversation",
"other"
]
},
"discoveredDetail": {
"type": "string"
}
},
"required": [
"name",
"provider",
"surface",
"discoveredVia"
],
"additionalProperties": false
},
"parentEmail": {
"description": "Required. The parent's email address. SATCoach sends the link here.",
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"childFirstName": {
"description": "Required. The child's first name only: 1 to 30 letters, spaces, hyphens, or apostrophes, starting and ending with a letter. No last name.",
"type": "string",
"pattern": "^\\p{L}(?:[\\p{L}\\p{M} '’-]{0,28}[\\p{L}\\p{M}])?$"
},
"goal": {
"description": "Optional. {targetScore?: 400 to 1600 in steps of 10, reason?: college_admission | scholarship | school_requirement | personal | other}, with at least one of the two.",
"type": "object",
"properties": {
"targetScore": {
"type": "integer",
"minimum": 400,
"maximum": 1600,
"multipleOf": 10
},
"reason": {
"type": "string",
"enum": [
"college_admission",
"scholarship",
"school_requirement",
"personal",
"other"
]
}
},
"additionalProperties": false
},
"pastTests": {
"description": "Optional. Up to 10 of {test: SAT | BLUEBOOK_PRACTICE | PSAT_NMSQT | PSAT_10 | PSAT_8_9 | ACT, month (YYYY-MM, not in the future), total, readingWriting?, math?}. Ranges: SAT and Bluebook practice tests 400 to 1600 (sections 200 to 800); PSAT/NMSQT and PSAT 10 320 to 1520 (sections 160 to 760); PSAT 8/9 240 to 1440 (sections 120 to 720); ACT composite 1 to 36, no sections.",
"maxItems": 10,
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"test": {
"type": "string",
"enum": [
"SAT",
"BLUEBOOK_PRACTICE"
]
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
},
"total": {
"type": "integer",
"minimum": 400,
"maximum": 1600
},
"readingWriting": {
"type": "integer",
"minimum": 200,
"maximum": 800
},
"math": {
"type": "integer",
"minimum": 200,
"maximum": 800
}
},
"required": [
"test",
"month",
"total"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"test": {
"type": "string",
"enum": [
"PSAT_NMSQT",
"PSAT_10"
]
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
},
"total": {
"type": "integer",
"minimum": 320,
"maximum": 1520
},
"readingWriting": {
"type": "integer",
"minimum": 160,
"maximum": 760
},
"math": {
"type": "integer",
"minimum": 160,
"maximum": 760
}
},
"required": [
"test",
"month",
"total"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"test": {
"type": "string",
"const": "PSAT_8_9"
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
},
"total": {
"type": "integer",
"minimum": 240,
"maximum": 1440
},
"readingWriting": {
"type": "integer",
"minimum": 120,
"maximum": 720
},
"math": {
"type": "integer",
"minimum": 120,
"maximum": 720
}
},
"required": [
"test",
"month",
"total"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"test": {
"type": "string",
"const": "ACT"
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
},
"total": {
"type": "integer",
"minimum": 1,
"maximum": 36
}
},
"required": [
"test",
"month",
"total"
],
"additionalProperties": false
}
]
}
},
"upcomingTests": {
"description": "Optional. Up to 3 of {test: SAT | PSAT_NMSQT | ACT, date (YYYY-MM-DD, or YYYY-MM when only the month is known; not in the past), registered: true or false}.",
"maxItems": 3,
"type": "array",
"items": {
"type": "object",
"properties": {
"test": {
"type": "string",
"enum": [
"SAT",
"PSAT_NMSQT",
"ACT"
]
},
"date": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])(-(0[1-9]|[12]\\d|3[01]))?$"
},
"registered": {
"type": "boolean"
}
},
"required": [
"test",
"date",
"registered"
],
"additionalProperties": false
}
},
"weeklyMinutes": {
"description": "Optional. Minutes a week the child can practice, 0 to 1200.",
"type": "integer",
"minimum": 0,
"maximum": 1200
},
"otherHelp": {
"description": "Optional. Other SAT help the child has: none | private_tutor | class | other_app.",
"type": "string",
"enum": [
"none",
"private_tutor",
"class",
"other_app"
]
},
"note": {
"description": "Optional, at most 500 characters. Anything else the parent wants SATCoach to know. It's never put in the email. Must not include last names, school names, phone numbers, or health, disability, or accommodation details.",
"type": "string",
"maxLength": 500
},
"consent": {
"description": "Required, must be true: the parent saw exactly what will be sent and agreed to share it with SATCoach and to get one email.",
"type": "boolean",
"const": true
}
},
"required": [
"agent",
"parentEmail",
"childFirstName",
"consent"
],
"additionalProperties": false,
"examples": [
{
"agent": {
"name": "Claude",
"provider": "Anthropic",
"surface": "web",
"discoveredVia": "mcp_directory",
"discoveredDetail": "Claude connector directory",
"model": "Claude Opus"
},
"parentEmail": "parent@example.com",
"childFirstName": "Ava",
"goal": {
"targetScore": 1450,
"reason": "college_admission"
},
"pastTests": [
{
"test": "PSAT_NMSQT",
"month": "2026-10",
"total": 1210,
"readingWriting": 620,
"math": 590
}
],
"upcomingTests": [
{
"test": "SAT",
"date": "2027-03-13",
"registered": true
},
{
"test": "ACT",
"date": "2027-04",
"registered": false
}
],
"weeklyMinutes": 150,
"otherHelp": "none",
"consent": true
},
{
"agent": {
"name": "ChatGPT",
"provider": "OpenAI",
"surface": "mobile_app",
"discoveredVia": "user_named_satcoach"
},
"parentEmail": "parent@example.com",
"childFirstName": "Leo",
"goal": {
"targetScore": 1300,
"reason": "school_requirement"
},
"consent": true
}
]
}