Developer API & MCP

Japan property research, as tools your agent can call

Lot numbers (地番), land prices, past transactions, zoning, school districts and live listings — over MCP, or plain HTTP. Free tools need only an API key.

Connect to Japan Property Research MCP

Endpointhttps://japanpropertyresearch.com/mcp

AuthAuthorization: Bearer jpnr_...

TransportHTTP MCP (JSON-RPC 2.0)

Tools

Free tools are marked. Everything else needs a paid plan; the server only advertises the tools your key can actually call.

Parcel

lookup_lot_numberFree
Resolve a Japanese address into its lot number (地番) and parcel geometry.
Input: address*
get_lot_number_addressFree
Resolve a lot number (地番) back into its residential address.
Input: lotNumber*
get_zoning_summaryPaid
Return zoning polygon totals and top zoning classes by count.
Input: address, lat, lng, radiusKm
get_designated_schoolsPaid
Return designated elementary/junior high school assignments for a point.
Input: address, lat, lng, radiusKm

Market

get_city_price_statsFree
Municipality-level land price statistics across Japan, optionally filtered by city or prefecture.
Input: cityCode, prefecture
get_land_price_evidencePaid
Return land-price points with explicit price per sqm and YoY summary.
Input: address, lat, lng, radiusKm
get_past_transactionsPaid
Fetch MLIT-style past transaction records and summary statistics.
Input: address, lat, lng, radiusKm, prefecture, cityCode, cityCodes, stationName, propertyTypes, periodFrom, periodTo, limit

Listings

get_listings_nearbyFree
Fetch active property listings near a point with price and type summaries.
Input: address, lat, lng, radiusKm, bbox, cityCode, limit, offset, sortBy, currency, minPrice, maxPrice, minYearBuilt, maxYearBuilt, listingType
get_listing_detailPaid
Fetch detailed listing data for a specific listingId.
Input: listingId*

Narrative

generate_market_insight_briefPaid
Generate a professional, quotable market insight brief from nearby land-price and transaction evidence.
Input: address, lat, lng, country, cityCode, cityCodes, radiusKm, townCoverageRadiusKm, landEvidenceRadiusKm, transactionsRadiusKm, transactionsLimit, reportYear, transactionsPeriodFrom, transactionsPeriodTo

Limits

Plan	Tools	Calls / month	Per minute	Listing records / call	Listing rows / month
Free	4	50	5	4	200
Personal	10	5,000	60	20	20,000
Business	10	50,000	300	20	200,000

Claude Code

To add the MCP server to Claude Code, run the following command.

claude mcp add --transport http japan-property-research https://japanpropertyresearch.com/mcp \
  --header "Authorization: Bearer jpnr_..."

After adding the server, authenticate with your API key.

Cursor / VS Code

Add the following to your MCP configuration file.

{
  "mcpServers": {
    "japan-property-research": {
      "url": "https://japanpropertyresearch.com/mcp",
      "headers": { "Authorization": "Bearer jpnr_..." }
    }
  }
}

ChatGPT

You can enable MCP servers on ChatGPT with a Pro, Plus, Business, Enterprise or Education account. Use these parameters when setting up a custom connector.

Endpointhttps://japanpropertyresearch.com/mcp

AuthAuthorization: Bearer jpnr_...

Plain HTTP

If you are not using MCP, the same tools are available over REST. The OpenAPI spec is at /api/research/openapi.json.

curl -s https://japanpropertyresearch.com/api/research/tools \
  -H "Authorization: Bearer jpnr_..." \
  -H "Content-Type: application/json" \
  -d '{"tool":"lookup_lot_number","input":{"address":"北海道虻田郡倶知安町北1条東1丁目"}}'

Any other MCP client

MCP is an open protocol. Use the server URL above and pass your API key in the Authorization header as a Bearer token.

Getting a key

Create an API key in your dashboard. Free accounts can create one too.

Open the developer dashboard See plans