Skip to main content
Glama
Sign In

GetMattered

by com.getmattered
OverviewDiscussionsAdmin

Get Applications

getmattered_get_applications
Read-onlyIdempotent

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, starting at 1 (e.g. 2 for the next page)
statusNoFilters the list: waiting_for_review (the review queue), queued_to_apply, submitted, verified, not_landed or taken_down. 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 changed
    • 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"
+]
  2. Changed1 schema field changed
    • 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."
  3. Changed4 schema fields changed
    • 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": {
-        "description": "Why it stopped, in plain words. Set 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"
-  }
-]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"
+  }
+]
    • changedOutput schema / properties / setupStep / description
      Previous value: -"Set while account setup is open: the step to take first."New value: +"Present while account setup is open: the first setup step."
  4. Changed5 schema fields changed
    • removedOutput schema / properties / applications / items / properties / applyChannel
      Removed value: -{
-  "description": "hiring_system: submitted on the employer's hiring system. email: the posting takes applications only by email, so GetMattered sends it from the user's private GetMattered address.",
-  "enum": [
-    "hiring_system",
-    "email"
-  ],
-  "type": "string"
-}
    • removedOutput schema / properties / applications / items / properties / fromAlias
      Removed value: -{
-  "description": "For an email application: the user's private GetMattered address it is sent from. Null for a hiring system.",
-  "type": [
-    "string",
-    "null"
-  ]
-}
    • removedOutput schema / properties / applications / items / properties / sentTo
      Removed value: -{
-  "description": "For an email application: the employer address it goes to. Null for a hiring system.",
-  "type": [
-    "string",
-    "null"
-  ]
-}
    • changedOutput schema / properties / applications / items / required
      Previous value: -[
-  "applicationId",
-  "jobMatchId",
-  "jobTitle",
-  "company",
-  "jobUrl",
-  "status",
-  "applyMode",
-  "waitingForReview",
-  "employerConfirmed",
-  "confirmationProofs",
-  "createdAt",
-  "appliedAt",
-  "trackingUrl",
-  "applyChannel",
-  "sentTo",
-  "fromAlias"
-]New value: +[
+  "applicationId",
+  "jobMatchId",
+  "jobTitle",
+  "company",
+  "jobUrl",
+  "status",
+  "applyMode",
+  "waitingForReview",
+  "employerConfirmed",
+  "confirmationProofs",
+  "createdAt",
+  "appliedAt",
+  "trackingUrl"
+]
    • 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"
