AgentGraph AI · MCP tool
agentgraph_save_to_watchlist
Save to watchlist
Writes dataIdempotent6 parameters
Over REST: no operation in the public API description does this. MCP and REST compared.
Description
Saves agencies or agents (ids from a screen) to your organisation's shared watchlist, each measured in the area you give. AgentGraph AI re-measures the list every day and records changes: priority or profile changes, momentum turning against the area, more price cuts, slower exits, stock falling, an agent listing under a new agency, or no new listings for 60 days. Up to 200 entries.
Parameters
idsstring[]requiredIds from screen_agencies, screen_agents or a profile.
1–50 items
locationstring | integerA German city, district or state by name ("München", "Hamburg-Altona", "Bayern") or a location id from find_location. A 5-digit value is read as a postcode.
zipcodesstring[]Limit to these postcodes (with or without a location).
at most 200 itemspattern
^\d{5}$operationstringSales listings (default) or rentals.
sale rentdefault "sale"
labelstringAn optional note shown with the entry, e.g. 'Q4 outreach'.
at most 60 characters
client_brandstringYour own network's name, if you are one. Its offices and agents are not offered as matches from "another network's franchise".
Example call
Required arguments only, with placeholder values. Your assistant fills them in from the parameters above.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "agentgraph_save_to_watchlist",
"arguments": {
"ids": [
"…"
]
}
}
}