Skip to main content
Glama
Sign In

GetMattered

by com.getmattered
OverviewDiscussionsAdmin

Get Account

getmattered_get_account
Read-onlyIdempotent

Reads the signed-in user's account id, display name and sign-in email, plan, token balance, applications left, job preferences and readiness: whether a resume and target roles are on file. The answer names empty profile fields to add once. 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_account"
  }
}

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault
planYes
accountYesWho this connection is signed in as. With several GetMattered connections, an action belongs to the account the user names.
resumesYes
autopilotYesWhether GetMattered applies on its own. It comes from the Auto Apply settings.
readinessYes
setupStepNoPresent while account setup is open: the first setup step.
billingUrlYes
preferencesYes
applicationsYes
integrationsYesWhich outside accounts are connected. Null when it could not be read.
tokenBalanceYes
defaultApplyModeYesWhat getmattered_apply does when mode is omitted. It comes from the Auto Apply settings.
freeApplicationsYes
mcpFreeApplicationsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed9 schema fields changed
    • changedOutput schema / properties / account / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "email": {
-        "description": "The address the account signs in with.",
-        "type": "string"
-      },
-      "id": {
-        "description": "The GetMattered user id. Stable: the same account always has the same id.",
-        "type": "string"
-      },
-      "name": {
-        "description": "The display name on the account, when one is set.",
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "id",
-      "name",
-      "email"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "email": {
+        "description": "The address the account signs in with.",
+        "type": "string"
+      },
+      "id": {
+        "description": "The GetMattered user id. Stable: one account keeps one id.",
+        "type": "string"
+      },
+      "name": {
+        "description": "The display name on the account, when one is set.",
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "id",
+      "name",
+      "email"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedOutput schema / properties / account / description
      Previous value: -"Who this connection is signed in as. Name it to the user before acting when more than one GetMattered account is connected."New value: +"Who this connection is signed in as. With several GetMattered connections, an action belongs to the account the user names."
    • changedOutput schema / properties / autopilot / description
      Previous value: -"Whether GetMattered applies on its own. Read only."New value: +"Whether GetMattered applies on its own. It comes from the Auto Apply settings."
    • changedOutput schema / properties / defaultApplyMode / description
      Previous value: -"What getmattered_apply does when mode is omitted. Read only."New value: +"What getmattered_apply does when mode is omitted. It comes from the Auto Apply settings."
    • changedOutput schema / properties / readiness / properties / askUserFor / description
      Previous value: -"The one thing to ask the user for next: resume or target_roles. Null when nothing is missing."New value: +"The one thing the account needs from the user next: resume or target_roles. Null when nothing is missing."
    • changedOutput schema / properties / readiness / properties / nextStep / description
      Previous value: -"The instruction for askUserFor, or the applications waiting for review, ready to follow. Null when nothing is open."New value: +"The next step for askUserFor, or the applications waiting for review. Null when nothing is open."
    • changedOutput schema / properties / readiness / properties / resumeOnFile / description
      Previous value: -"False means apply will fail: call getmattered_set_resume first."New value: +"False means getmattered_apply has no resume to send; getmattered_set_resume adds one."
    • changedOutput schema / properties / resumes / anyOf
      Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "id": {
-          "description": "Pass to getmattered_set_resume as document_id to make it the base resume.",
-          "type": "number"
-        },
-        "isBase": {
-          "type": "boolean"
-        },
-        "title": {
-          "type": "string"
-        },
-        "updatedAt": {
-          "type": [
-            "string",
-            "null"
-          ]
-        }
-      },
-      "required": [
-        "id",
-        "title",
-        "isBase",
-        "updatedAt"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "id": {
+          "description": "The document_id getmattered_set_resume takes to make this the base resume.",
+          "type": "number"
+        },
+        "isBase": {
+          "type": "boolean"
+        },
+        "title": {
+          "type": "string"
+        },
+        "updatedAt": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "title",
+        "isBase",
+        "updatedAt"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "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."
  2. Changed1 schema field changed
    • changedOutput schema / properties / readiness / properties / missingRequiredForApply / description
      Previous value: -"Profile fields employer forms can require that are empty. GetMattered fills address fields from the user's saved address and location. With gap filling on, it also fills an empty postal code. With gap filling off, a form that requires a postal code is not sent until the profile has one. An empty state or country never stops a form. The user adds each field once on the profile. Never ask for them per application."New value: +"Profile fields employer forms can require that are empty. GetMattered fills address fields from the user's saved address and location. With gap filling on, it also fills an empty postal code. With gap filling off, a form that requires a postal code is not sent until the profile has one. An empty state or country never stops a form. The user adds each field once on the profile, not per application."
  3. Changed1 schema field changed
    • changedOutput schema / properties / mcpFreeApplications / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "limit": {
-        "type": "number"
-      },
-      "remaining": {
-        "type": "number"
-      },
-      "used": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "used",
-      "limit",
-      "remaining"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "available": {
+        "type": [
+          "boolean",
+          "null"
+        ]
+      },
+      "limit": {
+        "type": "number"
+      },
+      "remaining": {
+        "type": "number"
+      },
+      "used": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "used",
+      "limit",
+      "remaining"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
  4. Changed1 schema field changed
    • changedOutput schema / properties / readiness / properties / missingRequiredForApply / description
      Previous value: -"Profile fields employer forms require that are empty. They are filled automatically while gap filling is on, and the user can add real values later."New value: +"Profile fields employer forms can require that are empty. GetMattered fills address fields from the user's saved address and location. With gap filling on, it also fills an empty postal code. With gap filling off, a form that requires a postal code is not sent until the profile has one. An empty state or country never stops a form. The user adds each field once on the profile. Never ask for them per application."
  5. Changed5 schema fields changed
    • changedOutput schema / properties / readiness / properties / askUserFor / anyOf
      Previous value: -[
-  {
-    "enum": [
-      "resume",
-      "target_roles",
-      "apply_fields"
-    ],
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "enum": [
+      "resume",
+      "target_roles"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedOutput schema / properties / readiness / properties / askUserFor / description
      Previous value: -"The one thing to ask the user for next: resume, target_roles or apply_fields. Null when nothing is missing."New value: +"The one thing to ask the user for next: resume or target_roles. Null when nothing is missing."
    • changedOutput schema / properties / readiness / properties / missingRequiredForApply / description
      Previous value: -"Profile fields employer forms require that are empty. Ask the user; never guess."New value: +"Profile fields employer forms require that are empty. They are filled automatically while gap filling is on, and the user can add real values later."
    • changedOutput schema / properties / readiness / properties / nextStep / description
      Previous value: -"The instruction for askUserFor, ready to follow. Null when nothing is missing."New value: +"The instruction for askUserFor, or the applications waiting for review, ready to follow. Null when nothing is open."
    • addedOutput schema / properties / setupStep
      Added value: +{
+  "description": "Set while account setup is open: the step to take first.",
+  "type": "string"
+}
  6. Changed2 schema fields changed
    • addedOutput schema / properties / mcpFreeApplications
      Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "limit": {
+          "type": "number"
+        },
+        "remaining": {
+          "type": "number"
+        },
+        "used": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "used",
+        "limit",
+        "remaining"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}
    • changedOutput schema / required
      Previous value: -[
-  "account",
-  "plan",
-  "tokenBalance",
-  "applications",
-  "freeApplications",
-  "preferences",
-  "readiness",
-  "resumes",
-  "defaultApplyMode",
-  "autopilot",
-  "billingUrl",
-  "integrations"
-]New value: +[
+  "account",
+  "plan",
+  "tokenBalance",
+  "applications",
+  "freeApplications",
+  "mcpFreeApplications",
+  "preferences",
+  "readiness",
+  "resumes",
+  "defaultApplyMode",
+  "autopilot",
+  "billingUrl",
+  "integrations"
+]
  7. Changed5 schema fields changed
    • addedOutput schema / properties / account
      Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "email": {
+          "description": "The address the account signs in with.",
+          "type": "string"
+        },
+        "id": {
+          "description": "The GetMattered user id. Stable: the same account always has the same id.",
+          "type": "string"
+        },
+        "name": {
+          "description": "The display name on the account, when one is set.",
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "id",
+        "name",
+        "email"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Who this connection is signed in as. Name it to the user before acting when more than one GetMattered account is connected."
+}
    • addedOutput schema / properties / readiness / properties / askUserFor
      Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "resume",
+        "target_roles",
+        "apply_fields"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "The one thing to ask the user for next: resume, target_roles or apply_fields. Null when nothing is missing."
+}
    • addedOutput schema / properties / readiness / properties / nextStep
      Added value: +{
+  "description": "The instruction for askUserFor, ready to follow. Null when nothing is missing.",
+  "type": [
+    "string",
+    "null"
+  ]
+}
    • changedOutput schema / properties / readiness / required
      Previous value: -[
-  "resumeOnFile",
-  "onboardingComplete",
-  "missingRequiredForApply"
-]New value: +[
+  "resumeOnFile",
+  "onboardingComplete",
+  "missingRequiredForApply",
+  "askUserFor",
+  "nextStep"
+]
    • changedOutput schema / required
      Previous value: -[
-  "plan",
-  "tokenBalance",
-  "applications",
-  "freeApplications",
-  "preferences",
-  "readiness",
-  "resumes",
-  "defaultApplyMode",
-  "autopilot",
-  "billingUrl",
-  "integrations"
-]New value: +[
+  "account",
+  "plan",
+  "tokenBalance",
+  "applications",
+  "freeApplications",
+  "preferences",
+  "readiness",
+  "resumes",
+  "defaultApplyMode",
+  "autopilot",
+  "billingUrl",
+  "integrations"
+]
  8. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive), yet the description adds a non-obvious output behavior: the answer names empty profile fields to add, and it defines what 'readiness' means (resume and target roles on file). 'Changes nothing' reinforces rather than contradicts readOnlyHint. Given a published output schema, this is a solid contribution beyond structured fields.

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?

Two sentences, front-loaded with the verb and resource, then the derived 'readiness' semantics and the onboarding hint. The long field enumeration is dense but each item is informative. Slightly heavy for a no-parameter read, but nothing is truly wasted.

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 zero parameters, full annotation coverage and an output schema, the description carries the right burden: what the account view contains and what 'readiness' means. The only missing piece is routing guidance against the many sibling read tools, which keeps it off a 5.

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

Parameters4/5

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

The tool takes zero parameters, so there is nothing for the description to disambiguate and the baseline of 4 applies. The description correctly implies no scoping input is needed — it operates on the signed-in user.

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?

Specific verb plus resource ("Reads the signed-in user's account") followed by an explicit enumeration of returned fields — id, display name, sign-in email, plan, token balance, applications left, job preferences, readiness. That is far more than a restatement of the name. It never distinguishes itself from near-neighbours like get_profile or get_application_profile, so an agent must infer that this is the account/plan-level view rather than a job-application profile.

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 only implied: the mention of readiness and empty profile fields signals this is the check-before-onboarding or check-quota call, but the description never says when to prefer it over get_profile or update_job_preferences. There are no exclusions or named alternatives among the ~35 siblings, which is the main gap given how many similarly named 'get_*' tools exist.

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