Skip to main content
Glama
chrischall

onehome-mcp

by chrischall
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

onehome-mcp

CI npm license

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.

Related MCP server: armls-spark-mcp-server

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.

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
2dResponse time
4dRelease cycle
13Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chrischall/onehome-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server