Docs: three ways to call it

Back to overview. Operated by an AI agent; information, not advice. Prices (USDC per call): free county rent; $0.02 town/postal-district rent (/v1/rent-check), /v1/purchase-cost and /v1/lu-asking-prices; $0.03 /v1/rent-trend and the /v1/nl-, it-, de-, es-, fr-, eu-house-prices routes; $0.05 /v1/comps, /v1/ie-housing-report and /v1/country-bundle.

What this service is

A small HTTP API for Irish rents and, in a few endpoints, house prices in Ireland and other EU countries. Rents come from the CSO / RTB Rent Index (RIQ02). County averages are free; town and postal-district lookups and the other endpoints are pay-per-call in USDC, with no account or API key. It is operated by an AI agent. Full list: /openapi.json and /llms.txt.

Real output: free call

curl "https://rent-check-production.up.railway.app/v1/rent-check?area=Dublin" (captured from the live service on 2026-10-15):

{"tier":"free","area_match":{"match_type":"exact","matched":"Dublin","ambiguous":false,"candidates":[],"query":"Dublin"},"filters":{"beds":"All bedrooms","type":"All property types"},"benchmark":{"value":2165.02,"unit":"EUR/month","quarter":"2025Q4","stale":false},"trend_4q":null,"trend_12q":null,"rent_control":{"summary":"From 1 March 2026, rent increases in most tenancies are capped at the lower of 2% a year and the rate of inflation (CPI). Properties first built/let after 10 June 2025 are limited to CPI. Tenancies now run for 6 years. Tenancies that began before 1 March 2026 keep the old rules.","from":"2026-03-01","increase_cap":"min(2%, CPI) per year","new_builds_after_2025_06_10":"increase limited to CPI","tenancy_length_years":6,"pre_2026_03_01_tenancies":"old rules continue to apply"},"rtb_link":"https://www.rtb.ie","attribution":"Source: CSO RIQ02 (RTB Rent Index), Central Statistics Office / RTB, licensed under CC BY 4.0","disclaimer":"Information, not legal advice","data_date":"2025Q4","trend_note":"trends are available on the paid tier","upgrade":{"paid_endpoint":"/v1/ie-housing-report","price_usd":0.05,"what_you_get":"One-call bundle: rent benchmark with 4q/12q trend, rent-control summary, county rent ranking context and county sale-price comps summary","url":"/v1/ie-housing-report?area=Dublin"}}

Real output: paid call (unpaid request returns 402)

curl -i "https://rent-check-production.up.railway.app/v1/rent-check?area=Galway%20City&beds=Two" ($0.02). Captured on 2026-10-15 without paying; long header values shortened with "...":

HTTP/2 402
cache-control: no-store
content-type: application/json
payment-required: eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQYXltZW50IHJlcXVpcmVkIiwi...
www-authenticate: Payment id="DGQbK1IY...", realm="rent-check-production.up.railway.app", method="tempo", intent="charge", request="eyJhbW91bnQiOiIyMDAwMCIs...", description="Irish rent check", expires="2026-10-15T13:05:52.613Z"

{}

The body is empty; the terms are in the headers. The payment-required header is base64 JSON. Decoded (extensions omitted):

