Score Inbound Pitch
score_messageUse this, not intake_message (form and files only), for any recruiter pitch pasted in chat. When the user states their criteria (role, skills, salary floor, remote policy), always send them as criteria in this same call, even before set_criteria; they win over saved criteria and are not saved, so call set_criteria too if the user wants them kept. With no criteria it uses the saved desk. Returns an evaluation_id, a 0 to 100 composite and four sub-scores (relevance, specificity, cadence, spam where 100 is clean), flags, key reasons and an action: interested, request_info or decline. Saves a cleaned summary to the sender scoreboard; raw text is never stored. Send the whole pitch as message, and sender_domain as a bare host such as stripe.com or not at all. A client that sends no user id has no desk: send criteria; nothing is stored and evaluation_id is empty. Errors: no_desk means call set_criteria, then score again; no_user_id means send criteria. Never present intake_message's sample-profile score as the user's. draft_response takes the evaluation_id.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"message": "Dear Candidate, you would be an awesome rockstar ninja for our client onsite in Dallas.",
"sender_domain": "faststaffing.biz"
},
"name": "score_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sender | No | Optional sender email address, profile URL or domain, such as "jane@stripe.com". Used only when sender_domain is not given. | |
| message | Yes | The full pitch text the user pasted, such as "Hi, we are hiring a Staff Engineer at Stripe, $220k base, remote." | |
| criteria | No | The criteria to score against, in the shape set_criteria takes. Send it whenever the user states their criteria; it wins over the desk's saved criteria. All four fields are required, so ask the user for one they did not state rather than guess it. Required when the client sends no user id (no ChatGPT sign-in and no OAuth connection): the pitch is then scored and nothing is stored. | |
| cadence_days | No | Optional days since the previous message from this sender, 0 to 365, such as 2. Used only for the cadence sub-score. Defaults to 7. | |
| is_follow_up | No | Optional: true when this message follows up earlier outreach. Used only for the cadence sub-score. Defaults to false. | |
| sender_domain | No | Optional sender domain as a bare host name, such as "stripe.com" (no @, no https://). It wins over sender. With neither, the domain is read from the message, else unspecified-sender.com. | |
| previous_declined | No | Optional: true when the user already declined this sender. Used only for the cadence sub-score. Defaults to false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | Yes | Day of the call, as YYYY-MM-DD in UTC. | |
| flags | Yes | Warning flags. Values: missing_salary, dealbreaker_clash, token_failure (unfilled template token such as [Current Company]), aggressive_drip, repeat_after_decline, slop, artificial_urgency, free_webmail. Empty when the pitch is clean. | |
| source | Yes | Where the data comes from: the user's own private desk. | |
| summary | Yes | Short cleaned summary of the pitch with contact details removed; this is what is stored. | |
| breakdown | Yes | The four sub-scores, each an integer from 0 to 100 where higher is better. | |
| key_reasons | Yes | Plain reasons behind the scores. | |
| evaluation_id | Yes | Id of this evaluation; pass it to draft_response. Kept for 30 days. Empty when nothing was stored because the client sends no user id. | |
| sender_domain | Yes | Sender domain the pitch is counted under on the scoreboard. | |
| composite_score | Yes | Overall score from 0 to 100; 85 or more is a strong pitch. | |
| recommended_action | Yes | Suggested reply: interested, request_info or decline. |