Save a named search
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 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_create answers
tool is the search to replay — sourcing_search, sourcing_live_listings, sourcing_offmarket_owners, sourcing_commercial or changes_since — and params is that tool's own argument object, stored exactly as given and replayed exactly as given. Run the search once first and save the arguments that actually worked, rather than saving a guess.
Saving is FREE and costs nothing while it merely exists. Only saved_search_run spends credits, and it spends what the underlying search would have cost.
Names are unique per account: a clash is refused rather than silently overwriting the existing search. UK only.
Inputs
Arguments saved_search_create takes
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | |
| tool | string | Yes | |
| params | object | No | |
| description | string | No |
Usage
How to run saved_search_create in your assistant
Ask your assistant in plain English, for example:
"Use the MarketCode tool saved_search_create 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_create 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_create
- Search land or units by criteria8 credits
sourcing_searchFind land parcels or residential units matching investment criteria — the sourcing tool. Give a `location` (place or area name) or a `bbox`.Named in the description - Live listings enriched against our valuation2 credits
sourcing_live_listingsWhat is on the market RIGHT NOW in these postcode districts, each listing enriched against our own record of the property: asking price against our valuation (`asking_vs_avm_pct`, `discount_to_avm_gbp`), £/m², gross yield on both the asking and valuation bases, unexpired lease years, EPC with its retrofit gap, the designation flags, days listed, the agent, and a plain-language `signals` list.Named in the description - Owners in an area, ranked as an approach list2 credits
sourcing_offmarket_ownersWho owns the stock in an area, ranked as an approach list: units held here, total value and equity, average and longest years held, how many of their units are on a short lease or already on the market, company status, and the signals behind the rank. Pass a `strategy` to rank the owners of only the units that preset points at — the owners of short-lease flats in a borough, say.Named in the description - Rated commercial stock in an authority2 credits
sourcing_commercialRated commercial stock in a local authority, filtered by sector and rateable value — the commercial sourcing lane. Each row carries its rateable value, an income-basis value, the freeholder where a title links, and any auction history.Named in the description - What changed since your cursor1 credit
changes_sinceWhat changed since you last looked — the portal change feed. Pass the `next_cursor` from your previous call to get only what is new; on a first call give a scope (`postcode_districts` or `uprns`) or a `since` date, because an unbounded read of a 14.6-million-row feed is refused.Named in the description - Run a saved search now8 credits
saved_search_runRun a saved search now and return its rows.Named in the description
FAQ
Questions about saved_search_create
How much does `saved_search_create` cost?
+
saved_search_create 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_create`?
+
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_create in your assistant.
30-minute call. We'll connect your assistant live on a real address.