Back to Directory/Developer Tools

io.github.janmalmstrom/lupaph-mcp

Philippine property listings, transfer costs, and real estate legal info via lupaph.com.

Developer ToolsJavaScriptv1.0.1

LupaPH MCP Server

Philippine real estate data for AI agents — search verified listings, calculate transfer costs, and get accurate legal information via lupaph.com.

Tools

ToolWhat it does
search_listingsSearch verified PH property listings by province, type, price
get_listingFull details of a specific listing
get_province_listings_summaryOverview of available listings in a province
calculate_transfer_costFull title transfer cost breakdown (CGT, DST, transfer tax, registration)
get_legal_infoAccurate PH real estate legal rules (ownership, CARP, SPA, title verification)
search_guidesSearch lupaph.com buying guides and articles

Install

The LupaPH MCP works with any MCP-compatible AI assistant. The config JSON is identical for all clients:

{
  "mcpServers": {
    "lupaph": {
      "command": "npx",
      "args": ["-y", "lupaph-mcp"]
    }
  }
}

Claude Desktop

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add lupaph -- npx -y lupaph-mcp

Cursor

Add to .cursor/mcp.json in your project or home directory.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json.

Cline (VS Code)

Open Cline → MCP Servers → Add Server → paste the config JSON.

Continue

Add to .continue/config.json under mcpServers.

Zed

Add to ~/.config/zed/settings.json under context_servers.

Manual install

npm install -g lupaph-mcp
lupaph-mcp

Example prompts

Find farm lots under ₱1,000,000 in Batangas
Calculate transfer costs for a ₱3,500,000 property in a province
What are the CARP rules for buying agricultural land in the Philippines?
Can an OFW buy land in the Philippines without going home?
Show me beach properties available in Palawan
What documents do I need to verify a land title in the Philippines?

Legal topics available

  • ownership_rights — Who can own land (OFWs, dual citizens, foreigners)
  • title_verification — TCT vs Tax Declaration, Registry of Deeds, encumbrances
  • transfer_costs — CGT, DST, transfer tax breakdown
  • carp_agricultural — CARP rules, DAR clearance, tenant rights, conversion
  • spa_remote_buying — Special Power of Attorney, apostille, consularisation
  • financing — Pag-IBIG, bank loans, developer financing
  • deceased_owner — Estate settlement, extrajudicial settlement
  • brokers_lawyers — When you need each, how to verify a PRC licence

Data source

All listing data is live from lupaph.com — verified lots, farm land, beach properties, and bank foreclosures across all 83 Philippine provinces.

License

MIT

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y lupaph-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-janmalmstrom-lupaph-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lupaph-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

lupaph-mcpnpm

Compatible MCP Clients

io.github.janmalmstrom/lupaph-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More