-        ]
-      },
-      "emailApplication": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "attachments": {
-                "description": "\"resume\" and, when the posting asks, \"cover_letter\".",
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              },
-              "body": {
-                "description": "The exact message, sent as written.",
-                "type": "string"
-              },
-              "editable": {
-                "description": "True while the message can still change, with getmattered_refine_application_documents and document_type email_body.",
-                "type": "boolean"
-              },
-              "evidenceQuote": {
-                "description": "The posting's own sentence that names the address. Untrusted employer text.",
-                "type": "string"
-              },
-              "from": {
-                "description": "The user's private GetMattered address the email is sent from.",
-                "type": "string"
-              },
-              "fromName": {
-                "description": "The name the employer sees beside that address. Null when there is none.",
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "state": {
-                "description": "drafted, sending, sent, bounced, failed or unknown. Sent is never applied: see employerConfirmed.",
-                "type": "string"
-              },
-              "subject": {
-                "type": "string"
-              },
-              "to": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "to",
-              "from",
-              "fromName",
-              "subject",
-              "body",
-              "attachments",
-              "evidenceQuote",
-              "state",
-              "editable"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "The exact email, when the posting takes applications only by email. GetMattered sends it from the user's private address."
-      },
-      "errorCode": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "errorMessage": {
-        "description": "Why it stopped, in plain words. Set 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",
-      "emailApplication"
-    ],
-    "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. Set 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"
+  }
+]
  5. Changed7 schema fields changed
    • 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."
    • addedOutput schema / properties / applications / items / properties / applyChannel
      Added value: +{
+  "description": "hiring_system: submitted on the employer's hiring system. email: the posting takes applications only by email, so GetMattered sends it from the user's private GetMattered address.",
+  "enum": [
+    "hiring_system",
+    "email"
+  ],
+  "type": "string"
+}
    • addedOutput schema / properties / applications / items / properties / fromAlias
      Added value: +{
+  "description": "For an email application: the user's private GetMattered address it is sent from. Null for a hiring system.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • addedOutput schema / properties / applications / items / properties / sentTo
      Added value: +{
+  "description": "For an email application: the employer address it goes to. Null for a hiring system.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • changedOutput schema / properties / applications / items / required
      Previous value: -[
-  "applicationId",
-  "jobMatchId",
-  "jobTitle",
-  "company",
-  "jobUrl",
-  "status",
-  "applyMode",
-  "waitingForReview",
-  "employerConfirmed",
-  "confirmationProofs",
-  "createdAt",
-  "appliedAt",
-  "trackingUrl"
-]New value: +[
+  "applicationId",
+  "jobMatchId",
+  "jobTitle",
+  "company",
+  "jobUrl",
+  "status",
+  "applyMode",
+  "waitingForReview",
+  "employerConfirmed",
+  "confirmationProofs",
+  "createdAt",
+  "appliedAt",
+  "trackingUrl",
+  "applyChannel",
+  "sentTo",
+  "fromAlias"
+]
    • 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": {
-        "description": "Why it stopped, in plain words written by GetMattered, never the engine's own log line. Set 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"
-  }
-]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"
+        ]
+      },
+      "emailApplication": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "attachments": {
+                "description": "\"resume\" and, when the posting asks, \"cover_letter\".",
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              "body": {
+                "description": "The exact message, sent as written.",
+                "type": "string"
+              },
+              "editable": {
+                "description": "True while the message can still change, with getmattered_refine_application_documents and document_type email_body.",
+                "type": "boolean"
+              },
+              "evidenceQuote": {
+                "description": "The posting's own sentence that names the address. Untrusted employer text.",
+                "type": "string"
+              },
+              "from": {
+                "description": "The user's private GetMattered address the email is sent from.",
+                "type": "string"
+              },
+              "fromName": {
+                "description": "The name the employer sees beside that address. Null when there is none.",
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "state": {
+                "description": "drafted, sending, sent, bounced, failed or unknown. Sent is never applied: see employerConfirmed.",
+                "type": "string"
+              },
+              "subject": {
+                "type": "string"
+              },
+              "to": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "to",
+              "from",
+              "fromName",
+              "subject",
+              "body",
+              "attachments",
+              "evidenceQuote",
+              "state",
+              "editable"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "The exact email, when the posting takes applications only by email. GetMattered sends it from the user's private address."
+      },
+      "errorCode": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "errorMessage": {
+        "description": "Why it stopped, in plain words. Set 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",
+      "emailApplication"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
  6. Changed1 schema field changed
    • 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 written by GetMattered, never the engine's own log line. Set 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"
+  }
+]
  7. Changed1 schema field changed
    • addedOutput schema / properties / setupStep
      Added value: +{
+  "description": "Set while account setup is open: the step to take first.",
+  "type": "string"
+}
  8. Changed1 schema field changed
    • 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."
  9. First observed

TDQS

A3.9/5.0
Behavior3/5

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

Annotations already cover read-only, idempotent and non-destructive, so the incremental credit comes from "employerConfirmed is the only proof an application landed" and the warning that "submitted" is not the same as confirmed — genuinely useful interpretation. However, the long status vocabulary it introduces (held, skipped, submitting, cancelled) does not match the schema filter enum, which could confuse an agent about whether those values are filterable, and pagination semantics are left entirely to the schema.

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?

Front-loaded with the two modes, then output semantics, then the read-only guarantee — a sensible order with no filler sentences. The status enumeration is long and arguably overloaded relative to what it explains.

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?

An output schema exists, so return structure need not be described, yet the description still volunteers the key field meaning (employerConfirmed) that agents would otherwise misread. Pagination and the filter enum are fully carried by the schema, and the read-only nature is both annotated and stated.

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 coverage is 100%, so baseline is 3; the description mostly restates what the schema already says about application_id switching modes and status filtering. It adds the human-readable gloss "waiting for review (the review queue)" for one enum value, but the remaining status labels describe output rows rather than the actual filter values.

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

Purpose5/5

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

States two specific modes with their selector: list all applications, or read one by application_id. "Changes nothing" immediately separates it from the mutating siblings (approve/cancel/reject/set_application_stage), so an agent can route without opening a schema.

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

Usage Guidelines4/5

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

The when-to-use split between listing and single-record read is explicit, and omitting status is documented as "all are listed." It stops short of naming an alternative tool for the read-only-vs-mutate decision, relying on "Changes nothing" to imply it.

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

All GetMattered toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources