GetMattered

Save Current Search

getmattered_create_saved_search

Saves the current preferences as a named search, with optional email alerts.

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_create_saved_search"
  }
}

Input Schema

Name	Required	Description	Default
`name`	No	The name of the new search, up to 120 characters. Without one, it is named after the first role and location.
`alerts_enabled`	No	true emails the user new matches for this search, false stops the emails.

Output Schema

Name	Required	Description
`saved`	Yes	From getmattered_create_saved_search or getmattered_update_saved_search: the search after the change.
`action`	Yes	The operation that ran, one of list, save, update or delete.
`searches`	Yes	From getmattered_list_saved_searches: every saved search.
`deletedId`	Yes	From getmattered_delete_saved_search: the search that was deleted.
`setupStep`	No	Present while account setup is open: the first setup step.

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedNov 8, 2026

changedOutput schema / properties / action / description

Previous value: -"The operation that ran: list, save, update or delete."New value: +"The operation that ran, one of list, save, update or delete."

changedOutput schema / properties / saved / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "alertsEnabled": {
-        "description": "True when new matches for this search are emailed to the user.",
-        "type": "boolean"
-      },
-      "createdAt": {
-        "type": "string"
-      },
-      "lastAlertedAt": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "locations": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "name": {
-        "type": "string"
-      },
-      "savedSearchId": {
-        "description": "Pass as saved_search_id to getmattered_update_saved_search or getmattered_delete_saved_search.",
-        "type": "number"
-      },
-      "targetRoles": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "savedSearchId",
-      "name",
-      "alertsEnabled",
-      "targetRoles",
-      "locations",
-      "createdAt",
-      "lastAlertedAt"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "alertsEnabled": {
+        "description": "True when new matches for this search are emailed to the user.",
+        "type": "boolean"
+      },
+      "createdAt": {
+        "type": "string"
+      },
+      "lastAlertedAt": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "locations": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "name": {
+        "type": "string"
+      },
+      "savedSearchId": {
+        "description": "The saved_search_id getmattered_update_saved_search and getmattered_delete_saved_search take.",
+        "type": "number"
+      },
+      "targetRoles": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "savedSearchId",
+      "name",
+      "alertsEnabled",
+      "targetRoles",
+      "locations",
+      "createdAt",
+      "lastAlertedAt"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / searches / anyOf

Previous value: -[
-  {
-    "items": {
-      "additionalProperties": false,
-      "properties": {
-        "alertsEnabled": {
-          "description": "True when new matches for this search are emailed to the user.",
-          "type": "boolean"
-        },
-        "createdAt": {
-          "type": "string"
-        },
-        "lastAlertedAt": {
-          "type": [
-            "string",
-            "null"
-          ]
-        },
-        "locations": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        },
-        "name": {
-          "type": "string"
-        },
-        "savedSearchId": {
-          "description": "Pass as saved_search_id to getmattered_update_saved_search or getmattered_delete_saved_search.",
-          "type": "number"
-        },
-        "targetRoles": {
-          "items": {
-            "type": "string"
-          },
-          "type": "array"
-        }
-      },
-      "required": [
-        "savedSearchId",
-        "name",
-        "alertsEnabled",
-        "targetRoles",
-        "locations",
-        "createdAt",
-        "lastAlertedAt"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "alertsEnabled": {
+          "description": "True when new matches for this search are emailed to the user.",
+          "type": "boolean"
+        },
+        "createdAt": {
+          "type": "string"
+        },
+        "lastAlertedAt": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "locations": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "name": {
+          "type": "string"
+        },
+        "savedSearchId": {
+          "description": "The saved_search_id getmattered_update_saved_search and getmattered_delete_saved_search take.",
+          "type": "number"
+        },
+        "targetRoles": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "savedSearchId",
+        "name",
+        "alertsEnabled",
+        "targetRoles",
+        "locations",
+        "createdAt",
+        "lastAlertedAt"
+      ],
+      "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."

Changed1 schema field changedNov 6, 2026

addedOutput schema / properties / setupStep

Added value: +{
+  "description": "Set while account setup is open: the step to take first.",
+  "type": "string"
+}

AddedOct 25, 2026

TDQS

B3.2/5.0

Behavior3/5

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

The annotations already declare this is a non-readonly, non-destructive, non-idempotent mutation, so the safety profile is covered. The description adds that it snapshots 'current preferences,' which is real behavioral context, but it omits what happens on repeated calls (idempotentHint=false implies duplicate searches), what happens if no preferences exist, and any naming-collision behavior.

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?

A single front-loaded sentence with no filler, and the core action comes first followed by the optional alert capability. Its brevity is efficient, though it leaves little room for the routing and precondition details noted elsewhere.

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

Completeness3/5

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

With only two optional parameters, full schema coverage, annotations, and an output schema, the description is adequate to call the tool correctly. It is not sufficient to decide between saving a new search and updating an existing one, and it doesn't clarify what 'current preferences' refers to or that repeated calls create separate searches.

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 both 'name' and 'alerts_enabled' are fully documented in the schema, including the auto-naming fallback and character limit. The description only restates 'named search' and 'optional email alerts,' adding no syntax or semantics beyond the schema, so the baseline of 3 applies.

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 gives a specific verb and resource ('Saves ... as a named search') plus the optional alert behavior, so the agent knows this creates a saved search from existing state. It does not name the sibling update_saved_search or list_saved_searches, so the create-vs-modify distinction has to be inferred from the tool name.

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?

There is no guidance on when to use this versus getmattered_update_saved_search or getmattered_list_saved_searches, and no mention of prerequisites such as having current preferences set before saving. The agent must infer the create/modify split from naming alone.

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

All GetMattered tools Inspect

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.