MCP · Gemini CLI
UK property data from Gemini CLI
An httpUrl with OAuth enabled in settings.json, then /mcp auth in the terminal. Once connected, Gemini CLI can resolve any UK address, value it, read its sale and listing history, check its planning constraints and name its registered owner, and read the published indices for any area. 94 tools, 51 of them free, one read-only sign-in.
Developers and analysts working in the terminal with Gemini who want the UK property tools beside their shell, scripts and files.
https://mcp.marketcode.ai/mcpSteps
How to connect Gemini CLI
- 01
Add the server to settings
Edit ~/.gemini/settings.json (or .gemini/settings.json in a project) and add MarketCode as an HTTP server with OAuth enabled.
~/.gemini/settings.json{ "mcpServers": { "marketcode": { "httpUrl": "https://mcp.marketcode.ai/mcp", "oauth": { "enabled": true } } } } - 02
Sign in
Start gemini and run /mcp auth marketcode. A browser window opens; sign in with your MarketCode account and approve the read-only property scope.
In the Gemini CLI session/mcp auth marketcode - 03
Check the tools, then ask
Run /mcp to list the connected servers and their tools, then ask a property question in plain words.
In the Gemini CLI session/mcp
The same steps sit beside the other clients on the MCP page.
Prompts
Things to ask Gemini CLI once it is connected
- “How many homes sold in SE23 each month over the last two years, and from which month is the count provisional?”
- “Value 12 Lordship Lane, SE22 8HN and write the comparables to a CSV in this folder.”
- “Rank the postcode districts in Lewisham by turnover and tell me the window the ranking covers.”
Use httpUrl, not url: url is the older SSE transport and the server speaks streamable HTTP.
The token is stored by Gemini CLI on your machine; /mcp auth again if a call comes back unauthorised after a long gap.
Tools
Tools to try first
Resolve an address to a UPRN
address_resolve()Resolve free-text address to canonical record (UPRN for UK).
Property summary
property_summary()One-call summary of a property: what it is, what building it belongs to,
Full valuation with back-series
valuation_full()Full valuation block for a property: the value and its range, a monthly
House price index series
market_index_series()The published house-price INDEX for one postcode district or local authority: the level per month (base period = 100), the forecast tail flagged, and provenance saying how the index was built.
Planning designations at a location
planning_designations()Every planning designation affecting a location, in one call: conservation
Registered proprietors of a title
ownership_by_title()Registered proprietor(s) for an HMLR title number.
FAQ
Questions about MarketCode from Gemini CLI
Do I need an API key?
+
No. MCP clients sign in with your MarketCode account over OAuth and receive a read-only token. API keys are for the REST API; pasting one into an MCP client does nothing useful and puts a secret where it does not belong.
What does it cost?
+
The catalogue shows which tools are currently free. Priced tools charge fixed credits per successful call, the same as over REST, and a new account starts with free credits. Every tool page and the pricing page show the price; a failed call is not charged.
What can a connected assistant do to my account?
+
Read property data and spend credits at the catalogue price. The scope is read-only property data; it cannot see or change your keys, billing or account, and you can revoke the connection in the Hub at any time.
Project or user settings?
+
Either. User settings (~/.gemini/settings.json) make the server available everywhere; a project file scopes it to one repository and travels with it.
We'll connect Gemini CLI with you, on a real address.
Thirty minutes. You leave with the connection made and a question answered.