Rename a saved search or replace its parameters
saved_search_updateRename a saved search or replace its parameters. THIS WRITES.
Same call over REST
Saved searches update/v1/saved-searches/{search_id}Not connected yet? Connect your assistant. Sign in with your MarketCode account; no API key needed.
Reference
What saved_search_update answers
params is REPLACED, not merged. Send the complete argument object you want stored — sending only the keys you are changing will DROP the rest, and a saved search that quietly lost a filter is worse than one that has to be restated. Read the current values with saved_search_list first.
UK only.
Inputs
Arguments saved_search_update takes
| Name | Type | Required | Description |
|---|---|---|---|
| search_id | string | Yes | |
| name | string | No | |
| params | object | No | |
| description | string | No |
Usage
How to run saved_search_update in your assistant
Ask your assistant in plain English, for example:
"Use the MarketCode tool saved_search_update for <address or area>.
Show the result and the credits charged."The connect steps for Claude, ChatGPT, Codex, Cursor and Claude Code are on the MCP page.
Price and licence
What it costs, and where the data comes from
saved_search_update is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
Credits are granted on sign-up and bought in packs; the pricing page lists every call.
Related
Tools used with saved_search_update
- List saved searchesFree
saved_search_listEvery saved search on this account, newest first, with each one's tool, stored parameters, run count and change-feed cursor. Free, and read-only.Named in the description - Save a named searchFree
saved_search_createSave a named search so it can be re-run later. THIS WRITES: it creates something on the user's account. Say what you are about to save and confirm the name before calling it.Same category - Delete a saved searchFree
saved_search_deleteDelete a saved search. THIS WRITES AND IS IRREVERSIBLE — there is no undo and no archive. Confirm with the user, by NAME rather than by id, before calling it.Same category - Run a saved search now8 credits
saved_search_runRun a saved search now and return its rows.Same category
FAQ
Questions about saved_search_update
How much does `saved_search_update` cost?
+
saved_search_update is free over MCP and over REST, and the two surfaces share one credit balance. Free calls need a signed-in account or an API key and appear in your usage, but they never touch your balance.
Which assistants can run `saved_search_update`?
+
Any MCP client: Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT in developer mode, Codex and Cursor, each documented on the MCP page. You sign in with your MarketCode account over OAuth; there is no key to paste, and the connection is read-only.
Where does the data come from?
+
The answer is computed by MarketCode. Coverage is the UK.
Try saved_search_update in your assistant.
30-minute call. We'll connect your assistant live on a real address.