agencygraph_screen_agencies

Screen agencies by the measures

Read-only25 parameters

Call as agencygraph_screen_agencies on the AgencyGraph MCP server, https://platform.casafari.com/mcp/agencygraph (how to connect).

Over REST: POST /v1/agencygraph/{country}/screen (equivalent).

What does Screen agencies by the measures do?

Filters agencies, one row per agency and town, in the whole country, in up to 20 towns or in up to 20 regions (an autonomous community or a province in Spain, a district in Portugal), by ranges of the measures (portfolio value, share, price cut share, days on the market, overpricing), size, network or independence, property type, CRM vendor (crm) and MLS status (mls), sorted as you ask, with each row's measures, growth and the crm and mls estimates (known for about 30% of firms with 10 or more homes for sale). For recruitment, partners or agencies growing in an area. Pages of up to 25 rows; total counts the agency and town rows, agencies the distinct firms.

Which parameters does `agencygraph_screen_agencies` take?

countrystringrequired

Country code: ES or PT.

ES PT

location_idsinteger[]

Optional: up to 20 towns (location ids from locations_search); without, the whole country.

at most 20 items≥ 1

regionsinteger[]

Optional: up to 20 regions (location ids from locations_search): in Spain an autonomous community or a province, in Portugal a district. Only towns inside them; with location_ids, towns that are in both.

at most 20 items≥ 1

type_groupstring

Property type group: all (default), apartment or house.

all apartment house

default "all"

operationstring

sale (default): homes for sale. Rentals are not measured yet.

sale

default "sale"

sortstring

The measure to sort by.

portfolio_value properties share median_price price_per_sqm price_cut_share days_on_market overpricing

default "portfolio_value"

orderstring

asc or desc; default the measure's natural order (fewest days on the market first, the rest largest first).

asc desc

min_propertiesinteger

Leave out agencies with fewer properties (default 5; below 5 the figures are null).

≥ 1default 5

max_propertiesinteger

At most this many properties in the town.

≥ 1

min_portfolio_value_eurnumber

At least this portfolio value (EUR).

max_portfolio_value_eurnumber

At most this portfolio value (EUR).

min_sharenumber

At least this share.

max_sharenumber

At most this share.

min_price_cut_sharenumber

At least this price cut share.

max_price_cut_sharenumber

At most this price cut share.

min_days_on_marketnumber

At least this days on market.

max_days_on_marketnumber

At most this days on market.

min_overpricing_pctnumber

At least this overpricing (percent).

max_overpricing_pctnumber

At most this overpricing (percent).

independentboolean

true: only agencies that belong to no network.

networkstring

Only offices of this network.

at most 100 characters

crmstring

Only agencies whose own website runs on this CRM or website vendor (an estimate), such as Inmovilla, Inmoweb, eGO Real Estate or Casafari CRM.

at most 60 characters

mlsstring[]

Only agencies with this MLS status (an estimate): yes (named in a network's member list), likely (a badge on its website, an MLS-bearing CRM or a partner franchise), no (looked and found nothing), unknown.

yes likely no unknown

at most 4 items

sizeinteger

Rows per page, 1 to 25 (default 25).

1–25default 25

offsetinteger

Rows to skip: the next_offset of the previous page.

≥ 0default 0

How do I call `agencygraph_screen_agencies`?

Required arguments only, with placeholder values. Your assistant fills them in from the parameters above.

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "agencygraph_screen_agencies",
    "arguments": {
      "country": "ES"
    }
  }
}

agencygraph_screen_agencies

#What does Screen agencies by the measures do?

#Which parameters does agencygraph_screen_agencies take?

#How do I call agencygraph_screen_agencies?

#Related pages

What does Screen agencies by the measures do?

Which parameters does `agencygraph_screen_agencies` take?

How do I call `agencygraph_screen_agencies`?

Related pages