# `agencygraph_screen_agencies`

> **Casafari is the AI agent-native real estate data intelligence platform.** The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries. Every property is one record with its full price and market history. [How the property graph is built](/docs/property-graph).

Screen agencies by the measures. Product: [AgencyGraph](/docs/agencygraph). Annotations: Read-only.

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

Over REST: [`POST /v1/agencygraph/{country}/screen`](/docs/rest/agencygraph#screen-agencies-by-ranges-of-the-measures) (equivalent).

## What does Screen agencies by the measures do?

Filters agencies, one row per agency and town, in the whole country or in up to 20 towns, by ranges of the measures (portfolio value, share, price cut share, days on the market, overpricing), size, network or independence and property type, sorted as you ask, with each row's measures and growth. For recruitment, partners or agencies growing in an area. Pages of up to 25 rows.

## Which parameters does agencygraph_screen_agencies take?

- `country` (string, required): Country code: ES or PT. Values: `ES`, `PT`.
- `location_ids` (integer[], optional): Optional: up to 20 towns (location ids from locations_search); without, the whole country. at most 20 items; ≥ 1.
- `type_group` (string, optional): Property type group: all (default), apartment or house. Values: `all`, `apartment`, `house`. default "all".
- `operation` (string, optional): sale (default): homes for sale. Rentals are not measured yet. Values: `sale`. default "sale".
- `sort` (string, optional): The measure to sort by. Values: `portfolio_value`, `properties`, `share`, `median_price`, `price_per_sqm`, `price_cut_share`, `days_on_market`, `overpricing`. default "portfolio_value".
- `order` (string, optional): asc or desc; default the measure's natural order (fewest days on the market first, the rest largest first). Values: `asc`, `desc`.
- `min_properties` (integer, optional): Leave out agencies with fewer properties (default 5; below 5 the figures are null). ≥ 1; default 5.
- `max_properties` (integer, optional): At most this many properties in the town. ≥ 1.
- `min_portfolio_value_eur` (number, optional): At least this portfolio value (EUR).
- `max_portfolio_value_eur` (number, optional): At most this portfolio value (EUR).
- `min_share` (number, optional): At least this share.
- `max_share` (number, optional): At most this share.
- `min_price_cut_share` (number, optional): At least this price cut share.
- `max_price_cut_share` (number, optional): At most this price cut share.
- `min_days_on_market` (number, optional): At least this days on market.
- `max_days_on_market` (number, optional): At most this days on market.
- `min_overpricing_pct` (number, optional): At least this overpricing (percent).
- `max_overpricing_pct` (number, optional): At most this overpricing (percent).
- `independent` (boolean, optional): true: only agencies that belong to no network.
- `network` (string, optional): Only offices of this network. at most 100 characters.
- `size` (integer, optional): Rows per page, 1 to 25 (default 25). 1–25; default 25.
- `offset` (integer, optional): Rows to skip: the next_offset of the previous page. ≥ 0; default 0.

## How do I call agencygraph_screen_agencies?

Required arguments only, with placeholder values; see the parameters above for real ones.

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

## Related pages

- [Countries and weekly builds (agencygraph_coverage)](/docs/agencygraph/coverage)
- [One country in detail (agencygraph_country_coverage)](/docs/agencygraph/country_coverage)
- [Find an agency (agencygraph_resolve_agency)](/docs/agencygraph/resolve_agency)
- [Agency profile (agencygraph_agency_profile)](/docs/agencygraph/agency_profile)
- [AgencyGraph: overview](/docs/agencygraph)
- [AgencyGraph MCP server: connect and examples](/docs/agencygraph/mcp)
- [AgencyGraph REST API](/docs/rest/agencygraph)