Connect your AI assistant to MarketCode and value a property
Ten minutes from nothing to a valuation with its comparables, in Claude, ChatGPT, Codex or Cursor. One URL, one sign-in, no API key.
This guide takes you from no account to a valuation with its evidence, inside the assistant you already use. One server URL, one sign-in, one question. The valuation is free. Resolving the address and reading the property record are priced, in credits and pence, and a new account's welcome credits cover them many times over.
What you need
An assistant that speaks MCP: Claude (any plan, web or desktop), ChatGPT, Codex, Claude Code, Cursor, VS Code with Copilot, Windsurf or Gemini CLI. An email address for the MarketCode account, which is created the first time you sign in and starts with free credits. No API key: the MCP server signs you in with OAuth, and a key pasted into a client's config is a credential where it leaks.
The server URL, for every client:
https://mcp.marketcode.ai/mcp
Step 1: add the server
Claude. Free, Pro and Max: Customize → Connectors → + → Add custom connector, and enter the URL. Team and Enterprise: Organization settings → Connectors → Add → Custom → Web. Choose Connect and sign in. Then enable it for a chat from + → Connectors.
ChatGPT. Go to Settings → Security and login and turn Developer mode on. Add MarketCode with a short description and the URL; ChatGPT finds the sign-in itself. Then add MarketCode to a chat from the tools menu. The ChatGPT page has the exact labels.
Codex. In the terminal: codex mcp add marketcode --url https://mcp.marketcode.ai/mcp then codex mcp login marketcode. In the app or IDE: Settings → MCP servers → Add server → Streamable HTTP, paste the URL, Authenticate.
Claude Code. Run claude mcp add --transport http marketcode https://mcp.marketcode.ai/mcp, then /mcp in the session. Choose MarketCode, then Authenticate.
Cursor. Put {"mcpServers": {"marketcode": {"url": "https://mcp.marketcode.ai/mcp"}}} in .cursor/mcp.json, then Cursor Settings → MCP → MarketCode → Login.
Full steps for each client: Claude, ChatGPT, Codex, Claude Code, Cursor, VS Code, Windsurf and Gemini CLI.
Step 2: sign in once
Your client opens a MarketCode sign-in page. Use an email link, Google or Microsoft. You approve one scope, property:read: read-only property data. A connected app cannot see your keys, billing or account. Disconnect it any time under Connections in your account. New accounts get 500 welcome credits (£5) on first sign-in.
Step 3: ask for a valuation
Type a question in plain English. This one works as written:
Value 12 Lordship Lane, London SE22 8HN. Give me the estimate, the range, how confident you are, the comparables you used, and the twelve-month trend for SE22.
Behind that one sentence, the assistant calls four tools:
address_resolve turns the address into its UPRN, the identifier every other tool keys on. 2 credits (2p): it returns a licensed Ordnance Survey record, and it is right first time on 92% of real queries (the benchmark).
- valuation_full returns the estimate, the low and high of the range, a trust score, and the comparables with each adjustment. Free.
property_summary adds the record behind the number: type, tenure, floor area, EPC rating, last sale. 20 credits (20p).
- market_index_series for SE22 gives the repeat-sales index and its twelve-month change, so you can see whether the number sits above or below the district's trend. Free.
The answer names each figure's source and the evidence grade behind the comparables. If the record has no floor area, the range widens, the trust score drops, and the assistant tells you. Why the estimate is a starting point, not an answer: why an AVM is a prior, not a valuation.
Step 4: check what it cost
Open Usage in your account. Every call is listed with its credit charge. Everything above costs 22 credits (22p): 2 for the address, 20 for the property record. The valuation and the index are free. A tool that charges does so for a stated reason, usually a data licence, and its description shows the price before you call it. Failed calls are never charged. A credit is 1p, bought from £10 with no subscription; pricing lists every capability in credits and pounds.
What to try next
- "Show me every sale in that building since 2015." (
transactions_by_uprn, free) - "Is the property in a flood zone or a conservation area?" (
property_flood_risk,planning_designations, free) - "Who owns the freehold?" (
ownership_by_title, charged, because HM Land Registry licenses the proprietor record)
Prefer the MarketCode workspace? Start with valuation: the same comparables and range, beside the estimate.
Keep reading: We measured our address search on 5,000 real queries. Here is every number., Produce an area report in ten minutes and Why an AVM is a prior, not a valuation.
Related guides
- Pull a house price index into a spreadsheet with the REST APIOne key, one free call, and the monthly index for any UK district or authority is in Excel or Sheets. The response marks which months are still forecast.
- UPRN vs postcode: what to key your property data onA postcode names a group of addresses; a UPRN names one. Join sales, energy certificates, council tax bands and listings on the right key and trust the result.
- Comparable evidence in property valuationHow valuers rank, adjust and weigh comparable sales in England and Wales, with a worked two-bed flat example and the traps in Price Paid and listing data.