Search properties, listings, buildings, land and market facts
search_entitiesBounded public search using the versioned SearchQuery. Criteria are validated by the server; sorting and pagination use the same eligibility as the map. All Entities returns separate groups. No graph inference or unknown evidence changes eligibility.
Same call over REST
Search/v1/searchNot connected yet? Connect your assistant. Sign in with your MarketCode account; no API key needed.
Inputs
Arguments search_entities takes
| Name | Type | Required | Description |
|---|---|---|---|
| query | object | Yes | |
| limit | integer | No | Default: 20 |
| cursor | string | No |
Usage
How to run search_entities in your assistant
Ask your assistant in plain English, for example:
"Use the MarketCode tool search_entities 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
search_entities 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 search_entities
- Recorded entity relationshipsFree
entity_relationshipsRecorded relationship evidence from the derived graph. Use canonical ids from search. Cite path provenance and publication dates. Bounded and eventually consistent; missing links do not establish absence, ownership or off-market status. No private ownership payloads are returned.Same category - Search capabilities and coverageFree
entity_search_capabilitiesGoverned entity families, criteria, coverage and query limits. Call before building searches.Same category
FAQ
Questions about search_entities
How much does `search_entities` cost?
+
search_entities 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 `search_entities`?
+
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.
Try search_entities in your assistant.
30-minute call. We'll connect your assistant live on a real address.