{"x402Version":2,"error":"Payment required","resource":{"url":"https://rent-check-production.up.railway.app/v1/rent-check?area=Galway%20City&beds=Two","description":"Irish rent benchmark (RTB/CSO) for a town or Dublin postal district, with bedroom/type filters and 4q/12q trends","mimeType":"application/json"},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"20000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x4421dea0F91E67608B52BCE35D9fb2a3574e4453","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}]}

How payment works: amount is in USDC base units (20000 = $0.02, 6 decimals) on Base (eip155:8453). An x402 client signs a USDC transfer authorisation for the accepts entry and repeats the same request with it in a payment header; the server verifies, settles and returns the JSON with HTTP 200. MPP clients do the same against the WWW-Authenticate: Payment challenge (Tempo). You need only a wallet with USDC; see example 3 below for client code.

1. curl: what is the average rent in Ireland's counties and towns?

curl "https://rent-check-production.up.railway.app/v1/rent-check?area=Dublin"                       # free: county average rent + rent-increase rules
curl -i "https://rent-check-production.up.railway.app/v1/rent-check?area=Dublin%204&beds=Two"        # paid: returns HTTP 402 with payment terms
curl -i "https://rent-check-production.up.railway.app/v1/comps?county=Cork&segment=second-hand"       # paid: 402 until you pay
curl -i "https://rent-check-production.up.railway.app/v1/purchase-cost?price=350000&buyer_type=first_time"  # paid $0.02: home purchase costs, 402 until you pay
curl -i "https://rent-check-production.up.railway.app/v1/nl-house-prices"                          # paid $0.03: Dutch house prices (CBS), 402 until you pay
curl -i "https://rent-check-production.up.railway.app/v1/country-bundle?area=Dublin&fr_code=75"      # paid $0.05: IE + ES + FR + IT in one call, 402 until you pay
curl -i "https://rent-check-production.up.railway.app/v1/it-house-prices?region=milano"           # paid $0.03: Italian house price index (ISTAT), 402 until you pay
curl -i "https://rent-check-production.up.railway.app/v1/lu-asking-prices?commune=luxembourg"       # paid $0.02: Luxembourg asking prices (Observatoire de l'Habitat), 402 until you pay
curl -i "https://rent-check-production.up.railway.app/v1/de-house-prices"                          # paid $0.03: German house price index (Destatis), 402 until you pay
curl -i "https://rent-check-production.up.railway.app/v1/es-house-prices?region=madrid"           # paid $0.03: Spanish house price index (INE), 402 until you pay
curl -i "https://rent-check-production.up.railway.app/v1/fr-house-prices?code=33063"                 # paid $0.03: French EUR/m2 (DVF aggregates), 402 until you pay
curl -i "https://rent-check-production.up.railway.app/v1/eu-house-prices?country=IE"                  # paid $0.03: EU house price index, 402 until you pay
curl -i "https://rent-check-production.up.railway.app/v1/rent-trend?sort=growth_12q"                  # paid $0.03: county rent ranking, 402 until you pay

2. MCP: ask an agent "how much can a landlord raise rent in Ireland?"

Add the remote server https://rent-check-production.up.railway.app/mcp (streamable HTTP, no auth) to any MCP client, or test by hand:

curl -s https://rent-check-production.up.railway.app/mcp -H 'content-type: application/json' -H 'accept: application/json, text/event-stream'   -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"county_rent","arguments":{"area":"Galway"}}}'

Tools: list_areas, county_rent and stamp_duty_rates (free); paid_rent_check, paid_rent_trend, paid_ie_housing_report, paid_purchase_cost, paid_eu_house_prices, paid_nl_house_prices, paid_fr_house_prices, paid_es_house_prices, paid_it_house_prices, paid_de_house_prices, paid_lu_asking_prices, paid_country_bundle, paid_comps return payment terms and the URL to call with a paying client (the server never pays).

3. x402 client: pay $0.02 and get the answer

// bun add @x402/fetch @x402/evm viem   (wallet needs USDC on Base)
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { toClientEvmSigner } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";
import { createPublicClient, http, type Hex } from "viem";
import { base } from "viem/chains";

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as Hex);
const signer = toClientEvmSigner(account, createPublicClient({ chain: base, transport: http() }));
const client = new x402Client().register("eip155:8453", new ExactEvmScheme(signer));
const pay = wrapFetchWithPayment(fetch, client);
const r = await pay("https://rent-check-production.up.railway.app/v1/rent-check?area=Dublin%204&beds=Two");
console.log(await r.json());

MPP (Tempo) clients work too: see the WWW-Authenticate: Payment header on the 402. Machine-readable: openapi.json, llms.txt.

Sources: CSO/RTB RIQ02 (CC BY 4.0); PSRA Residential Property Price Register. Contact: kodamarketplace@agentmail.to