Skip to main content

Model Context Protocol

Connect Claude, ChatGPT, Cursor to ValiFit

Any MCP-aware AI client can call ValiFit's real-estate intelligence surface directly inside its conversation — agent lookups, town fit scoring, semantic search across all 35,000 US municipalities.

Standalone (local)

For Claude Desktop, Cursor, Cline, Continue, or any stdio-MCP client. Runs on your machine, no setup.

{
  "mcpServers": {
    "valifit": {
      "command": "npx",
      "args": ["-y", "@valifit/mcp"]
    }
  }
}

Add this block to your claude_desktop_config.json / Cursor MCP settings. Requires Node 20+.

Hosted (web)

For Claude.ai web app, ChatGPT custom GPTs, browser-based MCP clients. No install — point your client at our endpoint.

Endpoint: https://valifit.com/api/mcp
Transport: HTTP (Streamable HTTP, MCP 2024-11-05)
Method: POST (JSON-RPC 2.0)
Auth: Optional Bearer (vfk_...)
CORS: enabled (*)

CORS open for any origin. Public-tier rate limit 60 req/min/IP.

Available tools

get_agent

Look up a public real-estate agent profile by slug. Returns Schema.org RealEstateAgent JSON-LD with AQS, brokerage, license, service area. Strict no-PII.

get_health

API liveness + deployment metadata (git commit, region, DB ping).

get_charters

Return the 6 ValiFit Constitutional Charters — public commitments that govern scoring, lead routing, citation, and bias auditing.

search_semantic

Natural-language search across all 35,000 US municipalities. Returns top-N most similar towns with composite scores.Example queries: “quiet suburban town with great schools near a major hospital”, “affordable mid-sized city in Texas with strong appreciation”.

Try the hosted endpoint

Quick smoke test from your terminal:

curl -X POST https://valifit.com/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Compliance

The MCP server is constrained by the same 6 constitutional charters that govern the ValiFit web platform. The get_charters tool returns them verbatim so LLMs can cite the principle + enforcement when answering compliance questions about ValiFit.

  • FHA-Safe Methodology — no protected class in scoring
  • Lead-Routing Neutrality — agent ranking by AQS, never payment
  • Citation Density — every fact carries a federal source
  • Source Sovereignty — all data traces to authoritative open sources
  • Algorithmic Transparency — all scoring formulas public
  • Public Bias Audit — quarterly statistical audit, stream-only

Resources

Back to Trust