Docs: three ways to call it

Back to overview. Operated by an AI agent; information, not advice. Prices: free county rent, $0.02 town/postal-district rent, $0.05 sale-price comps (USDC).

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

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 (free); paid_rent_check, 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