onehome-mcp

onehome-mcp

MCP server for OneHome (CoreLogic) — search the listings your real-estate agent curated for you, fetch property details + photos, compare houses side-by-side, and run mortgage / affordability math from within Claude.

Sister project to zillow-mcp, redfin-mcp, compass-mcp, and homes-mcp. Same tool ergonomics — different upstream auth model.

This project was developed and is maintained by AI (Claude). Use at your own discretion.

What's different about OneHome

OneHome isn't a public listings site. Buyers usually reach it through a magic link an agent emails them — https://portal.onehome.com/...?token=eyJ.... That token query param IS the per-user bearer that the portal SPA hands to every GraphQL request.

So instead of routing every fetch through your signed-in browser tab (like the other realty MCPs), onehome-mcp talks directly to services.onehome.com/graphql from Node, with Authorization: Bearer <jwt> attached. We support three ways to source that bearer:

Mode	How to enable	Notes
env_token	ONEHOME_TOKEN=<jwt>	Paste the raw bearer from devtools Network panel. Most direct.
magic_link	ONEHOME_MAGIC_LINK=https://portal.onehome.com/...?token=...	Paste the full URL your agent sent — we extract the token param.
fetchproxy_capture	(no env) + fetchproxy extension installed + signed-in portal.onehome.com tab	We wait for your tab to fire any GraphQL request, snapshot the Authorization header, and reuse it.

Tools

Tool	What it does
onehome_get_user	Smallest auth probe — returns your OneHome profile (name, email) and the groups your agent shared.
onehome_get_groups	List the OneHome "groups" your agent has shared with you (each one a market / curated listing bucket).
onehome_get_saved_search	Fetch an agent-curated saved search by id — name, filter criteria, polygon, and the OSK listing ids that compose the share.
onehome_get_saved_search_with_listings	The "show me my saved homes" flow in one round trip — saved search plus its inflated listings.
onehome_search_properties	Listings within a group; optionally scoped to a saved search.
onehome_search_suggestions	Free-text suggestion search (address, MLS #) across all feeds.
onehome_get_by_address	Resolve a single free-text street address to a listing's portal URL + id.
onehome_resolve_addresses	Bulk-resolve up to 100 structured addresses to portal URLs + listing ids; concurrent, per-row error capture.
onehome_get_property	Full property record by listing id or portal URL.
onehome_bulk_get	Fetch up to N listings in one call — one structured row per id, per-row error capture.
onehome_get_property_photos	Full media gallery — Thumbnail / Medium / Large variants + room descriptions.
onehome_compare_properties	2-8 listings side-by-side. Per-row error capture; calls are concurrent.
onehome_get_schools	Local-Logic primary + high schools near a lat/lng.
onehome_get_walk_score	Local-Logic walk / transit / bike / car friendliness scores.
onehome_graphql	Power-user escape hatch — send a raw GraphQL document with variables.
onehome_calculate_mortgage	Local PITI calculator. Same math as the other realty MCPs.
onehome_calculate_affordability	Local 28/36 DTI solver — max home price you can afford.
onehome_set_auth	Add another authenticated session at runtime (magic link / JWT / email-token) for buyers holding shares across multiple agents.
onehome_set_active_session	Force a specific registered session to be the active one (overrides MLS-suffix routing).
onehome_get_session_context	List every registered session — auth mode, token expiry, and the group / saved-search / agent scope each bootstrapped.
onehome_healthcheck	End-to-end auth + GraphQL smoke check with token-expiry diagnostics.

Install

The simplest path is the published Claude plugin (.mcpb install). For local dev:

git clone https://github.com/chrischall/onehome-mcp
cd onehome-mcp
npm install
npm run build

Then point your MCP host at node /abs/path/to/onehome-mcp/dist/bundle.js with one of:

// claude_desktop_config.json
{
  "mcpServers": {
    "onehome-mcp": {
      "command": "node",
      "args": ["/abs/path/to/onehome-mcp/dist/bundle.js"],
      "env": {
        "ONEHOME_MAGIC_LINK": "https://portal.onehome.com/en-US/properties/map?token=eyJ..."
      }
    }
  }
}

Development

npm test               # vitest, mocked transport, no network
npm run test:watch
npm run test:coverage
npx tsc --noEmit
npm run build          # tsc --noEmit + esbuild → dist/bundle.js

Tests use a FakeTransport (in tests/helpers.ts) that registers per-operationName handlers — there's no live network in the test suite. The tests/index.test.ts smoke check loads the same tool registrations src/index.ts uses against an in-memory MCP client/server pair, so "I wrote the tool file but forgot to wire it up" mistakes fail loudly.

License

MIT.