Estate agent activity in an area
agent_activityWhich estate agents actually transact in an area, ranked by listing count.
Same call over REST
Market agent activity/v1/market/agents/{area_id}Not connected yet? Connect your assistant. Sign in with your MarketCode account; no API key needed.
Reference
What agent_activity answers
Sale and rental are counted and averaged SEPARATELY — an asking price and a monthly rent do not combine into one median, so read median_asking_price and median_monthly_rent as answering different questions.
area_id is the marts area id from area_resolve.
UK only.
Inputs
Before you call it
- area_id
- The area id is the analytics area identifier, not a name or a GSS code. Call area_resolve with a place name or code ("Hackney", "E5") first; it is free and returns the id with the area's hierarchy. Where it gives both
area_idandanalytics_area_id, passanalytics_area_id.
Example
An example call to agent_activity
Use the MarketCode tool agent_activity with {"area_id":"c0694b59-04d1-48ab-9a4c-c4f9d7b74f60","limit":5} and show me the result.{
"area_id": "c0694b59-04d1-48ab-9a4c-c4f9d7b74f60",
"months": null,
"listing_type": null,
"agents": [
{
"agent_name": "OpenRent, London",
"n_properties": 1580,
"n_listings": 4825,
"n_rental": 4825,
"n_sale": 0,
"median_asking_price": null,
"median_monthly_rent": 1650,
"first_listing": "2021-08-06",
"last_listing": "2026-07-29"
},
{
"agent_name": "Winkworth, Forest Hill",
"n_properties": 448,
"n_listings": 1098,
"n_rental": 671,
"n_sale": 427,
"median_asking_price": 500000,
"median_monthly_rent": 1650,
"first_listing": "2021-10-07",
"last_listing": "2026-08-26"
},
{
"agent_name": "UNCLE, Deptford",
"n_properties": 4,
"n_listings": 1056,
"n_rental": 1056,
"n_sale": 0,
"median_asking_price": null,
"median_monthly_rent": 2505,
"first_listing": "2024-03-26",
"last_listing": "2026-07-29"
},
"… 2 more"
],
"count": 5,
"note": "Ranked by listing count. Sale and rental medians are separate because an asking price and a monthly rent do not average.",
"credits_charged": 0
}A real response, captured from production and trimmed: arrays to three items, long strings shortened, volatile keys dropped.
Inputs
Arguments agent_activity takes
| Name | Type | Required | Description |
|---|---|---|---|
| area_id | string | Yes | |
| months | integer | No | |
| listing_type | string | No | One of: sale, rental |
| limit | integer | No | Default: 25 |
Response
What comes back
| Field | Type | Example |
|---|---|---|
| area_id | string | c0694b59-04d1-48ab-9a4c-c4f9d7b74f60 |
| months | null | |
| listing_type | null | |
| agents | array | |
| agents[].agent_name | string | OpenRent, London |
| agents[].n_properties | integer | 1580 |
| agents[].n_listings | integer | 4825 |
| agents[].n_rental | integer | 4825 |
| agents[].n_sale | integer | 0 |
| agents[].median_asking_price | null | |
| agents[].median_monthly_rent | integer | 1650 |
| agents[].first_listing | string | 2021-08-06 |
| agents[].last_listing | string | 2026-07-29 |
| count | integer | 5 |
| note | string | Ranked by listing count. Sale and rental medians |
| credits_charged | integer | 0 |
Fields observed in the example response above; a field the example did not exercise is not listed.
Usage
How to run agent_activity in your assistant
Ask your assistant in plain English, for example:
"Use the MarketCode tool agent_activity for <address or area>.
Show the result and the credits charged."
The arguments the assistant will send, for the example on this page:
{"area_id":"c0694b59-04d1-48ab-9a4c-c4f9d7b74f60","limit":5}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
agent_activity 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.
Sources
- Property portals
Sale and lettings listings
Collected from publicly marketed listings · Great Britain
Related
Tools used with agent_activity
- Resolve an area nameFree
area_resolveResolve an area name or code ("Hackney", "E5") to its area_id, centroidNamed 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.Same category - Equity gain estimateFree
equity_estimateCurrent estimated value against the last recorded sale: gain in pounds and percent, and how long it has been held.Same category - Listing history for a property3 credits
listing_historyEvery marketing snapshot for a property: asking price over time, price reductions, days listed, status changes, agent, image count and whether it had a floor plan.Same category - Supply-side listing statisticsFree
listing_market_seriesMonthly supply-side statistics from portal listings for one area, channel and bedroom band: listings added and reduced, reduction share (the market-temperature signal), asking price or rent median and quartiles, £/m² where a floor area is stated, new-build share, agent concentration (HHI, top-3 share), and — on rent rows — gross yield on two bases (cell rent over cell price; per-listing rent over the unit's AVM value), and on sale rows the asking-to-sold ratio and days to completion on listings the registry matched to a sale.Same category - Live listings stock, dailyFree
listing_stock_seriesLive listings on the market by day for one area, channel and bedroom band — the stock-on-market series, with the median age of the dated live stock, median asking price or rent, and the new-build count.Same category
Glossary
Terms used here
- Listing stock (stock on market): The number of properties live on the market in an area on a given day, by channel and bedroom band; a series MarketCode observes forward from September 2026 because it cannot be reconstructed.
- Agent market share: Which estate and letting agents actually list in an area, ranked by listings, with concentration measured by the Herfindahl index and the top-three share.
FAQ
Questions about agent_activity
How much does `agent_activity` cost?
+
agent_activity 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.
Where do I get the area id?
+
From area_resolve, which is free: give it a place name or postcode district and it returns the area id, centroid and hierarchy. agent_activity then takes that id.
Which assistants can run `agent_activity`?
+
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?
+
Read from Property portals listings. Coverage is the UK.
Does `agent_activity` change anything?
+
No. The tool is annotated read-only on the server, so it never writes to your data or ours and an assistant can call it without a confirmation step.
Try agent_activity in your assistant.
30-minute call. We'll connect your assistant live on a real address.