Endpoints: 76,849MCP servers: 32,728Payout addresses: 3,825Paid calls: 6,146Letters: 84Defects: 3,892counted 2 min ago
teppi

Server definition

Hash
sha256:be3e8a5cae057fcdb9e10a156933271dd81a27a69cebe601e966d3891e8d1334
What it is
What a remote MCP server returned when asked what it offers: 35 tools

The blob, as servednamed by its sha256

{ "instructions": "ApplySent finds jobs that match the user's résumé and applies to them on the employer's own site, using automation and AI on the user's behalf. Reading changes nothing. Every application is a separate decision of the user: preview_application shows what will be sent and returns a single-use confirmation token for that one job, and apply_to_job sends only with that token. Answers to employer questions are stored exactly as given; ApplySent never invents facts about the user.", "tools": [ { "description": "Saves the given answer to one open question and applies it to every application asking it; those applications then continue. The answer is stored exactly as given, as the user's own words or the option they chose. Returns the applications answered and those now ready to continue. Sends nothing.", "inputSchema": { "additionalProperties": false, "properties": { "answer": { "description": "The user's own answer, or the exact option they picked.", "type": "string" }, "batch_id": { "description": "The question group from list_pending_questions the question belongs to.", "type": "integer" }, "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "question_index": { "description": "Which question of that group to answer, as list_pending_questions numbers it.", "minimum": 0, "type": "integer" } }, "required": [ "batch_id", "question_index", "answer" ], "type": "object" }, "name": "answer_question", "outputSchema": { "properties": { "answered": { "description": "The applications the answer was applied to.", "items": { "description": "One job id answered.", "type": "string" }, "type": "array" }, "banked": { "description": "How many reusable answers the answer was stored as.", "type": "integer" }, "profile_field": { "description": "The profile field the answer was saved to, when it is a fact the profile keeps.", "type": [ "string", "null" ] }, "ready": { "description": "The applications left with nothing to ask, now ready to go on.", "items": { "description": "One job id now ready.", "type": "string" }, "type": "array" } }, "required": [ "answered", "ready" ], "type": "object" } }, { "description": "Sends one real application to one job on the employer's site, only after the user said yes to this job in the conversation, and uses one application from the account's allowance. Requires the confirmation_token preview_application returned for this job. A job already applied to, or sent with an uncertain outcome, is never sent again. A posting held on an employer account that is connected now is woken and reported as applying (status queued, no hold, poll suggested) instead of returning the old hold.", "inputSchema": { "additionalProperties": false, "properties": { "confirmation_token": { "description": "From preview_application for this job.", "type": "string" }, "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" } }, "required": [ "job_id", "confirmation_token" ], "type": "object" }, "name": "apply_to_job", "outputSchema": { "description": "One application: where it stands, what it waits on and what to do next.", "properties": { "answer_batches": { "description": "The open question batches this application waits on.", "items": { "description": "A batch of open questions the employer's form raised for this application.", "properties": { "id": { "description": "The batch id answer_question takes as batch_id.", "type": "integer" }, "questions": { "description": "The questions this batch asks.", "items": { "description": "One open question of this batch.", "properties": { "kind": { "description": "The answer kind the form expects, e.g. text, choice or file.", "type": [ "string", "null" ] }, "options": { "description": "The options the form offers; empty for an open-text question.", "items": { "description": "One offered option.", "type": "string" }, "type": "array" }, "prompt": { "description": "The employer's question, in words.", "type": "string" }, "required": { "description": "Whether the form requires an answer.", "type": "boolean" } }, "required": [ "prompt" ], "type": "object" }, "type": "array" }, "revision": { "description": "The batch revision these questions belong to.", "type": "integer" } }, "required": [ "id", "questions" ], "type": "object" }, "type": "array" }, "answers": { "description": "The answers this application sends.", "items": { "description": "One answer this application sends.", "properties": { "answer": { "description": "The answer the application sends, as the user gave it.", "type": "string" }, "question": { "description": "The employer's question as it was asked.", "type": "string" }, "source": { "description": "Where the answer came from, such as the profile field it was taken from.", "type": [ "string", "null" ] } }, "required": [ "question", "answer" ], "type": "object" }, "type": "array" }, "apply_url": { "description": "The employer's posting URL.", "type": "string" }, "company": { "description": "The employer's name, when the ledger has it.", "type": [ "string", "null" ] }, "hold": { "description": "What the employer waits on before this application can go on, when it waits on something ApplySent recognizes.", "properties": { "kind": { "description": "The kind of hold, e.g. account_required or account_creation_required.", "type": [ "string", "null" ] }, "message": { "description": "The hold in words, for the user.", "type": [ "string", "null" ] } }, "required": [ "kind", "message" ], "type": [ "object", "null" ] }, "id": { "description": "The job id of this application.", "type": "string" }, "missing_prerequisites": { "description": "What still stops this application from being sent, in words.", "items": { "description": "One thing still missing.", "type": "string" }, "type": "array" }, "not_sent_reason": { "description": "Why a failed application was not sent, when ApplySent refused it.", "type": [ "string", "null" ] }, "poll_after_seconds": { "description": "Seconds to wait before reading this application again; null when nothing will change by itself.", "type": [ "integer", "null" ] }, "receipt": { "description": "The employer's confirmation of this application, or null when none was recorded.", "properties": { "evidence": { "description": "The evidence the confirmation rests on.", "type": "string" }, "job_ref": { "description": "The reference the employer's system gave the submission.", "type": [ "string", "null" ] }, "kind": { "description": "What the confirmation is, e.g. a submission page or an employer email.", "type": "string" }, "observed_at": { "description": "When the confirmation was observed, ISO 8601.", "type": "string" }, "packet_revision": { "description": "The packet revision that was sent.", "type": [ "integer", "null" ] }, "provider": { "description": "The hiring system that confirmed the submission.", "type": "string" } }, "required": [ "provider", "kind", "evidence", "observed_at" ], "type": [ "object", "null" ] }, "recorded_at": { "description": "When the user started this application, ISO 8601.", "type": [ "string", "null" ] }, "retry_at": { "description": "When ApplySent retries a blocked application, ISO 8601.", "type": [ "string", "null" ] }, "review": { "description": "How far the review of this application has come.", "properties": { "answers_filled": { "description": "How many answers the application holds.", "type": "integer" }, "details_needed": { "description": "The employer questions still waiting on the user.", "items": { "description": "One question waiting on the user.", "type": "string" }, "type": "array" }, "line": { "description": "The same in one sentence, for the user.", "type": "string" } }, "required": [ "answers_filled", "details_needed", "line" ], "type": "object" }, "review_reasons": { "description": "Why the application waits for the user's review.", "items": { "description": "One reason the application waits for the user.", "type": "string" }, "type": "array" }, "stage": { "description": "The hiring stage the employer's messages established (applied, interview, offer, rejected), when known.", "type": [ "string", "null" ] }, "status": { "description": "The application's ledger status, e.g. queued, submitted, uncertain or failed.", "type": "string" }, "step": { "description": "Where the application stands in ApplySent's pipeline, e.g. preparing_application, needs_answer or sent.", "type": "string" }, "suggested_next_tool": { "description": "The tool that answers what this application needs next.", "type": "string" }, "title": { "description": "The posting's title, when the ledger has it.", "type": [ "string", "null" ] }, "uncertain": { "description": "True when the send went out without a confirmed receipt; ApplySent never sends such a job again.", "type": "boolean" }, "waiting": { "description": "Set while the background worker is on this application right now.", "type": [ "string", "null" ] } }, "required": [ "id", "status", "step", "uncertain", "suggested_next_tool" ], "type": "object" } }, { "description": "Marks the previewed tailored résumé (by its resume_sha256) as the one to send with this job's application. Sends nothing.", "inputSchema": { "additionalProperties": false, "properties": { "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" }, "resume_sha256": { "description": "resume_sha256 from preview_tailored_resume.", "type": "string" } }, "required": [ "job_id", "resume_sha256" ], "type": "object" }, "name": "approve_tailored_resume", "outputSchema": { "properties": { "approved": { "description": "True once the résumé is the one to send.", "type": "boolean" }, "job_id": { "description": "The job the résumé is approved for.", "type": "string" }, "resume_sha256": { "description": "The approved résumé's hash.", "type": "string" } }, "required": [ "job_id", "resume_sha256", "approved" ], "type": "object" } }, { "description": "Stops an application whose send has not started; it can then never be sent and its open questions are withdrawn. Refused once sending started.", "inputSchema": { "additionalProperties": false, "properties": { "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" } }, "required": [ "job_id" ], "type": "object" }, "name": "cancel_application", "outputSchema": { "description": "One application: where it stands, what it waits on and what to do next.", "properties": { "answer_batches": { "description": "The open question batches this application waits on.", "items": { "description": "A batch of open questions the employer's form raised for this application.", "properties": { "id": { "description": "The batch id answer_question takes as batch_id.", "type": "integer" }, "questions": { "description": "The questions this batch asks.", "items": { "description": "One open question of this batch.", "properties": { "kind": { "description": "The answer kind the form expects, e.g. text, choice or file.", "type": [ "string", "null" ] }, "options": { "description": "The options the form offers; empty for an open-text question.", "items": { "description": "One offered option.", "type": "string" }, "type": "array" }, "prompt": { "description": "The employer's question, in words.", "type": "string" }, "required": { "description": "Whether the form requires an answer.", "type": "boolean" } }, "required": [ "prompt" ], "type": "object" }, "type": "array" }, "revision": { "description": "The batch revision these questions belong to.", "type": "integer" } }, "required": [ "id", "questions" ], "type": "object" }, "type": "array" }, "answers": { "description": "The answers this application sends.", "items": { "description": "One answer this application sends.", "properties": { "answer": { "description": "The answer the application sends, as the user gave it.", "type": "string" }, "question": { "description": "The employer's question as it was asked.", "type": "string" }, "source": { "description": "Where the answer came from, such as the profile field it was taken from.", "type": [ "string", "null" ] } }, "required": [ "question", "answer" ], "type": "object" }, "type": "array" }, "apply_url": { "description": "The employer's posting URL.", "type": "string" }, "company": { "description": "The employer's name, when the ledger has it.", "type": [ "string", "null" ] }, "hold": { "description": "What the employer waits on before this application can go on, when it waits on something ApplySent recognizes.", "properties": { "kind": { "description": "The kind of hold, e.g. account_required or account_creation_required.", "type": [ "string", "null" ] }, "message": { "description": "The hold in words, for the user.", "type": [ "string", "null" ] } }, "required": [ "kind", "message" ], "type": [ "object", "null" ] }, "id": { "description": "The job id of this application.", "type": "string" }, "missing_prerequisites": { "description": "What still stops this application from being sent, in words.", "items": { "description": "One thing still missing.", "type": "string" }, "type": "array" }, "not_sent_reason": { "description": "Why a failed application was not sent, when ApplySent refused it.", "type": [ "string", "null" ] }, "poll_after_seconds": { "description": "Seconds to wait before reading this application again; null when nothing will change by itself.", "type": [ "integer", "null" ] }, "receipt": { "description": "The employer's confirmation of this application, or null when none was recorded.", "properties": { "evidence": { "description": "The evidence the confirmation rests on.", "type": "string" }, "job_ref": { "description": "The reference the employer's system gave the submission.", "type": [ "string", "null" ] }, "kind": { "description": "What the confirmation is, e.g. a submission page or an employer email.", "type": "string" }, "observed_at": { "description": "When the confirmation was observed, ISO 8601.", "type": "string" }, "packet_revision": { "description": "The packet revision that was sent.", "type": [ "integer", "null" ] }, "provider": { "description": "The hiring system that confirmed the submission.", "type": "string" } }, "required": [ "provider", "kind", "evidence", "observed_at" ], "type": [ "object", "null" ] }, "recorded_at": { "description": "When the user started this application, ISO 8601.", "type": [ "string", "null" ] }, "retry_at": { "description": "When ApplySent retries a blocked application, ISO 8601.", "type": [ "string", "null" ] }, "review": { "description": "How far the review of this application has come.", "properties": { "answers_filled": { "description": "How many answers the application holds.", "type": "integer" }, "details_needed": { "description": "The employer questions still waiting on the user.", "items": { "description": "One question waiting on the user.", "type": "string" }, "type": "array" }, "line": { "description": "The same in one sentence, for the user.", "type": "string" } }, "required": [ "answers_filled", "details_needed", "line" ], "type": "object" }, "review_reasons": { "description": "Why the application waits for the user's review.", "items": { "description": "One reason the application waits for the user.", "type": "string" }, "type": "array" }, "stage": { "description": "The hiring stage the employer's messages established (applied, interview, offer, rejected), when known.", "type": [ "string", "null" ] }, "status": { "description": "The application's ledger status, e.g. queued, submitted, uncertain or failed.", "type": "string" }, "step": { "description": "Where the application stands in ApplySent's pipeline, e.g. preparing_application, needs_answer or sent.", "type": "string" }, "suggested_next_tool": { "description": "The tool that answers what this application needs next.", "type": "string" }, "title": { "description": "The posting's title, when the ledger has it.", "type": [ "string", "null" ] }, "uncertain": { "description": "True when the send went out without a confirmed receipt; ApplySent never sends such a job again.", "type": "boolean" }, "waiting": { "description": "Set while the background worker is on this application right now.", "type": [ "string", "null" ] } }, "required": [ "id", "status", "step", "uncertain", "suggested_next_tool" ], "type": "object" } }, { "description": "The full text of one job from search, with its posting URL and match details, for citing it. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "A job id from a search result.", "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "fetch", "outputSchema": { "properties": { "id": { "description": "The job id.", "type": "string" }, "metadata": { "description": "The posting's facts beside its text.", "properties": { "application_status": { "description": "The application's ledger status when the user applied, else null.", "type": [ "string", "null" ] }, "city": { "description": "City the posting is in.", "type": [ "string", "null" ] }, "company": { "description": "The employer's name.", "type": "string" }, "country": { "description": "Country the posting is in.", "type": [ "string", "null" ] }, "match_score": { "description": "The match score against the user, from 0 to 100.", "type": "integer" }, "posted_at": { "description": "When the posting went up, ISO 8601 in UTC.", "type": [ "string", "null" ] }, "salary": { "description": "The pay the posting states, or null when it states none.", "properties": { "currency": { "description": "ISO code of the stated pay.", "type": "string" }, "max": { "description": "Highest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "min": { "description": "Lowest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "period": { "description": "What the amounts are for (year, month, week, day or hour) when the posting states a period ApplySent recognizes.", "type": [ "string", "null" ] } }, "required": [ "min", "max", "currency", "period" ], "type": [ "object", "null" ] } }, "required": [ "company", "match_score" ], "type": "object" }, "text": { "description": "The posting's full text.", "type": "string" }, "title": { "description": "The posting's title and employer in one line.", "type": "string" }, "url": { "description": "The employer's posting URL, for citing it.", "type": "string" } }, "required": [ "id", "title", "text", "url" ], "type": "object" } }, { "description": "How many applications the account has left and has sent today (or unlimited), and anything stopping applications from being sent. Reads only.", "inputSchema": { "additionalProperties": false, "properties": {}, "required": [], "type": "object" }, "name": "get_account", "outputSchema": { "properties": { "applications": { "description": "The allowance the sender counts against.", "properties": { "daily_limit": { "description": "Today's cap; null when unlimited.", "type": [ "integer", "null" ] }, "daily_remaining": { "description": "Applications left today; null when unlimited.", "type": [ "integer", "null" ] }, "extra": { "description": "Applications left from one-time extras.", "type": [ "integer", "null" ] }, "limit": { "description": "This week's allowance; null when unlimited.", "type": [ "integer", "null" ] }, "month_limit": { "description": "This month's allowance; null when unlimited.", "type": [ "integer", "null" ] }, "month_remaining": { "description": "Applications left this month; null when unlimited.", "type": [ "integer", "null" ] }, "remaining": { "description": "Applications left this week; null when unlimited.", "type": [ "integer", "null" ] }, "resets_at": { "description": "When the week's allowance resets, ISO 8601; null when unlimited.", "type": [ "string", "null" ] }, "sent_today": { "description": "Applications sent today.", "type": "integer" }, "unlimited": { "description": "True for an account with no weekly, daily or monthly cap.", "type": "boolean" }, "used": { "description": "Applications used this week.", "type": "integer" } }, "required": [ "unlimited", "used", "sent_today" ], "type": "object" }, "send_blockers": { "description": "Everything that stops applications from being sent now, in words.", "items": { "description": "One thing stopping sends.", "type": "string" }, "type": "array" } }, "required": [ "applications", "send_blockers" ], "type": "object" } }, { "description": "One application: status and step (blocked with its reason and retry_at while ApplySent waits to retry), receipt, the answers sent, any open questions, suggested_next_tool and poll_after_seconds. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" } }, "required": [ "job_id" ], "type": "object" }, "name": "get_application", "outputSchema": { "description": "One application: where it stands, what it waits on and what to do next.", "properties": { "answer_batches": { "description": "The open question batches this application waits on.", "items": { "description": "A batch of open questions the employer's form raised for this application.", "properties": { "id": { "description": "The batch id answer_question takes as batch_id.", "type": "integer" }, "questions": { "description": "The questions this batch asks.", "items": { "description": "One open question of this batch.", "properties": { "kind": { "description": "The answer kind the form expects, e.g. text, choice or file.", "type": [ "string", "null" ] }, "options": { "description": "The options the form offers; empty for an open-text question.", "items": { "description": "One offered option.", "type": "string" }, "type": "array" }, "prompt": { "description": "The employer's question, in words.", "type": "string" }, "required": { "description": "Whether the form requires an answer.", "type": "boolean" } }, "required": [ "prompt" ], "type": "object" }, "type": "array" }, "revision": { "description": "The batch revision these questions belong to.", "type": "integer" } }, "required": [ "id", "questions" ], "type": "object" }, "type": "array" }, "answers": { "description": "The answers this application sends.", "items": { "description": "One answer this application sends.", "properties": { "answer": { "description": "The answer the application sends, as the user gave it.", "type": "string" }, "question": { "description": "The employer's question as it was asked.", "type": "string" }, "source": { "description": "Where the answer came from, such as the profile field it was taken from.", "type": [ "string", "null" ] } }, "required": [ "question", "answer" ], "type": "object" }, "type": "array" }, "apply_url": { "description": "The employer's posting URL.", "type": "string" }, "company": { "description": "The employer's name, when the ledger has it.", "type": [ "string", "null" ] }, "hold": { "description": "What the employer waits on before this application can go on, when it waits on something ApplySent recognizes.", "properties": { "kind": { "description": "The kind of hold, e.g. account_required or account_creation_required.", "type": [ "string", "null" ] }, "message": { "description": "The hold in words, for the user.", "type": [ "string", "null" ] } }, "required": [ "kind", "message" ], "type": [ "object", "null" ] }, "id": { "description": "The job id of this application.", "type": "string" }, "missing_prerequisites": { "description": "What still stops this application from being sent, in words.", "items": { "description": "One thing still missing.", "type": "string" }, "type": "array" }, "not_sent_reason": { "description": "Why a failed application was not sent, when ApplySent refused it.", "type": [ "string", "null" ] }, "poll_after_seconds": { "description": "Seconds to wait before reading this application again; null when nothing will change by itself.", "type": [ "integer", "null" ] }, "receipt": { "description": "The employer's confirmation of this application, or null when none was recorded.", "properties": { "evidence": { "description": "The evidence the confirmation rests on.", "type": "string" }, "job_ref": { "description": "The reference the employer's system gave the submission.", "type": [ "string", "null" ] }, "kind": { "description": "What the confirmation is, e.g. a submission page or an employer email.", "type": "string" }, "observed_at": { "description": "When the confirmation was observed, ISO 8601.", "type": "string" }, "packet_revision": { "description": "The packet revision that was sent.", "type": [ "integer", "null" ] }, "provider": { "description": "The hiring system that confirmed the submission.", "type": "string" } }, "required": [ "provider", "kind", "evidence", "observed_at" ], "type": [ "object", "null" ] }, "recorded_at": { "description": "When the user started this application, ISO 8601.", "type": [ "string", "null" ] }, "retry_at": { "description": "When ApplySent retries a blocked application, ISO 8601.", "type": [ "string", "null" ] }, "review": { "description": "How far the review of this application has come.", "properties": { "answers_filled": { "description": "How many answers the application holds.", "type": "integer" }, "details_needed": { "description": "The employer questions still waiting on the user.", "items": { "description": "One question waiting on the user.", "type": "string" }, "type": "array" }, "line": { "description": "The same in one sentence, for the user.", "type": "string" } }, "required": [ "answers_filled", "details_needed", "line" ], "type": "object" }, "review_reasons": { "description": "Why the application waits for the user's review.", "items": { "description": "One reason the application waits for the user.", "type": "string" }, "type": "array" }, "stage": { "description": "The hiring stage the employer's messages established (applied, interview, offer, rejected), when known.", "type": [ "string", "null" ] }, "status": { "description": "The application's ledger status, e.g. queued, submitted, uncertain or failed.", "type": "string" }, "step": { "description": "Where the application stands in ApplySent's pipeline, e.g. preparing_application, needs_answer or sent.", "type": "string" }, "suggested_next_tool": { "description": "The tool that answers what this application needs next.", "type": "string" }, "title": { "description": "The posting's title, when the ledger has it.", "type": [ "string", "null" ] }, "uncertain": { "description": "True when the send went out without a confirmed receipt; ApplySent never sends such a job again.", "type": "boolean" }, "waiting": { "description": "Set while the background worker is on this application right now.", "type": [ "string", "null" ] } }, "required": [ "id", "status", "step", "uncertain", "suggested_next_tool" ], "type": "object" } }, { "description": "The Applications board under its filters: how many applications stand in each bucket, how many are being worked on now, and light rows of one bucket's page or of the first rows of every bucket, work running now first. Paging with offset needs bucket. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "before": { "description": "Only applications recorded before this ISO date.", "type": "string" }, "bucket": { "description": "One bucket to page through; leave it out for the first rows of every bucket.", "enum": [ "in_progress", "needs_you", "applied", "interview", "offer", "rejected", "not_sent" ], "type": "string" }, "company": { "description": "Only applications at this employer, matched without case.", "type": "string" }, "limit": { "default": 20, "description": "Rows per bucket.", "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Rows to skip for the next page: the previous page's coverage names the offset to pass.", "minimum": 0, "type": "integer" }, "q": { "description": "Words to match in the job title or employer.", "type": "string" }, "since": { "description": "Only applications recorded on or after this ISO date.", "type": "string" } }, "required": [], "type": "object" }, "name": "get_application_board", "outputSchema": { "properties": { "bucket": { "description": "The column paged through, or null when every column's first rows came back.", "type": [ "string", "null" ] }, "counts": { "additionalProperties": { "description": "Applications in this column.", "type": "integer" }, "description": "How many applications stand in each board column, under the filters.", "type": "object" }, "coverage": { "description": "What this page covers, so the assistant can say honestly what it read.", "properties": { "complete": { "description": "True when this page holds every matching row and no earlier page was skipped.", "type": "boolean" }, "empty_reason": { "description": "Why nothing came back, when the page is empty; null when it holds rows.", "type": [ "string", "null" ] }, "gaps": { "description": "What this result does not hold, one entry per gap.", "items": { "description": "One kind of row this result does not hold.", "properties": { "kind": { "description": "Why the row is missing: \"page\" for later rows, \"earlier_pages\" for rows before this page, \"filtered\" for rows a filter left out.", "type": "string" }, "what": { "description": "The gap in words: the offset to ask for next, or what was filtered out.", "type": "string" } }, "required": [ "kind", "what" ], "type": "object" }, "type": "array" }, "line": { "description": "One sentence saying what this page holds, what was left out and what was not read; show it to the user as it is.", "type": "string" }, "total": { "description": "How many rows the filters match in all, when that is known.", "type": [ "integer", "null" ] } }, "required": [ "line", "complete", "gaps" ], "type": "object" }, "filters": { "description": "The filters this page was read under.", "properties": { "before": { "description": "The ISO date applications were recorded before.", "type": [ "string", "null" ] }, "company": { "description": "The employer filtered on.", "type": [ "string", "null" ] }, "q": { "description": "The words matched in the job title or employer.", "type": [ "string", "null" ] }, "since": { "description": "The ISO date applications were recorded on or after.", "type": [ "string", "null" ] } }, "required": [ "q", "company", "since", "before" ], "type": "object" }, "offset": { "description": "The offset this page starts at.", "type": "integer" }, "rows": { "description": "The light rows of one column's page, or the first rows of every column.", "items": { "description": "One light application row of the board.", "properties": { "ats": { "description": "The employer's hiring system.", "type": "string" }, "awaiting_fix": { "description": "True while ApplySent is fixing a problem on its side before retrying.", "type": "boolean" }, "brand_color": { "description": "The employer's brand colour, when one is known.", "type": [ "string", "null" ] }, "bucket": { "description": "The board column this application stands in.", "type": "string" }, "company": { "description": "The employer's name.", "type": "string" }, "company_domain": { "description": "The employer's domain, when the catalogue resolved one.", "type": [ "string", "null" ] }, "company_domain_source": { "description": "How that domain was resolved.", "type": [ "string", "null" ] }, "job_id": { "description": "The job id of this application.", "type": "string" }, "link": { "description": "The employer's posting URL.", "type": "string" }, "location": { "description": "Where the posting is.", "properties": { "city": { "description": "City the posting is in.", "type": [ "string", "null" ] }, "country": { "description": "Country the posting is in.", "type": [ "string", "null" ] }, "remote": { "description": "Whether the posting is remote, when the catalogue established it.", "type": [ "boolean", "null" ] } }, "required": [ "city", "country", "remote" ], "type": "object" }, "logo_url": { "description": "The employer's logo URL, when one is known.", "type": [ "string", "null" ] }, "questions": { "description": "How many employer questions wait on the user for this application.", "type": "integer" }, "reason_code": { "description": "A stable code for why the application stands where it does.", "type": [ "string", "null" ] }, "retryable": { "description": "True when the user may send this application again.", "type": "boolean" }, "stage": { "description": "The hiring stage the employer's messages established, when known.", "type": [ "string", "null" ] }, "stage_at": { "description": "When the current stage was reached, ISO 8601.", "type": [ "string", "null" ] }, "status": { "description": "The application's ledger status.", "type": [ "string", "null" ] }, "step": { "description": "What an application in progress is doing or waiting for; null for a column that reports no step.", "properties": { "board_hold": { "description": "True when the employer is holding this board until a time.", "type": "boolean" }, "label": { "description": "What the application is doing or waiting for, in words.", "type": "string" }, "live": { "description": "True while work on this application is running now.", "type": "boolean" }, "retry_at": { "description": "When ApplySent tries again, ISO 8601.", "type": [ "string", "null" ] }, "since": { "description": "When that step started, ISO 8601.", "type": [ "string", "null" ] } }, "required": [ "label", "live", "since", "retry_at" ], "type": [ "object", "null" ] }, "title": { "description": "The posting's title.", "type": "string" }, "uncertain": { "description": "True when the send went out without a confirmed receipt.", "type": "boolean" }, "updated_at": { "description": "When the application last changed, ISO 8601.", "type": [ "string", "null" ] } }, "required": [ "job_id", "title", "company", "link", "bucket", "uncertain" ], "type": "object" }, "type": "array" }, "working": { "description": "How many applications are being worked on right now.", "type": "integer" } }, "required": [ "counts", "working", "rows", "bucket", "offset", "filters", "coverage" ], "type": "object" } }, { "description": "The employer's confirmation evidence for one application: the receipt, the answers sent, the proof files and the confirmation screenshot as an image when one was captured. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" } }, "required": [ "job_id" ], "type": "object" }, "name": "get_application_receipt", "outputSchema": { "properties": { "answers_sent": { "description": "The answers this application sends.", "items": { "description": "One answer this application sends.", "properties": { "answer": { "description": "The answer the application sends, as the user gave it.", "type": "string" }, "question": { "description": "The employer's question as it was asked.", "type": "string" }, "source": { "description": "Where the answer came from, such as the profile field it was taken from.", "type": [ "string", "null" ] } }, "required": [ "question", "answer" ], "type": "object" }, "type": "array" }, "company": { "description": "The employer's name.", "type": "string" }, "job_id": { "description": "The job id of this application.", "type": "string" }, "proof": { "description": "The proof files the send left behind.", "items": { "description": "One proof file the send left behind.", "properties": { "media_type": { "description": "The proof file's media type.", "type": "string" }, "name": { "description": "The proof file's name.", "type": "string" }, "observed_at": { "description": "When the proof was captured, ISO 8601.", "type": "string" }, "size": { "description": "The proof file's size in bytes.", "type": "integer" }, "url": { "description": "Where the user can download the proof.", "type": "string" } }, "required": [ "name", "media_type", "size", "observed_at", "url" ], "type": "object" }, "type": "array" }, "receipt": { "description": "The employer's confirmation of this application, or null when none was recorded.", "properties": { "evidence": { "description": "The evidence the confirmation rests on.", "type": "string" }, "job_ref": { "description": "The reference the employer's system gave the submission.", "type": [ "string", "null" ] }, "kind": { "description": "What the confirmation is, e.g. a submission page or an employer email.", "type": "string" }, "observed_at": { "description": "When the confirmation was observed, ISO 8601.", "type": "string" }, "packet_revision": { "description": "The packet revision that was sent.", "type": [ "integer", "null" ] }, "provider": { "description": "The hiring system that confirmed the submission.", "type": "string" } }, "required": [ "provider", "kind", "evidence", "observed_at" ], "type": [ "object", "null" ] }, "screenshot": { "description": "The name of the proof image also returned as an image part, when one was captured.", "type": "string" }, "status": { "description": "The application's ledger status.", "type": "string" }, "title": { "description": "The posting's title.", "type": "string" }, "uncertain": { "description": "True when the send went out without a confirmed receipt.", "type": "boolean" } }, "required": [ "job_id", "status", "uncertain", "receipt", "proof", "answers_sent" ], "type": "object" } }, { "description": "Everything needed to review one application before it is sent: the packet revision and its approval, the documents (name, format, size, hash) and form answers it would send, open employer questions, every blocker in words, field errors and the public timeline. Use it when the user wants to check or fix an application that waits for review; use get_application for status alone and get_application_receipt for proof after sending. Pass job_id. Reads only: approving, answering and sending are done by answer_question, preview_application and apply_to_job.", "inputSchema": { "additionalProperties": false, "properties": { "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" } }, "required": [ "job_id" ], "type": "object" }, "name": "get_application_review", "outputSchema": { "properties": { "answers": { "description": "The answers this application sends.", "items": { "description": "One answer this application sends.", "properties": { "answer": { "description": "The answer the application sends, as the user gave it.", "type": "string" }, "question": { "description": "The employer's question as it was asked.", "type": "string" }, "source": { "description": "Where the answer came from, such as the profile field it was taken from.", "type": [ "string", "null" ] } }, "required": [ "question", "answer" ], "type": "object" }, "type": "array" }, "blockers": { "description": "Everything that stops this application from being sent, in words.", "items": { "description": "One thing stopping the send.", "type": "string" }, "type": "array" }, "company": { "description": "The employer's name.", "type": "string" }, "digest": { "description": "The current packet's hash, when one exists.", "type": [ "string", "null" ] }, "events": { "description": "The public timeline steps, oldest first.", "items": { "description": "One public step of the application's timeline.", "properties": { "event": { "description": "The step, e.g. recorded, prepared or submitted.", "type": "string" }, "occurred_at": { "description": "When the step happened, ISO 8601.", "type": "string" }, "status": { "description": "The status the step left the application in.", "type": [ "string", "null" ] } }, "required": [ "occurred_at", "event" ], "type": "object" }, "type": "array" }, "field_errors": { "additionalProperties": { "description": "What is wrong with this form field.", "type": "string" }, "description": "Form fields whose answers the review rejected, by field name.", "type": "object" }, "job_id": { "description": "The job id of this application.", "type": "string" }, "packet": { "description": "The packet the application would send, or null when none was built.", "properties": { "approved": { "description": "Whether the packet is approved to send.", "type": "boolean" }, "approved_at": { "description": "When the packet was approved, ISO 8601.", "type": [ "string", "null" ] }, "created_at": { "description": "When the packet was built, ISO 8601.", "type": "string" }, "current": { "description": "Whether this is the application's current packet revision.", "type": "boolean" }, "digest": { "description": "The packet's hash.", "type": "string" }, "documents": { "description": "The documents the packet would send.", "items": { "description": "One document the packet would send.", "properties": { "format": { "description": "The document's format, from its file name.", "type": "string" }, "name": { "description": "The document's file name.", "type": "string" }, "sha256": { "description": "The document's hash.", "type": "string" }, "size": { "description": "The document's size in bytes.", "type": "integer" } }, "required": [ "name", "format", "sha256", "size" ], "type": "object" }, "type": "array" }, "revision": { "description": "The packet revision.", "type": "integer" } }, "required": [ "revision", "digest", "approved", "current", "documents" ], "type": [ "object", "null" ] }, "questions": { "description": "The open question batches this application waits on.", "items": { "description": "A batch of open questions the employer's form raised for this application.", "properties": { "id": { "description": "The batch id answer_question takes as batch_id.", "type": "integer" }, "questions": { "description": "The questions this batch asks.", "items": { "description": "One open question of this batch.", "properties": { "kind": { "description": "The answer kind the form expects, e.g. text, choice or file.", "type": [ "string", "null" ] }, "options": { "description": "The options the form offers; empty for an open-text question.", "items": { "description": "One offered option.", "type": "string" }, "type": "array" }, "prompt": { "description": "The employer's question, in words.", "type": "string" }, "required": { "description": "Whether the form requires an answer.", "type": "boolean" } }, "required": [ "prompt" ], "type": "object" }, "type": "array" }, "revision": { "description": "The batch revision these questions belong to.", "type": "integer" } }, "required": [ "id", "questions" ], "type": "object" }, "type": "array" }, "review_available": { "description": "True when the application has a packet the user may review.", "type": "boolean" }, "review_reasons": { "description": "Why the application waits for the user's review.", "items": { "description": "One reason the application waits for the user.", "type": "string" }, "type": "array" }, "revision": { "description": "The current packet revision, when one exists.", "type": [ "integer", "null" ] }, "stage": { "description": "The hiring stage the employer's messages established, when known.", "type": [ "string", "null" ] }, "status": { "description": "The application's ledger status.", "type": "string" }, "step": { "description": "Where the application stands in ApplySent's pipeline.", "type": [ "string", "null" ] }, "title": { "description": "The posting's title.", "type": "string" }, "uncertain": { "description": "True when the send went out without a confirmed receipt.", "type": "boolean" } }, "required": [ "job_id", "status", "uncertain", "review_available", "packet", "answers", "questions", "blockers" ], "type": "object" } }, { "description": "The full posting, the match assessment against the user, and any application status. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" } }, "required": [ "job_id" ], "type": "object" }, "name": "get_job", "outputSchema": { "description": "One posting: its facts, its match assessment and its text.", "properties": { "application_status": { "description": "The application's ledger status when the user applied to this job, else null.", "type": [ "string", "null" ] }, "apply_supported": { "description": "Whether ApplySent can fill and submit this posting's form by itself.", "type": "boolean" }, "apply_url": { "description": "The employer's posting URL, where the application is filled.", "type": "string" }, "city": { "description": "City the posting is in.", "type": [ "string", "null" ] }, "company": { "description": "The employer's name.", "type": "string" }, "country": { "description": "Country the posting is in, as the catalogue recorded it.", "type": [ "string", "null" ] }, "description": { "description": "The posting's text with whitespace collapsed, cut to the tool's length.", "type": "string" }, "description_truncated": { "description": "True when the posting's text was cut.", "type": "boolean" }, "facts": { "description": "Facts the catalogue derived from the posting; a key is absent when the catalogue established nothing for it.", "properties": { "department": { "description": "Department the posting names.", "type": [ "string", "null" ] }, "employment_type": { "description": "Employment type the posting states, e.g. full_time or contract.", "type": [ "string", "null" ] }, "form_fields": { "description": "How many fields the employer's form has, when it was read.", "type": "integer" }, "industry": { "description": "Industry the catalogue derived from the title and department.", "type": [ "string", "null" ] }, "nationals_only": { "description": "1 when the posting is open only to a country's nationals.", "type": "integer" }, "salary_currency": { "description": "ISO code of the stated pay.", "type": [ "string", "null" ] }, "salary_max": { "description": "Highest stated pay, in the currency's units.", "type": [ "number", "null" ] }, "salary_min": { "description": "Lowest stated pay, in the currency's units.", "type": [ "number", "null" ] }, "salary_period": { "description": "What the stated pay is for: year, month, week, day or hour.", "type": [ "string", "null" ] }, "seniority": { "description": "Seniority the posting states or its title and text imply.", "type": [ "string", "null" ] }, "skills": { "description": "The skills the posting names, as a JSON array inside a string, when it names any.", "type": [ "string", "null" ] }, "tailored_keywords": { "description": "Keywords the tailored résumé added, when one was made.", "items": { "description": "One keyword the tailored résumé added.", "type": "string" }, "type": "array" }, "visa_sponsorship": { "description": "1 when the posting offers visa sponsorship, 0 when it refuses it.", "type": [ "integer", "null" ] }, "work_permit": { "description": "What the posting's country means for the user's work authorization, in words.", "type": "string" }, "workplace": { "description": "Where the work is done: remote, hybrid or onsite.", "type": [ "string", "null" ] } }, "required": [], "type": "object" }, "id": { "description": "The job id the other job tools take.", "type": "string" }, "match": { "description": "The assessment of this job against the user's résumé, targets and eligibility.", "properties": { "breakdown": { "additionalProperties": { "description": "Points this factor added to the score.", "type": "integer" }, "description": "Points each match factor added; a full job read carries them, a list row does not.", "type": "object" }, "eligible": { "description": "Whether the user may take this job: work authorization, language and the posting's stated requirements all pass.", "type": "boolean" }, "missing": { "description": "What the assessment could not establish about the user for this posting; a full job read carries it, a list row does not.", "items": { "description": "One fact the assessment could not establish about the user.", "type": "string" }, "type": "array" }, "notes": { "description": "Notes the assessment kept beside the score; a full job read carries them, a list row does not.", "items": { "description": "One note the assessment kept beside the score.", "type": "string" }, "type": "array" }, "reasons": { "description": "Why the job scores what it does, in words.", "items": { "description": "One reason the job scored as it did.", "type": "string" }, "type": "array" }, "score": { "description": "Match score from 0 to 100 against the user's résumé and targets; higher is better.", "type": "integer" } }, "required": [ "eligible", "score", "reasons" ], "type": "object" }, "posted_at": { "description": "When the posting went up, ISO 8601 in UTC, when the catalogue knows it.", "type": [ "string", "null" ] }, "provider": { "description": "The employer's hiring system the posting came from, e.g. workday, greenhouse or ashby.", "type": "string" }, "salary": { "description": "The pay the posting states, or null when it states none.", "properties": { "currency": { "description": "ISO code of the stated pay.", "type": "string" }, "max": { "description": "Highest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "min": { "description": "Lowest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "period": { "description": "What the amounts are for (year, month, week, day or hour) when the posting states a period ApplySent recognizes.", "type": [ "string", "null" ] } }, "required": [ "min", "max", "currency", "period" ], "type": [ "object", "null" ] }, "saved": { "description": "Whether the user saved this job.", "type": "boolean" }, "title": { "description": "The posting's title as the employer states it.", "type": "string" } }, "required": [ "id", "match", "description" ], "type": "object" } }, { "description": "Reads the posting at an employer or job-board link and returns the full posting text, the match assessment against the user and the job id, keeping it in the user's saved jobs. Fetches the employer's page; applies to nothing.", "inputSchema": { "additionalProperties": false, "properties": { "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "url": { "description": "The posting URL the user shared.", "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "get_job_from_link", "outputSchema": { "description": "One posting: its facts, its match assessment and its text.", "properties": { "application_status": { "description": "The application's ledger status when the user applied to this job, else null.", "type": [ "string", "null" ] }, "apply_supported": { "description": "Whether ApplySent can fill and submit this posting's form by itself.", "type": "boolean" }, "apply_url": { "description": "The employer's posting URL, where the application is filled.", "type": "string" }, "city": { "description": "City the posting is in.", "type": [ "string", "null" ] }, "company": { "description": "The employer's name.", "type": "string" }, "country": { "description": "Country the posting is in, as the catalogue recorded it.", "type": [ "string", "null" ] }, "description": { "description": "The posting's text with whitespace collapsed, cut to the tool's length.", "type": "string" }, "description_truncated": { "description": "True when the posting's text was cut.", "type": "boolean" }, "facts": { "description": "Facts the catalogue derived from the posting; a key is absent when the catalogue established nothing for it.", "properties": { "department": { "description": "Department the posting names.", "type": [ "string", "null" ] }, "employment_type": { "description": "Employment type the posting states, e.g. full_time or contract.", "type": [ "string", "null" ] }, "form_fields": { "description": "How many fields the employer's form has, when it was read.", "type": "integer" }, "industry": { "description": "Industry the catalogue derived from the title and department.", "type": [ "string", "null" ] }, "nationals_only": { "description": "1 when the posting is open only to a country's nationals.", "type": "integer" }, "salary_currency": { "description": "ISO code of the stated pay.", "type": [ "string", "null" ] }, "salary_max": { "description": "Highest stated pay, in the currency's units.", "type": [ "number", "null" ] }, "salary_min": { "description": "Lowest stated pay, in the currency's units.", "type": [ "number", "null" ] }, "salary_period": { "description": "What the stated pay is for: year, month, week, day or hour.", "type": [ "string", "null" ] }, "seniority": { "description": "Seniority the posting states or its title and text imply.", "type": [ "string", "null" ] }, "skills": { "description": "The skills the posting names, as a JSON array inside a string, when it names any.", "type": [ "string", "null" ] }, "tailored_keywords": { "description": "Keywords the tailored résumé added, when one was made.", "items": { "description": "One keyword the tailored résumé added.", "type": "string" }, "type": "array" }, "visa_sponsorship": { "description": "1 when the posting offers visa sponsorship, 0 when it refuses it.", "type": [ "integer", "null" ] }, "work_permit": { "description": "What the posting's country means for the user's work authorization, in words.", "type": "string" }, "workplace": { "description": "Where the work is done: remote, hybrid or onsite.", "type": [ "string", "null" ] } }, "required": [], "type": "object" }, "id": { "description": "The job id the other job tools take.", "type": "string" }, "match": { "description": "The assessment of this job against the user's résumé, targets and eligibility.", "properties": { "breakdown": { "additionalProperties": { "description": "Points this factor added to the score.", "type": "integer" }, "description": "Points each match factor added; a full job read carries them, a list row does not.", "type": "object" }, "eligible": { "description": "Whether the user may take this job: work authorization, language and the posting's stated requirements all pass.", "type": "boolean" }, "missing": { "description": "What the assessment could not establish about the user for this posting; a full job read carries it, a list row does not.", "items": { "description": "One fact the assessment could not establish about the user.", "type": "string" }, "type": "array" }, "notes": { "description": "Notes the assessment kept beside the score; a full job read carries them, a list row does not.", "items": { "description": "One note the assessment kept beside the score.", "type": "string" }, "type": "array" }, "reasons": { "description": "Why the job scores what it does, in words.", "items": { "description": "One reason the job scored as it did.", "type": "string" }, "type": "array" }, "score": { "description": "Match score from 0 to 100 against the user's résumé and targets; higher is better.", "type": "integer" } }, "required": [ "eligible", "score", "reasons" ], "type": "object" }, "posted_at": { "description": "When the posting went up, ISO 8601 in UTC, when the catalogue knows it.", "type": [ "string", "null" ] }, "provider": { "description": "The employer's hiring system the posting came from, e.g. workday, greenhouse or ashby.", "type": "string" }, "salary": { "description": "The pay the posting states, or null when it states none.", "properties": { "currency": { "description": "ISO code of the stated pay.", "type": "string" }, "max": { "description": "Highest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "min": { "description": "Lowest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "period": { "description": "What the amounts are for (year, month, week, day or hour) when the posting states a period ApplySent recognizes.", "type": [ "string", "null" ] } }, "required": [ "min", "max", "currency", "period" ], "type": [ "object", "null" ] }, "saved": { "description": "Whether the user saved this job.", "type": "boolean" }, "title": { "description": "The posting's title as the employer states it.", "type": "string" } }, "required": [ "id", "match", "description" ], "type": "object" } }, { "description": "Up to 20 postings by id with their match assessments, descriptions shortened; ids not found come back in missing. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "job_ids": { "description": "Job ids from search_jobs, get_job_from_link or list_applications; a repeated id is read once.", "items": { "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" } }, "required": [ "job_ids" ], "type": "object" }, "name": "get_jobs", "outputSchema": { "properties": { "coverage": { "description": "What this page covers, so the assistant can say honestly what it read.", "properties": { "complete": { "description": "True when this page holds every matching row and no earlier page was skipped.", "type": "boolean" }, "empty_reason": { "description": "Why nothing came back, when the page is empty; null when it holds rows.", "type": [ "string", "null" ] }, "gaps": { "description": "What this result does not hold, one entry per gap.", "items": { "description": "One kind of row this result does not hold.", "properties": { "kind": { "description": "Why the row is missing: \"page\" for later rows, \"earlier_pages\" for rows before this page, \"filtered\" for rows a filter left out.", "type": "string" }, "what": { "description": "The gap in words: the offset to ask for next, or what was filtered out.", "type": "string" } }, "required": [ "kind", "what" ], "type": "object" }, "type": "array" }, "line": { "description": "One sentence saying what this page holds, what was left out and what was not read; show it to the user as it is.", "type": "string" }, "total": { "description": "How many rows the filters match in all, when that is known.", "type": [ "integer", "null" ] } }, "required": [ "line", "complete", "gaps" ], "type": "object" }, "jobs": { "description": "The requested postings that are in this account, in the order asked.", "items": { "description": "One posting: its facts, its match assessment and its text.", "properties": { "application_status": { "description": "The application's ledger status when the user applied to this job, else null.", "type": [ "string", "null" ] }, "apply_supported": { "description": "Whether ApplySent can fill and submit this posting's form by itself.", "type": "boolean" }, "apply_url": { "description": "The employer's posting URL, where the application is filled.", "type": "string" }, "city": { "description": "City the posting is in.", "type": [ "string", "null" ] }, "company": { "description": "The employer's name.", "type": "string" }, "country": { "description": "Country the posting is in, as the catalogue recorded it.", "type": [ "string", "null" ] }, "description": { "description": "The posting's text with whitespace collapsed, cut to the tool's length.", "type": "string" }, "description_truncated": { "description": "True when the posting's text was cut.", "type": "boolean" }, "facts": { "description": "Facts the catalogue derived from the posting; a key is absent when the catalogue established nothing for it.", "properties": { "department": { "description": "Department the posting names.", "type": [ "string", "null" ] }, "employment_type": { "description": "Employment type the posting states, e.g. full_time or contract.", "type": [ "string", "null" ] }, "form_fields": { "description": "How many fields the employer's form has, when it was read.", "type": "integer" }, "industry": { "description": "Industry the catalogue derived from the title and department.", "type": [ "string", "null" ] }, "nationals_only": { "description": "1 when the posting is open only to a country's nationals.", "type": "integer" }, "salary_currency": { "description": "ISO code of the stated pay.", "type": [ "string", "null" ] }, "salary_max": { "description": "Highest stated pay, in the currency's units.", "type": [ "number", "null" ] }, "salary_min": { "description": "Lowest stated pay, in the currency's units.", "type": [ "number", "null" ] }, "salary_period": { "description": "What the stated pay is for: year, month, week, day or hour.", "type": [ "string", "null" ] }, "seniority": { "description": "Seniority the posting states or its title and text imply.", "type": [ "string", "null" ] }, "skills": { "description": "The skills the posting names, as a JSON array inside a string, when it names any.", "type": [ "string", "null" ] }, "tailored_keywords": { "description": "Keywords the tailored résumé added, when one was made.", "items": { "description": "One keyword the tailored résumé added.", "type": "string" }, "type": "array" }, "visa_sponsorship": { "description": "1 when the posting offers visa sponsorship, 0 when it refuses it.", "type": [ "integer", "null" ] }, "work_permit": { "description": "What the posting's country means for the user's work authorization, in words.", "type": "string" }, "workplace": { "description": "Where the work is done: remote, hybrid or onsite.", "type": [ "string", "null" ] } }, "required": [], "type": "object" }, "id": { "description": "The job id the other job tools take.", "type": "string" }, "match": { "description": "The assessment of this job against the user's résumé, targets and eligibility.", "properties": { "breakdown": { "additionalProperties": { "description": "Points this factor added to the score.", "type": "integer" }, "description": "Points each match factor added; a full job read carries them, a list row does not.", "type": "object" }, "eligible": { "description": "Whether the user may take this job: work authorization, language and the posting's stated requirements all pass.", "type": "boolean" }, "missing": { "description": "What the assessment could not establish about the user for this posting; a full job read carries it, a list row does not.", "items": { "description": "One fact the assessment could not establish about the user.", "type": "string" }, "type": "array" }, "notes": { "description": "Notes the assessment kept beside the score; a full job read carries them, a list row does not.", "items": { "description": "One note the assessment kept beside the score.", "type": "string" }, "type": "array" }, "reasons": { "description": "Why the job scores what it does, in words.", "items": { "description": "One reason the job scored as it did.", "type": "string" }, "type": "array" }, "score": { "description": "Match score from 0 to 100 against the user's résumé and targets; higher is better.", "type": "integer" } }, "required": [ "eligible", "score", "reasons" ], "type": "object" }, "posted_at": { "description": "When the posting went up, ISO 8601 in UTC, when the catalogue knows it.", "type": [ "string", "null" ] }, "provider": { "description": "The employer's hiring system the posting came from, e.g. workday, greenhouse or ashby.", "type": "string" }, "salary": { "description": "The pay the posting states, or null when it states none.", "properties": { "currency": { "description": "ISO code of the stated pay.", "type": "string" }, "max": { "description": "Highest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "min": { "description": "Lowest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "period": { "description": "What the amounts are for (year, month, week, day or hour) when the posting states a period ApplySent recognizes.", "type": [ "string", "null" ] } }, "required": [ "min", "max", "currency", "period" ], "type": [ "object", "null" ] }, "saved": { "description": "Whether the user saved this job.", "type": "boolean" }, "title": { "description": "The posting's title as the employer states it.", "type": "string" } }, "required": [ "id", "match", "description" ], "type": "object" }, "type": "array" }, "missing": { "description": "The requested ids this account does not hold.", "items": { "description": "One job id that is not in this account.", "type": "string" }, "type": "array" } }, "required": [ "jobs", "missing", "coverage" ], "type": "object" } }, { "description": "One email from the application inbox with its text and the application it belongs to. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "message_id": { "anyOf": [ { "maximum": 9223372036854776000, "minimum": 1, "type": "integer" }, { "maxLength": 19, "pattern": "^0*[1-9][0-9]*$", "type": "string" } ], "description": "A message id from list_inbox." } }, "required": [ "message_id" ], "type": "object" }, "name": "get_message", "outputSchema": { "properties": { "application": { "description": "The application this email belongs to, or null when it belongs to none.", "properties": { "company": { "description": "The employer's name.", "type": [ "string", "null" ] }, "job_id": { "description": "The job id of the application.", "type": "string" }, "status": { "description": "The application's ledger status.", "type": [ "string", "null" ] }, "title": { "description": "The posting's title.", "type": [ "string", "null" ] } }, "required": [ "job_id" ], "type": [ "object", "null" ] }, "body": { "description": "The email's text, cut to the tool's length.", "type": "string" }, "body_truncated": { "description": "True when the email's text was cut.", "type": "boolean" }, "category": { "description": "What the email is, as classified: interview, rejection, assessment, offer, recruiter, verification, application_confirmation or unknown.", "type": "string" }, "id": { "description": "The message id get_message and get_thread take.", "type": "integer" }, "received_at": { "description": "When the email arrived, ISO 8601.", "type": "string" }, "sender": { "description": "The sender's address.", "type": "string" }, "subject": { "description": "The email's subject as received.", "type": "string" } }, "required": [ "id", "body" ], "type": "object" } }, { "description": "Receipt-confirmed application metrics for a window of UTC days: confirmations, their daily and rolling 30-day counts, and the rolling interview rate; internal AI spend is left out. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "days": { "default": 7, "description": "How many UTC days back to count, ending today.", "maximum": 365, "minimum": 1, "type": "integer" } }, "required": [], "type": "object" }, "name": "get_metrics", "outputSchema": { "properties": { "confirmed_count": { "description": "Applications confirmed by a receipt inside the window.", "type": "integer" }, "confirmed_per_day": { "description": "Confirmed applications per day across the window.", "type": "number" }, "daily_confirmed": { "additionalProperties": { "description": "Applications confirmed that UTC day.", "type": "integer" }, "description": "Confirmed applications by UTC date inside the window.", "type": "object" }, "days": { "description": "How many UTC days back the window counts.", "type": "integer" }, "receipts_by_kind": { "additionalProperties": { "description": "Confirmations of this kind.", "type": "integer" }, "description": "Confirmations by receipt kind.", "type": "object" }, "receipts_by_provider": { "additionalProperties": { "description": "Confirmations from this hiring system.", "type": "integer" }, "description": "Confirmations by hiring system.", "type": "object" }, "rolling_30d_confirmed": { "description": "Applications confirmed in the last 30 days.", "type": "integer" }, "rolling_30d_interview_rate": { "description": "Interviews per confirmed application over those 30 days, or null when nothing was confirmed.", "type": [ "number", "null" ] }, "rolling_30d_interviews": { "description": "Applications that reached interview or offer in the last 30 days.", "type": "integer" }, "uncertain_count": { "description": "Applications sent without a confirmed receipt, account-wide now.", "type": "integer" } }, "required": [ "days", "confirmed_count", "uncertain_count" ], "type": "object" } }, { "description": "The user's push categories and email and Telegram notification preferences, as the app and site show them. Reads only.", "inputSchema": { "additionalProperties": false, "properties": {}, "required": [], "type": "object" }, "name": "get_notification_settings", "outputSchema": { "properties": { "notifications": { "description": "The email and Telegram notification preferences.", "properties": { "application_updates": { "description": "Whether application status changes are announced.", "type": "boolean" }, "email": { "description": "Whether notifications go out by email.", "type": "boolean" }, "failure_alerts": { "description": "Whether an application that was not sent, or needs the user, is emailed once.", "type": "boolean" }, "interview_alerts": { "description": "Whether interview invitations, assessments and offers are announced.", "type": "boolean" }, "job_alerts": { "description": "Whether new matching roles are announced.", "type": "boolean" }, "telegram": { "description": "Whether notifications go out on Telegram.", "type": "boolean" } }, "required": [ "job_alerts", "application_updates", "interview_alerts", "email", "telegram", "failure_alerts" ], "type": "object" }, "push": { "description": "The push categories, as the app and site show them.", "properties": { "application_updates": { "description": "Whether a push announces an application submitted, needing an answer or answered.", "type": "boolean" }, "daily_roles": { "description": "Whether a daily push summarises the new matching roles.", "type": "boolean" }, "reminders": { "description": "Whether a push nudges when something waits on the user.", "type": "boolean" }, "tips_offers": { "description": "Whether a push carries occasional tips and offers.", "type": "boolean" } }, "required": [ "application_updates", "daily_roles", "reminders", "tips_offers" ], "type": "object" } }, "required": [ "push", "notifications" ], "type": "object" } }, { "description": "What the user's ApplySent profile still needs before applications can go out, and how many employer questions wait. Reports what is missing, not the values. Reads only.", "inputSchema": { "additionalProperties": false, "properties": {}, "required": [], "type": "object" }, "name": "get_profile_status", "outputSchema": { "properties": { "missing": { "description": "What the profile still needs, in words.", "items": { "description": "One thing the profile lacks.", "type": "string" }, "type": "array" }, "pending_questions": { "description": "How many employer questions wait on the user.", "type": "integer" }, "ready": { "description": "True when the profile has everything an application needs.", "type": "boolean" }, "tailor_resume": { "description": "Whether the user asked for a résumé tailored to each job.", "type": "boolean" }, "targets": { "description": "What the user targets, as the profile records it.", "properties": { "countries": { "description": "The countries the user targets.", "items": { "description": "One target country.", "type": "string" }, "type": "array" }, "job_titles": { "description": "The job titles the user targets.", "items": { "description": "One target job title.", "type": "string" }, "type": "array" }, "workplace_types": { "description": "The workplace types the user targets.", "items": { "description": "One workplace type, e.g. remote or hybrid.", "type": "string" }, "type": "array" } }, "required": [ "job_titles", "countries", "workplace_types" ], "type": "object" } }, "required": [ "ready", "missing" ], "type": "object" } }, { "description": "The conversation around one email: every email of the same application, or of the same sender and subject when it belongs to none, oldest first. Each message gives its id, sender, subject, received time, category and the application it belongs to, without bodies. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "message_id": { "anyOf": [ { "maximum": 9223372036854776000, "minimum": 1, "type": "integer" }, { "maxLength": 19, "pattern": "^0*[1-9][0-9]*$", "type": "string" } ], "description": "A message id from list_inbox." } }, "required": [ "message_id" ], "type": "object" }, "name": "get_thread", "outputSchema": { "properties": { "messages": { "description": "Every email of the conversation, oldest first, without bodies.", "items": { "description": "One email of the inbox: who sent it, when, what it is and the application it belongs to.", "properties": { "application": { "description": "The application this email belongs to, or null when it belongs to none.", "properties": { "company": { "description": "The employer's name.", "type": [ "string", "null" ] }, "job_id": { "description": "The job id of the application.", "type": "string" }, "status": { "description": "The application's ledger status.", "type": [ "string", "null" ] }, "title": { "description": "The posting's title.", "type": [ "string", "null" ] } }, "required": [ "job_id" ], "type": [ "object", "null" ] }, "category": { "description": "What the email is, as classified: interview, rejection, assessment, offer, recruiter, verification, application_confirmation or unknown.", "type": "string" }, "id": { "description": "The message id get_message and get_thread take.", "type": "integer" }, "received_at": { "description": "When the email arrived, ISO 8601.", "type": "string" }, "sender": { "description": "The sender's address.", "type": "string" }, "subject": { "description": "The email's subject as received.", "type": "string" } }, "required": [ "id" ], "type": "object" }, "type": "array" } }, "required": [ "messages" ], "type": "object" } }, { "description": "The user's applications, newest first, with status and the employer's receipt when sent. status needs_you keeps those waiting on the user, uncertain those sent without a confirmed receipt (never sent again); started_by_this_client keeps those this assistant started. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "default": 20, "description": "How many applications to return.", "maximum": 50, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Rows to skip for the next page: the previous page's coverage names the offset to pass.", "minimum": 0, "type": "integer" }, "started_by_this_client": { "description": "Only applications this assistant started; leave it out for every application.", "type": "boolean" }, "status": { "default": "all", "description": "Which applications to list: every one, those waiting on the user, or those sent without a confirmed receipt.", "enum": [ "all", "needs_you", "uncertain" ], "type": "string" } }, "required": [], "type": "object" }, "name": "list_applications", "outputSchema": { "properties": { "applications": { "description": "The page of applications, newest first.", "items": { "description": "One application: where it stands, what it waits on and what to do next.", "properties": { "answer_batches": { "description": "The open question batches this application waits on.", "items": { "description": "A batch of open questions the employer's form raised for this application.", "properties": { "id": { "description": "The batch id answer_question takes as batch_id.", "type": "integer" }, "questions": { "description": "The questions this batch asks.", "items": { "description": "One open question of this batch.", "properties": { "kind": { "description": "The answer kind the form expects, e.g. text, choice or file.", "type": [ "string", "null" ] }, "options": { "description": "The options the form offers; empty for an open-text question.", "items": { "description": "One offered option.", "type": "string" }, "type": "array" }, "prompt": { "description": "The employer's question, in words.", "type": "string" }, "required": { "description": "Whether the form requires an answer.", "type": "boolean" } }, "required": [ "prompt" ], "type": "object" }, "type": "array" }, "revision": { "description": "The batch revision these questions belong to.", "type": "integer" } }, "required": [ "id", "questions" ], "type": "object" }, "type": "array" }, "answers": { "description": "The answers this application sends.", "items": { "description": "One answer this application sends.", "properties": { "answer": { "description": "The answer the application sends, as the user gave it.", "type": "string" }, "question": { "description": "The employer's question as it was asked.", "type": "string" }, "source": { "description": "Where the answer came from, such as the profile field it was taken from.", "type": [ "string", "null" ] } }, "required": [ "question", "answer" ], "type": "object" }, "type": "array" }, "apply_url": { "description": "The employer's posting URL.", "type": "string" }, "company": { "description": "The employer's name, when the ledger has it.", "type": [ "string", "null" ] }, "hold": { "description": "What the employer waits on before this application can go on, when it waits on something ApplySent recognizes.", "properties": { "kind": { "description": "The kind of hold, e.g. account_required or account_creation_required.", "type": [ "string", "null" ] }, "message": { "description": "The hold in words, for the user.", "type": [ "string", "null" ] } }, "required": [ "kind", "message" ], "type": [ "object", "null" ] }, "id": { "description": "The job id of this application.", "type": "string" }, "missing_prerequisites": { "description": "What still stops this application from being sent, in words.", "items": { "description": "One thing still missing.", "type": "string" }, "type": "array" }, "not_sent_reason": { "description": "Why a failed application was not sent, when ApplySent refused it.", "type": [ "string", "null" ] }, "poll_after_seconds": { "description": "Seconds to wait before reading this application again; null when nothing will change by itself.", "type": [ "integer", "null" ] }, "receipt": { "description": "The employer's confirmation of this application, or null when none was recorded.", "properties": { "evidence": { "description": "The evidence the confirmation rests on.", "type": "string" }, "job_ref": { "description": "The reference the employer's system gave the submission.", "type": [ "string", "null" ] }, "kind": { "description": "What the confirmation is, e.g. a submission page or an employer email.", "type": "string" }, "observed_at": { "description": "When the confirmation was observed, ISO 8601.", "type": "string" }, "packet_revision": { "description": "The packet revision that was sent.", "type": [ "integer", "null" ] }, "provider": { "description": "The hiring system that confirmed the submission.", "type": "string" } }, "required": [ "provider", "kind", "evidence", "observed_at" ], "type": [ "object", "null" ] }, "recorded_at": { "description": "When the user started this application, ISO 8601.", "type": [ "string", "null" ] }, "retry_at": { "description": "When ApplySent retries a blocked application, ISO 8601.", "type": [ "string", "null" ] }, "review": { "description": "How far the review of this application has come.", "properties": { "answers_filled": { "description": "How many answers the application holds.", "type": "integer" }, "details_needed": { "description": "The employer questions still waiting on the user.", "items": { "description": "One question waiting on the user.", "type": "string" }, "type": "array" }, "line": { "description": "The same in one sentence, for the user.", "type": "string" } }, "required": [ "answers_filled", "details_needed", "line" ], "type": "object" }, "review_reasons": { "description": "Why the application waits for the user's review.", "items": { "description": "One reason the application waits for the user.", "type": "string" }, "type": "array" }, "stage": { "description": "The hiring stage the employer's messages established (applied, interview, offer, rejected), when known.", "type": [ "string", "null" ] }, "status": { "description": "The application's ledger status, e.g. queued, submitted, uncertain or failed.", "type": "string" }, "step": { "description": "Where the application stands in ApplySent's pipeline, e.g. preparing_application, needs_answer or sent.", "type": "string" }, "suggested_next_tool": { "description": "The tool that answers what this application needs next.", "type": "string" }, "title": { "description": "The posting's title, when the ledger has it.", "type": [ "string", "null" ] }, "uncertain": { "description": "True when the send went out without a confirmed receipt; ApplySent never sends such a job again.", "type": "boolean" }, "waiting": { "description": "Set while the background worker is on this application right now.", "type": [ "string", "null" ] } }, "required": [ "id", "status", "step", "uncertain", "suggested_next_tool" ], "type": "object" }, "type": "array" }, "coverage": { "description": "What this page covers, so the assistant can say honestly what it read.", "properties": { "complete": { "description": "True when this page holds every matching row and no earlier page was skipped.", "type": "boolean" }, "empty_reason": { "description": "Why nothing came back, when the page is empty; null when it holds rows.", "type": [ "string", "null" ] }, "gaps": { "description": "What this result does not hold, one entry per gap.", "items": { "description": "One kind of row this result does not hold.", "properties": { "kind": { "description": "Why the row is missing: \"page\" for later rows, \"earlier_pages\" for rows before this page, \"filtered\" for rows a filter left out.", "type": "string" }, "what": { "description": "The gap in words: the offset to ask for next, or what was filtered out.", "type": "string" } }, "required": [ "kind", "what" ], "type": "object" }, "type": "array" }, "line": { "description": "One sentence saying what this page holds, what was left out and what was not read; show it to the user as it is.", "type": "string" }, "total": { "description": "How many rows the filters match in all, when that is known.", "type": [ "integer", "null" ] } }, "required": [ "line", "complete", "gaps" ], "type": "object" }, "more": { "description": "True when later pages hold more applications.", "type": "boolean" }, "offset": { "description": "The offset this page starts at.", "type": "integer" } }, "required": [ "applications", "offset", "more", "coverage" ], "type": "object" } }, { "description": "The employers the user excluded from matches, by name, with when each was excluded; a page at a time. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "default": 100, "description": "How many companies to return.", "maximum": 200, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Rows to skip for the next page: the previous page's coverage names the offset to pass.", "minimum": 0, "type": "integer" } }, "required": [], "type": "object" }, "name": "list_blocked_companies", "outputSchema": { "properties": { "companies": { "description": "The page of excluded employers, by name.", "items": { "description": "One excluded employer.", "properties": { "company": { "description": "The employer name as postings state it.", "type": "string" }, "created_at": { "description": "When the employer was excluded, ISO 8601.", "type": "string" } }, "required": [ "company", "created_at" ], "type": "object" }, "type": "array" }, "coverage": { "description": "What this page covers, so the assistant can say honestly what it read.", "properties": { "complete": { "description": "True when this page holds every matching row and no earlier page was skipped.", "type": "boolean" }, "empty_reason": { "description": "Why nothing came back, when the page is empty; null when it holds rows.", "type": [ "string", "null" ] }, "gaps": { "description": "What this result does not hold, one entry per gap.", "items": { "description": "One kind of row this result does not hold.", "properties": { "kind": { "description": "Why the row is missing: \"page\" for later rows, \"earlier_pages\" for rows before this page, \"filtered\" for rows a filter left out.", "type": "string" }, "what": { "description": "The gap in words: the offset to ask for next, or what was filtered out.", "type": "string" } }, "required": [ "kind", "what" ], "type": "object" }, "type": "array" }, "line": { "description": "One sentence saying what this page holds, what was left out and what was not read; show it to the user as it is.", "type": "string" }, "total": { "description": "How many rows the filters match in all, when that is known.", "type": [ "integer", "null" ] } }, "required": [ "line", "complete", "gaps" ], "type": "object" }, "more": { "description": "True when later pages hold more employers.", "type": "boolean" }, "offset": { "description": "The offset this page starts at.", "type": "integer" }, "total": { "description": "How many employers the user excluded.", "type": "integer" } }, "required": [ "companies", "offset", "total", "more", "coverage" ], "type": "object" } }, { "description": "Employer emails in the user's application inbox, newest first, classified (interview, rejection, verification, assessment...) and linked to the application they belong to. Reads only; nothing is sent.", "inputSchema": { "additionalProperties": false, "properties": { "category": { "description": "Only emails the classifier put in this category; leave it out for every category.", "enum": [ "application_confirmation", "assessment", "interview", "offer", "recruiter", "rejection", "unknown", "verification" ], "type": "string" }, "limit": { "default": 20, "description": "How many emails to return.", "maximum": 50, "minimum": 1, "type": "integer" } }, "required": [], "type": "object" }, "name": "list_inbox", "outputSchema": { "properties": { "coverage": { "description": "What this page covers, so the assistant can say honestly what it read.", "properties": { "complete": { "description": "True when this page holds every matching row and no earlier page was skipped.", "type": "boolean" }, "empty_reason": { "description": "Why nothing came back, when the page is empty; null when it holds rows.", "type": [ "string", "null" ] }, "gaps": { "description": "What this result does not hold, one entry per gap.", "items": { "description": "One kind of row this result does not hold.", "properties": { "kind": { "description": "Why the row is missing: \"page\" for later rows, \"earlier_pages\" for rows before this page, \"filtered\" for rows a filter left out.", "type": "string" }, "what": { "description": "The gap in words: the offset to ask for next, or what was filtered out.", "type": "string" } }, "required": [ "kind", "what" ], "type": "object" }, "type": "array" }, "line": { "description": "One sentence saying what this page holds, what was left out and what was not read; show it to the user as it is.", "type": "string" }, "total": { "description": "How many rows the filters match in all, when that is known.", "type": [ "integer", "null" ] } }, "required": [ "line", "complete", "gaps" ], "type": "object" }, "messages": { "description": "The page of employer emails, newest first.", "items": { "description": "One email of the inbox: who sent it, when, what it is and the application it belongs to.", "properties": { "application": { "description": "The application this email belongs to, or null when it belongs to none.", "properties": { "company": { "description": "The employer's name.", "type": [ "string", "null" ] }, "job_id": { "description": "The job id of the application.", "type": "string" }, "status": { "description": "The application's ledger status.", "type": [ "string", "null" ] }, "title": { "description": "The posting's title.", "type": [ "string", "null" ] } }, "required": [ "job_id" ], "type": [ "object", "null" ] }, "category": { "description": "What the email is, as classified: interview, rejection, assessment, offer, recruiter, verification, application_confirmation or unknown.", "type": "string" }, "id": { "description": "The message id get_message and get_thread take.", "type": "integer" }, "received_at": { "description": "When the email arrived, ISO 8601.", "type": "string" }, "sender": { "description": "The sender's address.", "type": "string" }, "subject": { "description": "The email's subject as received.", "type": "string" } }, "required": [ "id" ], "type": "object" }, "type": "array" } }, "required": [ "messages", "coverage" ], "type": "object" } }, { "description": "The user's notification feed, newest first, a page at a time, with coverage saying what was left out. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "default": 20, "description": "How many notifications to return.", "maximum": 50, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Rows to skip for the next page: the previous page's coverage names the offset to pass.", "minimum": 0, "type": "integer" } }, "required": [], "type": "object" }, "name": "list_notifications", "outputSchema": { "properties": { "coverage": { "description": "What this page covers, so the assistant can say honestly what it read.", "properties": { "complete": { "description": "True when this page holds every matching row and no earlier page was skipped.", "type": "boolean" }, "empty_reason": { "description": "Why nothing came back, when the page is empty; null when it holds rows.", "type": [ "string", "null" ] }, "gaps": { "description": "What this result does not hold, one entry per gap.", "items": { "description": "One kind of row this result does not hold.", "properties": { "kind": { "description": "Why the row is missing: \"page\" for later rows, \"earlier_pages\" for rows before this page, \"filtered\" for rows a filter left out.", "type": "string" }, "what": { "description": "The gap in words: the offset to ask for next, or what was filtered out.", "type": "string" } }, "required": [ "kind", "what" ], "type": "object" }, "type": "array" }, "line": { "description": "One sentence saying what this page holds, what was left out and what was not read; show it to the user as it is.", "type": "string" }, "total": { "description": "How many rows the filters match in all, when that is known.", "type": [ "integer", "null" ] } }, "required": [ "line", "complete", "gaps" ], "type": "object" }, "more": { "description": "True when later pages hold more notifications.", "type": "boolean" }, "notifications": { "description": "The page of notifications, newest first.", "items": { "description": "One notification of the feed.", "properties": { "body": { "description": "The notification's text.", "type": "string" }, "created_at": { "description": "When the notification was created, ISO 8601.", "type": "string" }, "id": { "description": "The notification id mark_notification_opened takes.", "type": "integer" }, "read": { "description": "True once the user opened it.", "type": "boolean" }, "title": { "description": "The notification's title.", "type": "string" }, "type": { "description": "What the notification is about.", "type": "string" }, "url": { "description": "Where the notification opens in ApplySent.", "type": "string" } }, "required": [ "id", "type", "title", "body", "url", "created_at", "read" ], "type": "object" }, "type": "array" }, "offset": { "description": "The offset this page starts at.", "type": "integer" } }, "required": [ "notifications", "offset", "more", "coverage" ], "type": "object" } }, { "description": "Questions employers asked that only the user can answer; the applications asking them wait. Each is asked once and its answer is reused for every application asking it. Each group gives its batch_id, the application, its questions and how many applications ask each. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "default": 10, "description": "How many question groups to return.", "maximum": 20, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Rows to skip for the next page: the previous page's coverage names the offset to pass.", "minimum": 0, "type": "integer" } }, "required": [], "type": "object" }, "name": "list_pending_questions", "outputSchema": { "properties": { "applications_waiting": { "description": "How many applications wait on those answers.", "type": "integer" }, "coverage": { "description": "What this page covers, so the assistant can say honestly what it read.", "properties": { "complete": { "description": "True when this page holds every matching row and no earlier page was skipped.", "type": "boolean" }, "empty_reason": { "description": "Why nothing came back, when the page is empty; null when it holds rows.", "type": [ "string", "null" ] }, "gaps": { "description": "What this result does not hold, one entry per gap.", "items": { "description": "One kind of row this result does not hold.", "properties": { "kind": { "description": "Why the row is missing: \"page\" for later rows, \"earlier_pages\" for rows before this page, \"filtered\" for rows a filter left out.", "type": "string" }, "what": { "description": "The gap in words: the offset to ask for next, or what was filtered out.", "type": "string" } }, "required": [ "kind", "what" ], "type": "object" }, "type": "array" }, "line": { "description": "One sentence saying what this page holds, what was left out and what was not read; show it to the user as it is.", "type": "string" }, "total": { "description": "How many rows the filters match in all, when that is known.", "type": [ "integer", "null" ] } }, "required": [ "line", "complete", "gaps" ], "type": "object" }, "groups": { "description": "The page of question groups, widest reach first.", "items": { "description": "One group of questions asked once and answered once.", "properties": { "answer_on_applysent": { "description": "True when the question must be answered on its application in ApplySent, not here.", "type": "boolean" }, "batch_id": { "description": "The batch id answer_question takes.", "type": "integer" }, "company": { "description": "That employer's name.", "type": "string" }, "job_id": { "description": "The job id of the application that asked first.", "type": "string" }, "questions": { "description": "The questions this group asks, each asked once.", "items": { "description": "One question of this group.", "properties": { "applications_asking": { "description": "How many applications ask this question.", "type": "integer" }, "index": { "description": "The index answer_question takes as question_index.", "type": "integer" }, "kind": { "description": "The answer kind the form expects, e.g. text, choice or file.", "type": "string" }, "options": { "description": "The options the form offers; empty for an open-text question.", "items": { "description": "One offered option.", "type": "string" }, "type": "array" }, "prompt": { "description": "The employer's question, in words.", "type": "string" } }, "required": [ "index", "prompt", "kind", "options", "applications_asking" ], "type": "object" }, "type": "array" }, "title": { "description": "That posting's title.", "type": "string" } }, "required": [ "batch_id", "job_id", "title", "company", "answer_on_applysent", "questions" ], "type": "object" }, "type": "array" }, "total": { "description": "How many question groups wait on the user.", "type": "integer" } }, "required": [ "total", "groups", "coverage" ], "type": "object" } }, { "description": "The jobs the user saved, with each one's match assessment, best match first or newest first, a page at a time. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "default": 10, "description": "How many saved jobs to return.", "maximum": 25, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Rows to skip for the next page: the previous page's coverage names the offset to pass.", "minimum": 0, "type": "integer" }, "sort": { "default": "score", "description": "Order of the page: best match first, or newest first.", "enum": [ "score", "recent" ], "type": "string" } }, "required": [], "type": "object" }, "name": "list_saved_jobs", "outputSchema": { "properties": { "coverage": { "description": "What this page covers, so the assistant can say honestly what it read.", "properties": { "complete": { "description": "True when this page holds every matching row and no earlier page was skipped.", "type": "boolean" }, "empty_reason": { "description": "Why nothing came back, when the page is empty; null when it holds rows.", "type": [ "string", "null" ] }, "gaps": { "description": "What this result does not hold, one entry per gap.", "items": { "description": "One kind of row this result does not hold.", "properties": { "kind": { "description": "Why the row is missing: \"page\" for later rows, \"earlier_pages\" for rows before this page, \"filtered\" for rows a filter left out.", "type": "string" }, "what": { "description": "The gap in words: the offset to ask for next, or what was filtered out.", "type": "string" } }, "required": [ "kind", "what" ], "type": "object" }, "type": "array" }, "line": { "description": "One sentence saying what this page holds, what was left out and what was not read; show it to the user as it is.", "type": "string" }, "total": { "description": "How many rows the filters match in all, when that is known.", "type": [ "integer", "null" ] } }, "required": [ "line", "complete", "gaps" ], "type": "object" }, "jobs": { "description": "The page of saved jobs, best match first or newest first as asked.", "items": { "description": "One job row: its facts, its match assessment and the start of its text.", "properties": { "apply_supported": { "description": "Whether ApplySent can fill and submit this posting's form by itself.", "type": "boolean" }, "apply_url": { "description": "The employer's posting URL, where the application is filled.", "type": "string" }, "city": { "description": "City the posting is in.", "type": [ "string", "null" ] }, "company": { "description": "The employer's name.", "type": "string" }, "country": { "description": "Country the posting is in, as the catalogue recorded it.", "type": [ "string", "null" ] }, "excerpt": { "description": "The start of the posting's text, plain, for a list row.", "type": "string" }, "id": { "description": "The job id the other job tools take.", "type": "string" }, "match": { "description": "The assessment of this job against the user's résumé, targets and eligibility.", "properties": { "breakdown": { "additionalProperties": { "description": "Points this factor added to the score.", "type": "integer" }, "description": "Points each match factor added; a full job read carries them, a list row does not.", "type": "object" }, "eligible": { "description": "Whether the user may take this job: work authorization, language and the posting's stated requirements all pass.", "type": "boolean" }, "missing": { "description": "What the assessment could not establish about the user for this posting; a full job read carries it, a list row does not.", "items": { "description": "One fact the assessment could not establish about the user.", "type": "string" }, "type": "array" }, "notes": { "description": "Notes the assessment kept beside the score; a full job read carries them, a list row does not.", "items": { "description": "One note the assessment kept beside the score.", "type": "string" }, "type": "array" }, "reasons": { "description": "Why the job scores what it does, in words.", "items": { "description": "One reason the job scored as it did.", "type": "string" }, "type": "array" }, "score": { "description": "Match score from 0 to 100 against the user's résumé and targets; higher is better.", "type": "integer" } }, "required": [ "eligible", "score", "reasons" ], "type": "object" }, "posted_at": { "description": "When the posting went up, ISO 8601 in UTC, when the catalogue knows it.", "type": [ "string", "null" ] }, "provider": { "description": "The employer's hiring system the posting came from, e.g. workday, greenhouse or ashby.", "type": "string" }, "salary": { "description": "The pay the posting states, or null when it states none.", "properties": { "currency": { "description": "ISO code of the stated pay.", "type": "string" }, "max": { "description": "Highest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "min": { "description": "Lowest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "period": { "description": "What the amounts are for (year, month, week, day or hour) when the posting states a period ApplySent recognizes.", "type": [ "string", "null" ] } }, "required": [ "min", "max", "currency", "period" ], "type": [ "object", "null" ] }, "saved": { "description": "Whether the user saved this job.", "type": "boolean" }, "title": { "description": "The posting's title as the employer states it.", "type": "string" } }, "required": [ "id", "match" ], "type": "object" }, "type": "array" }, "more": { "description": "True when later pages hold more saved jobs.", "type": "boolean" }, "offset": { "description": "The offset this page starts at.", "type": "integer" }, "total": { "description": "How many jobs the user saved.", "type": "integer" } }, "required": [ "jobs", "offset", "total", "more", "coverage" ], "type": "object" } }, { "description": "Records the first opening of a notification. Repeating it changes nothing.", "inputSchema": { "additionalProperties": false, "properties": { "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "notification_id": { "description": "A notification id from list_notifications.", "minimum": 1, "type": "integer" } }, "required": [ "notification_id" ], "type": "object" }, "name": "mark_notification_opened", "outputSchema": { "properties": { "id": { "description": "The notification that was opened.", "type": "integer" }, "opened": { "description": "True once the opening is recorded; a repeat leaves it true.", "type": "boolean" } }, "required": [ "id", "opened" ], "type": "object" } }, { "description": "Shows what applying to one job would send and use, and returns a single-use confirmation_token for apply_to_job. The user must review this preview and say yes in the conversation before apply_to_job; the token works for this job and this connection only and expires after 10 minutes. Sends nothing.", "inputSchema": { "additionalProperties": false, "properties": { "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" } }, "required": [ "job_id" ], "type": "object" }, "name": "preview_application", "outputSchema": { "properties": { "confirmation_token": { "description": "The single-use token apply_to_job takes for this job.", "type": "string" }, "expires_in": { "description": "How many seconds the token stays valid.", "type": "integer" }, "job": { "description": "The job the application would go to.", "properties": { "apply_url": { "description": "The employer's posting URL.", "type": "string" }, "city": { "description": "City the posting is in.", "type": [ "string", "null" ] }, "company": { "description": "The employer's name.", "type": "string" }, "country": { "description": "Country the posting is in.", "type": [ "string", "null" ] }, "id": { "description": "The job id apply_to_job takes.", "type": "string" }, "salary": { "description": "The pay the posting states, or null when it states none.", "properties": { "currency": { "description": "ISO code of the stated pay.", "type": "string" }, "max": { "description": "Highest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "min": { "description": "Lowest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "period": { "description": "What the amounts are for (year, month, week, day or hour) when the posting states a period ApplySent recognizes.", "type": [ "string", "null" ] } }, "required": [ "min", "max", "currency", "period" ], "type": [ "object", "null" ] }, "title": { "description": "The posting's title.", "type": "string" } }, "required": [ "id", "title", "company", "apply_url" ], "type": "object" }, "match": { "description": "The assessment of the job against the user.", "properties": { "missing": { "description": "What the assessment could not establish about the user for this posting.", "items": { "description": "One fact the assessment could not establish.", "type": "string" }, "type": "array" }, "reasons": { "description": "Why the job scores what it does.", "items": { "description": "One reason the job scored as it did.", "type": "string" }, "type": "array" }, "score": { "description": "The match score against the user, from 0 to 100.", "type": "integer" } }, "required": [ "score", "reasons", "missing" ], "type": "object" }, "resume": { "description": "Which résumé the application would attach, in words.", "type": "string" }, "sends": { "description": "What ApplySent would fill and submit, in words.", "type": "string" }, "uses_applications": { "description": "How many applications this send draws from the allowance.", "type": "integer" } }, "required": [ "job", "confirmation_token", "expires_in" ], "type": "object" } }, { "description": "The résumé tailored to one job, as the PDF an application would attach, with what changed against the saved résumé. Made once with an AI model from facts already in the résumé, then reused; nothing is sent.", "inputSchema": { "additionalProperties": false, "properties": { "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" } }, "required": [ "job_id" ], "type": "object" }, "name": "preview_tailored_resume", "outputSchema": { "properties": { "approved": { "description": "Whether this résumé is the one approved to send with the application.", "type": "boolean" }, "changes": { "description": "What changed against the saved résumé.", "properties": { "added": { "description": "Lines the tailored résumé has that the saved one does not.", "items": { "description": "One résumé line the tailoring added.", "type": "string" }, "type": "array" }, "removed": { "description": "Lines the saved résumé has that the tailored one does not.", "items": { "description": "One résumé line the tailoring dropped.", "type": "string" }, "type": "array" } }, "required": [ "added", "removed" ], "type": "object" }, "company": { "description": "The employer's name.", "type": "string" }, "job_id": { "description": "The job id the résumé is tailored to.", "type": "string" }, "notes": { "description": "What the tailoring did and left out, as it reported it.", "items": { "description": "One note the tailoring kept.", "type": "string" }, "type": "array" }, "resume_sha256": { "description": "The tailored PDF's hash; approve_tailored_resume takes it.", "type": "string" }, "title": { "description": "The posting's title.", "type": "string" } }, "required": [ "job_id", "resume_sha256", "approved" ], "type": "object" } }, { "description": "Prepares one application for the user to review and approve in ApplySent; it is sent only after the user approves it there. Sends nothing. Refuses if a send is already in progress or the posting has already been sent.", "inputSchema": { "additionalProperties": false, "properties": { "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" } }, "required": [ "job_id" ], "type": "object" }, "name": "queue_application_for_review", "outputSchema": { "description": "One application: where it stands, what it waits on and what to do next.", "properties": { "answer_batches": { "description": "The open question batches this application waits on.", "items": { "description": "A batch of open questions the employer's form raised for this application.", "properties": { "id": { "description": "The batch id answer_question takes as batch_id.", "type": "integer" }, "questions": { "description": "The questions this batch asks.", "items": { "description": "One open question of this batch.", "properties": { "kind": { "description": "The answer kind the form expects, e.g. text, choice or file.", "type": [ "string", "null" ] }, "options": { "description": "The options the form offers; empty for an open-text question.", "items": { "description": "One offered option.", "type": "string" }, "type": "array" }, "prompt": { "description": "The employer's question, in words.", "type": "string" }, "required": { "description": "Whether the form requires an answer.", "type": "boolean" } }, "required": [ "prompt" ], "type": "object" }, "type": "array" }, "revision": { "description": "The batch revision these questions belong to.", "type": "integer" } }, "required": [ "id", "questions" ], "type": "object" }, "type": "array" }, "answers": { "description": "The answers this application sends.", "items": { "description": "One answer this application sends.", "properties": { "answer": { "description": "The answer the application sends, as the user gave it.", "type": "string" }, "question": { "description": "The employer's question as it was asked.", "type": "string" }, "source": { "description": "Where the answer came from, such as the profile field it was taken from.", "type": [ "string", "null" ] } }, "required": [ "question", "answer" ], "type": "object" }, "type": "array" }, "apply_url": { "description": "The employer's posting URL.", "type": "string" }, "company": { "description": "The employer's name, when the ledger has it.", "type": [ "string", "null" ] }, "hold": { "description": "What the employer waits on before this application can go on, when it waits on something ApplySent recognizes.", "properties": { "kind": { "description": "The kind of hold, e.g. account_required or account_creation_required.", "type": [ "string", "null" ] }, "message": { "description": "The hold in words, for the user.", "type": [ "string", "null" ] } }, "required": [ "kind", "message" ], "type": [ "object", "null" ] }, "id": { "description": "The job id of this application.", "type": "string" }, "missing_prerequisites": { "description": "What still stops this application from being sent, in words.", "items": { "description": "One thing still missing.", "type": "string" }, "type": "array" }, "not_sent_reason": { "description": "Why a failed application was not sent, when ApplySent refused it.", "type": [ "string", "null" ] }, "poll_after_seconds": { "description": "Seconds to wait before reading this application again; null when nothing will change by itself.", "type": [ "integer", "null" ] }, "receipt": { "description": "The employer's confirmation of this application, or null when none was recorded.", "properties": { "evidence": { "description": "The evidence the confirmation rests on.", "type": "string" }, "job_ref": { "description": "The reference the employer's system gave the submission.", "type": [ "string", "null" ] }, "kind": { "description": "What the confirmation is, e.g. a submission page or an employer email.", "type": "string" }, "observed_at": { "description": "When the confirmation was observed, ISO 8601.", "type": "string" }, "packet_revision": { "description": "The packet revision that was sent.", "type": [ "integer", "null" ] }, "provider": { "description": "The hiring system that confirmed the submission.", "type": "string" } }, "required": [ "provider", "kind", "evidence", "observed_at" ], "type": [ "object", "null" ] }, "recorded_at": { "description": "When the user started this application, ISO 8601.", "type": [ "string", "null" ] }, "retry_at": { "description": "When ApplySent retries a blocked application, ISO 8601.", "type": [ "string", "null" ] }, "review": { "description": "How far the review of this application has come.", "properties": { "answers_filled": { "description": "How many answers the application holds.", "type": "integer" }, "details_needed": { "description": "The employer questions still waiting on the user.", "items": { "description": "One question waiting on the user.", "type": "string" }, "type": "array" }, "line": { "description": "The same in one sentence, for the user.", "type": "string" } }, "required": [ "answers_filled", "details_needed", "line" ], "type": "object" }, "review_reasons": { "description": "Why the application waits for the user's review.", "items": { "description": "One reason the application waits for the user.", "type": "string" }, "type": "array" }, "stage": { "description": "The hiring stage the employer's messages established (applied, interview, offer, rejected), when known.", "type": [ "string", "null" ] }, "status": { "description": "The application's ledger status, e.g. queued, submitted, uncertain or failed.", "type": "string" }, "step": { "description": "Where the application stands in ApplySent's pipeline, e.g. preparing_application, needs_answer or sent.", "type": "string" }, "suggested_next_tool": { "description": "The tool that answers what this application needs next.", "type": "string" }, "title": { "description": "The posting's title, when the ledger has it.", "type": [ "string", "null" ] }, "uncertain": { "description": "True when the send went out without a confirmed receipt; ApplySent never sends such a job again.", "type": "boolean" }, "waiting": { "description": "Set while the background worker is on this application right now.", "type": [ "string", "null" ] } }, "required": [ "id", "status", "step", "uncertain", "suggested_next_tool" ], "type": "object" } }, { "description": "Discards the job's tailored résumé and its approval, then tailors it again with an AI model from the saved résumé, and returns the new résumé with what changed. Refused once the application was sent or is sending.", "inputSchema": { "additionalProperties": false, "properties": { "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" } }, "required": [ "job_id" ], "type": "object" }, "name": "regenerate_tailored_resume", "outputSchema": { "properties": { "approved": { "description": "Whether this résumé is the one approved to send with the application.", "type": "boolean" }, "changes": { "description": "What changed against the saved résumé.", "properties": { "added": { "description": "Lines the tailored résumé has that the saved one does not.", "items": { "description": "One résumé line the tailoring added.", "type": "string" }, "type": "array" }, "removed": { "description": "Lines the saved résumé has that the tailored one does not.", "items": { "description": "One résumé line the tailoring dropped.", "type": "string" }, "type": "array" } }, "required": [ "added", "removed" ], "type": "object" }, "company": { "description": "The employer's name.", "type": "string" }, "job_id": { "description": "The job id the résumé is tailored to.", "type": "string" }, "notes": { "description": "What the tailoring did and left out, as it reported it.", "items": { "description": "One note the tailoring kept.", "type": "string" }, "type": "array" }, "resume_sha256": { "description": "The tailored PDF's hash; approve_tailored_resume takes it.", "type": "string" }, "title": { "description": "The posting's title.", "type": "string" } }, "required": [ "job_id", "resume_sha256", "approved" ], "type": "object" } }, { "description": "The same matching search as search_jobs, best match first, as citable results: each job's id, its title and employer, and the employer's posting URL; fetch reads one in full. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "query": { "description": "Words in the title, employer or description.", "type": "string" } }, "required": [ "query" ], "type": "object" }, "name": "search", "outputSchema": { "properties": { "results": { "description": "The matching jobs as citable results, best match first.", "items": { "description": "One matching job as a citable result.", "properties": { "id": { "description": "The job id fetch takes.", "type": "string" }, "title": { "description": "The posting's title and employer in one line.", "type": "string" }, "url": { "description": "The employer's posting URL, for citing it.", "type": "string" } }, "required": [ "id", "title", "url" ], "type": "object" }, "type": "array" } }, "required": [ "results" ], "type": "object" } }, { "description": "Search the jobs that match the user's résumé and filters, best match first, a page at a time. Leaves out jobs already applied to unless include_applied is true, and postings open only to nationals unless the profile lists a nationality or nationals_only says otherwise. Reads only.", "inputSchema": { "additionalProperties": false, "properties": { "city": { "description": "City the posting is in, e.g. \"Dubai\" or \"London\".", "type": "string" }, "country": { "description": "Country name or ISO code, e.g. \"US\", \"United Kingdom\", \"AE\".", "type": "string" }, "employment_type": { "description": "e.g. full_time, part_time, contract.", "type": "string" }, "include_applied": { "description": "Include jobs already applied to; they are left out otherwise.", "type": "boolean" }, "limit": { "default": 10, "description": "How many jobs to return.", "maximum": 25, "minimum": 1, "type": "integer" }, "min_salary": { "description": "Only jobs stating pay of at least this; a job with no stated salary is left out.", "minimum": 0, "type": "number" }, "min_score": { "description": "Only jobs the résumé matches at least this well; leave it out for no floor.", "maximum": 100, "minimum": 0, "type": "integer" }, "nationals_only": { "description": "Whether postings open only to a country's nationals are left out, included, or the only ones kept; leaving it out excludes them unless the profile lists a nationality.", "enum": [ "exclude", "include", "only" ], "type": "string" }, "offset": { "default": 0, "description": "Rows to skip for the next page: the previous page's coverage names the offset to pass.", "minimum": 0, "type": "integer" }, "posted_since": { "description": "ISO date; only jobs posted on or after it. Jobs with no known posting date are left out.", "type": "string" }, "query": { "description": "Words in the title, employer or description.", "type": "string" }, "salary_currency": { "description": "ISO code of the currency the stated pay must be in: with min_salary the floor is read in that currency, on its own it keeps the jobs that state pay in it.", "type": "string" }, "seniority": { "description": "Seniority as postings state it, e.g. \"senior\", \"junior\", \"lead\".", "type": "string" }, "sort": { "default": "score", "description": "Order of the page: best match first, or newest posting first.", "enum": [ "score", "recent" ], "type": "string" }, "workplace": { "description": "Where the work is done; leave it out for any.", "enum": [ "remote", "hybrid", "onsite" ], "type": "string" } }, "required": [], "type": "object" }, "name": "search_jobs", "outputSchema": { "properties": { "coverage": { "description": "What this page covers, so the assistant can say honestly what it read.", "properties": { "complete": { "description": "True when this page holds every matching row and no earlier page was skipped.", "type": "boolean" }, "empty_reason": { "description": "Why nothing came back, when the page is empty; null when it holds rows.", "type": [ "string", "null" ] }, "gaps": { "description": "What this result does not hold, one entry per gap.", "items": { "description": "One kind of row this result does not hold.", "properties": { "kind": { "description": "Why the row is missing: \"page\" for later rows, \"earlier_pages\" for rows before this page, \"filtered\" for rows a filter left out.", "type": "string" }, "what": { "description": "The gap in words: the offset to ask for next, or what was filtered out.", "type": "string" } }, "required": [ "kind", "what" ], "type": "object" }, "type": "array" }, "line": { "description": "One sentence saying what this page holds, what was left out and what was not read; show it to the user as it is.", "type": "string" }, "total": { "description": "How many rows the filters match in all, when that is known.", "type": [ "integer", "null" ] } }, "required": [ "line", "complete", "gaps" ], "type": "object" }, "jobs": { "description": "The page of matching jobs, best match first or newest first as asked.", "items": { "description": "One job row: its facts, its match assessment and the start of its text.", "properties": { "apply_supported": { "description": "Whether ApplySent can fill and submit this posting's form by itself.", "type": "boolean" }, "apply_url": { "description": "The employer's posting URL, where the application is filled.", "type": "string" }, "city": { "description": "City the posting is in.", "type": [ "string", "null" ] }, "company": { "description": "The employer's name.", "type": "string" }, "country": { "description": "Country the posting is in, as the catalogue recorded it.", "type": [ "string", "null" ] }, "excerpt": { "description": "The start of the posting's text, plain, for a list row.", "type": "string" }, "id": { "description": "The job id the other job tools take.", "type": "string" }, "match": { "description": "The assessment of this job against the user's résumé, targets and eligibility.", "properties": { "breakdown": { "additionalProperties": { "description": "Points this factor added to the score.", "type": "integer" }, "description": "Points each match factor added; a full job read carries them, a list row does not.", "type": "object" }, "eligible": { "description": "Whether the user may take this job: work authorization, language and the posting's stated requirements all pass.", "type": "boolean" }, "missing": { "description": "What the assessment could not establish about the user for this posting; a full job read carries it, a list row does not.", "items": { "description": "One fact the assessment could not establish about the user.", "type": "string" }, "type": "array" }, "notes": { "description": "Notes the assessment kept beside the score; a full job read carries them, a list row does not.", "items": { "description": "One note the assessment kept beside the score.", "type": "string" }, "type": "array" }, "reasons": { "description": "Why the job scores what it does, in words.", "items": { "description": "One reason the job scored as it did.", "type": "string" }, "type": "array" }, "score": { "description": "Match score from 0 to 100 against the user's résumé and targets; higher is better.", "type": "integer" } }, "required": [ "eligible", "score", "reasons" ], "type": "object" }, "posted_at": { "description": "When the posting went up, ISO 8601 in UTC, when the catalogue knows it.", "type": [ "string", "null" ] }, "provider": { "description": "The employer's hiring system the posting came from, e.g. workday, greenhouse or ashby.", "type": "string" }, "salary": { "description": "The pay the posting states, or null when it states none.", "properties": { "currency": { "description": "ISO code of the stated pay.", "type": "string" }, "max": { "description": "Highest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "min": { "description": "Lowest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "period": { "description": "What the amounts are for (year, month, week, day or hour) when the posting states a period ApplySent recognizes.", "type": [ "string", "null" ] } }, "required": [ "min", "max", "currency", "period" ], "type": [ "object", "null" ] }, "saved": { "description": "Whether the user saved this job.", "type": "boolean" }, "title": { "description": "The posting's title as the employer states it.", "type": "string" } }, "required": [ "id", "match" ], "type": "object" }, "type": "array" }, "more": { "description": "True when later pages hold more jobs.", "type": "boolean" }, "offset": { "description": "The offset this page starts at.", "type": "integer" }, "total": { "description": "How many jobs the filters match in all.", "type": "integer" } }, "required": [ "jobs", "offset", "total", "more", "coverage" ], "type": "object" } }, { "description": "Excludes one employer from the user's matches, or removes its exclusion, and returns the full list of excluded employers.", "inputSchema": { "additionalProperties": false, "properties": { "blocked": { "description": "true excludes the company from matches, false restores it.", "type": "boolean" }, "company": { "description": "The employer name as postings state it.", "maxLength": 2000, "type": "string" }, "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" } }, "required": [ "company", "blocked" ], "type": "object" }, "name": "set_company_blocked", "outputSchema": { "properties": { "blocked": { "description": "True when the employer is now excluded, false when it was restored.", "type": "boolean" }, "changed": { "description": "True when this call changed the list, false when it already stood that way.", "type": "boolean" }, "companies": { "description": "Every employer the user excludes now.", "items": { "description": "One excluded employer.", "properties": { "company": { "description": "The employer name as postings state it.", "type": "string" }, "created_at": { "description": "When the employer was excluded, ISO 8601.", "type": "string" } }, "required": [ "company", "created_at" ], "type": "object" }, "type": "array" }, "company": { "description": "The employer name the exclusion was recorded for.", "type": "string" } }, "required": [ "company", "blocked", "changed", "companies" ], "type": "object" } }, { "description": "Skips a job or restores a skipped job. Skipping cancels a swipe only if it has not yet been queued; it does not cancel an already queued application.", "inputSchema": { "additionalProperties": false, "properties": { "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" }, "signal": { "description": "Whether the user is not interested in this job, or wants an earlier skip taken back.", "enum": [ "not_interested", "undo" ], "type": "string" } }, "required": [ "job_id", "signal" ], "type": "object" }, "name": "set_job_feedback", "outputSchema": { "properties": { "job_id": { "description": "The job the feedback was recorded for.", "type": "string" }, "signal": { "description": "The signal stored: not_interested, or undo once the skip was taken back.", "type": "string" }, "skipped": { "description": "True while the job is skipped.", "type": "boolean" } }, "required": [ "job_id", "signal", "skipped" ], "type": "object" } }, { "description": "Saves one job to the user's saved jobs, or removes it, and returns the job with its match assessment.", "inputSchema": { "additionalProperties": false, "properties": { "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "job_id": { "description": "A job id from search_jobs, get_job_from_link or list_applications.", "type": "string" }, "saved": { "description": "true saves the job, false removes it.", "type": "boolean" } }, "required": [ "job_id", "saved" ], "type": "object" }, "name": "set_job_saved", "outputSchema": { "description": "One job row: its facts, its match assessment and the start of its text.", "properties": { "apply_supported": { "description": "Whether ApplySent can fill and submit this posting's form by itself.", "type": "boolean" }, "apply_url": { "description": "The employer's posting URL, where the application is filled.", "type": "string" }, "city": { "description": "City the posting is in.", "type": [ "string", "null" ] }, "company": { "description": "The employer's name.", "type": "string" }, "country": { "description": "Country the posting is in, as the catalogue recorded it.", "type": [ "string", "null" ] }, "excerpt": { "description": "The start of the posting's text, plain, for a list row.", "type": "string" }, "id": { "description": "The job id the other job tools take.", "type": "string" }, "match": { "description": "The assessment of this job against the user's résumé, targets and eligibility.", "properties": { "breakdown": { "additionalProperties": { "description": "Points this factor added to the score.", "type": "integer" }, "description": "Points each match factor added; a full job read carries them, a list row does not.", "type": "object" }, "eligible": { "description": "Whether the user may take this job: work authorization, language and the posting's stated requirements all pass.", "type": "boolean" }, "missing": { "description": "What the assessment could not establish about the user for this posting; a full job read carries it, a list row does not.", "items": { "description": "One fact the assessment could not establish about the user.", "type": "string" }, "type": "array" }, "notes": { "description": "Notes the assessment kept beside the score; a full job read carries them, a list row does not.", "items": { "description": "One note the assessment kept beside the score.", "type": "string" }, "type": "array" }, "reasons": { "description": "Why the job scores what it does, in words.", "items": { "description": "One reason the job scored as it did.", "type": "string" }, "type": "array" }, "score": { "description": "Match score from 0 to 100 against the user's résumé and targets; higher is better.", "type": "integer" } }, "required": [ "eligible", "score", "reasons" ], "type": "object" }, "posted_at": { "description": "When the posting went up, ISO 8601 in UTC, when the catalogue knows it.", "type": [ "string", "null" ] }, "provider": { "description": "The employer's hiring system the posting came from, e.g. workday, greenhouse or ashby.", "type": "string" }, "salary": { "description": "The pay the posting states, or null when it states none.", "properties": { "currency": { "description": "ISO code of the stated pay.", "type": "string" }, "max": { "description": "Highest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "min": { "description": "Lowest amount the posting states, in the currency's units.", "type": [ "number", "null" ] }, "period": { "description": "What the amounts are for (year, month, week, day or hour) when the posting states a period ApplySent recognizes.", "type": [ "string", "null" ] } }, "required": [ "min", "max", "currency", "period" ], "type": [ "object", "null" ] }, "saved": { "description": "Whether the user saved this job.", "type": "boolean" }, "title": { "description": "The posting's title as the employer states it.", "type": "string" } }, "required": [ "id", "match" ], "type": "object" } }, { "description": "Changes only the given notification preferences and returns the saved settings.", "inputSchema": { "additionalProperties": false, "properties": { "idempotency_key": { "description": "Repeating a call with the same key and arguments returns its first result instead of acting again.", "type": "string" }, "notifications": { "additionalProperties": false, "description": "Email and Telegram preferences to change; leave any out to keep it as it is.", "properties": { "application_updates": { "description": "Tell the user when an application changes status.", "type": "boolean" }, "email": { "description": "Deliver notifications by email.", "type": "boolean" }, "failure_alerts": { "description": "Email once when an application is not sent or needs the user, with the reason and what to do.", "type": "boolean" }, "interview_alerts": { "description": "Tell the user when an employer invites them to interview, sends an assessment or makes an offer; these arrive by email even when email is off.", "type": "boolean" }, "job_alerts": { "description": "Tell the user when new roles match the profile.", "type": "boolean" }, "telegram": { "description": "Deliver notifications on Telegram.", "type": "boolean" } }, "type": "object" }, "push": { "additionalProperties": false, "description": "Push categories to change; leave any out to keep it as it is.", "properties": { "application_updates": { "description": "Push when an application is submitted, needs an answer or gets an employer reply.", "type": "boolean" }, "daily_roles": { "description": "Push one summary of the new matching roles each day.", "type": "boolean" }, "reminders": { "description": "Push a nudge when something is waiting on the user.", "type": "boolean" }, "tips_offers": { "description": "Push occasional tips and product news.", "type": "boolean" } }, "type": "object" } }, "required": [], "type": "object" }, "name": "update_notification_settings", "outputSchema": { "properties": { "notifications": { "description": "The email and Telegram notification preferences.", "properties": { "application_updates": { "description": "Whether application status changes are announced.", "type": "boolean" }, "email": { "description": "Whether notifications go out by email.", "type": "boolean" }, "failure_alerts": { "description": "Whether an application that was not sent, or needs the user, is emailed once.", "type": "boolean" }, "interview_alerts": { "description": "Whether interview invitations, assessments and offers are announced.", "type": "boolean" }, "job_alerts": { "description": "Whether new matching roles are announced.", "type": "boolean" }, "telegram": { "description": "Whether notifications go out on Telegram.", "type": "boolean" } }, "required": [ "job_alerts", "application_updates", "interview_alerts", "email", "telegram", "failure_alerts" ], "type": "object" }, "push": { "description": "The push categories, as the app and site show them.", "properties": { "application_updates": { "description": "Whether a push announces an application submitted, needing an answer or answered.", "type": "boolean" }, "daily_roles": { "description": "Whether a daily push summarises the new matching roles.", "type": "boolean" }, "reminders": { "description": "Whether a push nudges when something waits on the user.", "type": "boolean" }, "tips_offers": { "description": "Whether a push carries occasional tips and offers.", "type": "boolean" } }, "required": [ "application_updates", "daily_roles", "reminders", "tips_offers" ], "type": "object" } }, "required": [ "push", "notifications" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:be3e8a5cae057fcdb9e10a156933271dd81a27a69cebe601e966d3891e8d1334 | sha256sum