Skip to main content
Glama

Get Applications

getmattered_get_applications
Read-onlyIdempotent

Lists job applications with statuses or reads one by application ID. Use it to track progress and check employer confirmation without changing any data.

Instructions

Tracks the user's job applications: lists each one and where it stands, or reads one by application_id. Each row's status is queued, waiting for review (the review queue), held, submitting, submitted, submitted but not confirmed, skipped, not submitted or cancelled. employerConfirmed is the only proof an application landed. Changes nothing.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "getmattered_get_applications"
  }
}

Input Schema

NameRequiredDescriptionDefault
pageNoPage number, from 1.
statusNoFilters the list. waiting_for_review is the review queue. Left out, all are listed.
application_idNoOne application to read, by its id (e.g. 1550). Left out, the tool lists applications.

Output Schema

NameRequiredDescriptionDefault
keptYesJobs on the user's GetMattered board that GetMattered has not sent, on the first unfiltered page. They are left out of applications and totalApplications.
pageYes
detailYesFilled when one application_id was read: what will be or was sent.
setupStepNoPresent while account setup is open: the first setup step.
totalPagesYes
applicationsYes
totalApplicationsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv1.20.1
    • changedInput schema / properties / page / description
      Previous value: -"Page number, starting at 1 (e.g. 2 for the next page)"New value: +"Page number, from 1."
    • changedInput schema / properties / status / description
      Previous value: -"Filters the list: waiting_for_review (the review queue), queued_to_apply, submitted, verified, not_landed or taken_down. Left out, all are listed."New value: +"Filters the list. waiting_for_review is the review queue. Left out, all are listed."
  2. Changed2 schema fields changedv1.18.0
    • addedOutput schema / properties / kept
      Added value: +{
      +  "default": [],
      +  "description": "Jobs on the user's GetMattered board that GetMattered has not sent, on the first unfiltered page. They are left out of applications and totalApplications.",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "company": {
      +        "type": "string"
      +      },
      +      "jobListingId": {
      +        "description": "The kept job on the user's GetMattered board.",
      +        "type": "number"
      +      },
      +      "jobTitle": {
      +        "type": "string"
      +      },
      +      "phase": {
      +        "description": "watching: GetMattered watches for a way to send it. ready: it can be sent now, through readyUrl. cannot_send: GetMattered cannot send it, because the employer takes it on a board GetMattered does not send on, the posting closed, or the watch ended. confirmed: the employer confirmed an application for it.",
      +        "enum": [
      +          "watching",
      +          "ready",
      +          "cannot_send",
      +          "confirmed"
      +        ],
      +        "type": "string"
      +      },
      +      "readyUrl": {
      +        "description": "The employer's own posting, which getmattered_apply takes as job_url, when phase is ready. Null in every other phase.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "status": {
      +        "const": "kept",
      +        "description": "GetMattered has not sent this job.",
      +        "type": "string"
      +      },
      +      "trackingUrl": {
      +        "description": "The job's page on the user's GetMattered board.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "jobListingId",
      +      "jobTitle",
      +      "company",
      +      "status",
      +      "phase",
      +      "readyUrl",
      +      "trackingUrl"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "applications",
      -  "page",
      -  "totalPages",
      -  "totalApplications",
      -  "detail"
      -]New value: +[
      +  "applications",
      +  "page",
      +  "totalPages",
      +  "totalApplications",
      +  "detail",
      +  "kept"
      +]
  3. Changed1 schema field changedv1.17.1
    • changedOutput schema / properties / applications / items / properties / status / description
      Previous value: -"Our own record of the application, which is not proof the employer received it. employerConfirmed holds that proof."New value: +"Our own record of the application, which is not proof the employer received it. employerConfirmed holds that proof. One of pending (queued), waiting_for_review, held, ready_to_submit, applied, applied_unconfirmed, skipped, error (not submitted) or cancelled."
  4. Changed6 schema fields changedv1.13.2
    • changedInput schema / properties / application_id / description
      Previous value: -"Read one application by its id (e.g. 1550). Omit to list applications."New value: +"One application to read, by its id (e.g. 1550). Left out, the tool lists applications."
    • changedInput schema / properties / status / description
      Previous value: -"Filter the list: waiting_for_review (the review queue), queued_to_apply, submitted, verified, not_landed or taken_down. Omit for all."New value: +"Filters the list: waiting_for_review (the review queue), queued_to_apply, submitted, verified, not_landed or taken_down. Left out, all are listed."
    • changedOutput schema / properties / applications / items / properties / applicationId / description
      Previous value: -"Pass to getmattered_approve_applications, getmattered_reject_applications or back to getmattered_get_applications."New value: +"The id getmattered_approve_applications, getmattered_reject_applications and getmattered_get_applications take."
    • changedOutput schema / properties / applications / items / properties / status / description
      Previous value: -"Our own record of the application. Never proof the employer received it; see employerConfirmed."New value: +"Our own record of the application, which is not proof the employer received it. employerConfirmed holds that proof."
    • changedOutput schema / properties / detail / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "applicationId": {
      -        "type": "number"
      -      },
      -      "autoRetryStopped": {
      -        "type": [
      -          "boolean",
      -          "null"
      -        ]
      -      },
      -      "confirmationScreenshotAttached": {
      -        "description": "True when the employer's verified confirmation page is attached as an image.",
      -        "type": "boolean"
      -      },
      -      "contentLocked": {
      -        "description": "True when the resume and cover letter are a preview and the full text needs a plan.",
      -        "type": "boolean"
      -      },
      -      "coverLetter": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "documentsUrl": {
      -        "description": "Dashboard page where the user downloads the tailored resume and cover letter as PDF files. Null when neither document is ready, or when the full text needs a plan.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "errorCode": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "errorMessage": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "jobListingId": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "nextAutoRetryAt": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "queueEtaMinutes": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "queuePosition": {
      -        "type": [
      -          "number",
      -          "null"
      -        ]
      -      },
      -      "screeningAnswers": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "answer": {
      -              "type": "string"
      -            },
      -            "question": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "question",
      -            "answer"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "statusCode": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "statusLabel": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "tailoredResume": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "applicationId",
      -      "jobListingId",
      -      "tailoredResume",
      -      "coverLetter",
      -      "contentLocked",
      -      "screeningAnswers",
      -      "statusCode",
      -      "statusLabel",
      -      "errorCode",
      -      "errorMessage",
      -      "autoRetryStopped",
      -      "nextAutoRetryAt",
      -      "queuePosition",
      -      "queueEtaMinutes",
      -      "confirmationScreenshotAttached",
      -      "documentsUrl"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "applicationId": {
      +        "type": "number"
      +      },
      +      "autoRetryStopped": {
      +        "type": [
      +          "boolean",
      +          "null"
      +        ]
      +      },
      +      "confirmationScreenshotAttached": {
      +        "description": "True when the employer's verified confirmation page is attached as an image.",
      +        "type": "boolean"
      +      },
      +      "contentLocked": {
      +        "description": "True when the resume and cover letter are a preview and the full text needs a plan.",
      +        "type": "boolean"
      +      },
      +      "coverLetter": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "documentsUrl": {
      +        "description": "Dashboard page where the user downloads the tailored resume and cover letter as PDF files. Null when neither document is ready, or when the full text needs a plan.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "errorCode": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "errorMessage": {
      +        "description": "Why it stopped, in plain words. Filled whenever the row records a failure.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "jobListingId": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "nextAutoRetryAt": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "queueEtaMinutes": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "queuePosition": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "screeningAnswers": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "answer": {
      +              "type": "string"
      +            },
      +            "question": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "question",
      +            "answer"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "statusCode": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "statusLabel": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "tailoredResume": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "applicationId",
      +      "jobListingId",
      +      "tailoredResume",
      +      "coverLetter",
      +      "contentLocked",
      +      "screeningAnswers",
      +      "statusCode",
      +      "statusLabel",
      +      "errorCode",
      +      "errorMessage",
      +      "autoRetryStopped",
      +      "nextAutoRetryAt",
      +      "queuePosition",
      +      "queueEtaMinutes",
      +      "confirmationScreenshotAttached",
      +      "documentsUrl"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / properties / setupStep
      Added value: +{
      +  "description": "Present while account setup is open: the first setup step.",
      +  "type": "string"
      +}
  5. Changed1 schema field changedv1.10.2
    • changedOutput schema / properties / applications / items / properties / applicationId / description
      Previous value: -"Pass to getmattered_review_application or back to getmattered_get_applications."New value: +"Pass to getmattered_approve_applications, getmattered_reject_applications or back to getmattered_get_applications."
  6. Addedv1.9.1

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, idempotentHint=true, destructiveHint=false and openWorldHint=false, so the safety profile is covered; the trailing 'Changes nothing.' merely reinforces that. The description does add value the annotations cannot: status lifecycle semantics and the trust signal that 'employerConfirmed is the only proof an application landed,' which tells an agent how to interpret results. That said, the prose status vocabulary (held, submitting, skipped, not submitted) does not match the schema enum values, which weakens the behavioral picture slightly.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded in the first clause, and the remaining sentences carry real content (status meanings, employerConfirmed, no mutation). The middle status enumeration is long and could have been left to the schema enum, and 'Changes nothing.' duplicates the annotation, but there is little outright waste.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return values need not be explained, and all three parameters are optional. The description covers the list-vs-single duality and result interpretation, which is what an agent needs to call it correctly. The one loose end is the mismatch between prose status labels and the schema enum, which leaves the filterable values slightly ambiguous.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents page, status (with enum) and application_id (including the list-vs-single behavior), making 3 the baseline. The description adds no syntax, default, or paging detail beyond that, and its free-text status names do not align with the enum literals, so it does not improve on the schema here.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a concrete verb+resource pair ('Tracks the user's job applications') and immediately splits the two modes: 'lists each one and where it stands, or reads one by application_id.' That is enough to tell list from single-record read. It does not differentiate this tool from nearby read siblings or state which one an agent should prefer, so it stops short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied by the two modes and the note that waiting_for_review 'is the review queue,' which helps an agent pick a status filter. There is no explicit when-to-use versus alternatives guidance, no exclusion conditions, and no mention of when a single-application read is preferable over a filtered list. Adequate but clearly gapped.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.