Skip to main content
Glama
Sign In

GetMattered

by com.getmattered
OverviewDiscussionsAdmin

Save Job Matches

getmattered_save_matches
Idempotent

Saves matches for later. Nothing is sent or spent.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "job_match_ids": "<job_match_ids>"
    },
    "name": "getmattered_save_matches"
  }
}

Input Schema

NameRequiredDescriptionDefault
job_match_idsYesJob match ids from getmattered_get_matches, 1 to 25 (e.g. [48213, 48214]).

Output Schema

NameRequiredDescriptionDefault
actionYesThe operation that ran, one of save, skip, unsave or restore.
resultsYes
attemptedYes
setupStepNoPresent while account setup is open: the first setup step.
succeededYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedOutput schema / properties / action / description
      Previous value: -"The operation that ran: save, skip, unsave or restore."New value: +"The operation that ran, one of save, skip, unsave or restore."
    • 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
    • addedOutput schema / properties / setupStep
      Added value: +{
+  "description": "Set while account setup is open: the step to take first.",
+  "type": "string"
+}
  3. Added

TDQS

B3.4/5.0
Behavior3/5

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

The annotations already declare readOnlyHint=false, idempotentHint=true, destructiveHint=false, and openWorldHint=false. The description adds that 'Nothing is sent or spent,' which usefully clarifies there are no external messages or costs, but it does not elaborate on idempotency, permissions, or what exactly is persisted.

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

Conciseness5/5

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

The description is two short sentences with no wasted words. The core action is front-loaded, and the reassurance about no sending or spending is brief and relevant.

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?

For a simple one-parameter mutation with rich annotations and an output schema, the description covers the essential purpose and adds a useful side-effect clarification. It does not explain when to choose this over related save/unsave/restore tools, but the structured fields carry most of the remaining burden.

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%, and the single parameter job_match_ids is fully documented in the schema with its source, allowed count, and an example. The description adds no additional parameter meaning beyond what the schema already provides, so the baseline of 3 is appropriate.

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 states a specific verb and resource: 'Saves matches for later.' This clearly identifies the operation as saving job matches. It does not explicitly distinguish the tool from siblings like getmattered_unsave_matches or getmattered_restore_matches, so it falls 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 Guidelines2/5

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

The description offers no guidance on when to use this tool versus alternatives such as getmattered_unsave_matches, getmattered_restore_matches, or getmattered_skip_matches. 'For later' implies saving, but there are no explicit when-to-use or when-not-to-use conditions.

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