Get Cover Letter Cost
get_cover_letter_costEstimate how many credits a cover letter generation would cost for the given inputs. Does not create a cover letter or deduct credits. Prefer list_user_job_listings first so the user can pick a saved job and you pass jobListingId (omit companyName/role/jobPosition). Optionally pass sourceCoverLetterId to include regeneration discounts. Pair with get_user_profile (creditsAmount) to confirm the user can afford generation before create_cover_letter.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_cover_letter_cost"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Job role / title. Required when jobListingId is not provided. | |
| tone | No | Custom tone content (required when toneTemplate is "custom") | |
| files | No | Previously uploaded files (CV/resume) from list_user_files. Prefer these when present. Optional when personBio holds user-confirmed background from chat. | |
| language | No | ISO language code, e.g. "en" | en |
| jobMarket | No | Job market index: 0=Europe, 1=NorthAmerica, 2=SouthAndCentralAmerica, 3=MiddleEastAndAfrica, 4=AsiaPacific | |
| keyPoints | No | Up to 7 key points to highlight (max 50 chars each) | |
| personBio | No | Candidate bio / background. When list_user_files returns no CV/resume, use a bio the user confirmed in chat (they may have edited your draft). Draft from grounded data when available; never invent experience, skills, or education. Prefer uploaded files when available; personBio alone is enough to create without files. | |
| personName | No | Candidate full name | |
| companyName | No | Target company name. Required when jobListingId is not provided. | |
| jobPosition | No | Full job description. Required when jobListingId is not provided. | |
| jobListingId | No | ID from list_user_job_listings. When provided, company/role/job description are loaded from the saved listing — omit companyName, role, and jobPosition. Prefer this over manual fields whenever the user has a saved listing. | |
| toneTemplate | No | Tone template key, e.g. energetic, professional, custom | energetic |
| desiredLength | No | Length scale 0-4 (0=very short, 4=highly elaborate) | |
| personProfession | No | Candidate profession / title | |
| sourceCoverLetterId | No | If regenerating, ID of the source cover letter (applies regeneration discount when valid) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | No | ||
| kind | Yes | ||
| message | No |