MCP Server for AI Agents

Enable AI agents to browse property verification missions using the Model Context Protocol (MCP). Our server provides read-only access to mission data on the HomeVisto platform.

Overview

The HomeVisto MCP Server implements the Model Context Protocol, allowing AI assistants and agents to discover and explore property verification missions. All tools are read-only and designed for safe browsing of platform data.

5 read-only tools for browsing missions
Search by location, keywords, or status
Geographic proximity search support
Platform statistics and insights

Server Information

EndpointPOST https://mcp.homevisto.com/mcp

Protocol VersionMCP 2025-03-26

TransportStreamable HTTP

Available Tools

The MCP server exposes 5 tools for browsing missions. All tools are read-only and return structured data.

list_missions

List property verification missions with optional filtering. Returns paginated results sorted by creation date.

Parameters:

status (optional) — Filter by mission status (OPEN, ASSIGNED, etc.)
limit (optional) — Maximum results to return (default: 20, max: 100)
offset (optional) — Number of results to skip for pagination

get_mission

Get detailed information about a specific mission including property details, viewer/scout info, and status.

Parameters:

id (required) — The mission UUID to retrieve

search_missions

Search missions by keyword. Matches against title, description, and property address fields.

Parameters:

query (required) — Search text to match
status (optional) — Filter by mission status
limit (optional) — Maximum results to return

get_nearby_missions

Find missions within a geographic radius. Useful for location-based discovery.

Parameters:

latitude (required) — Center point latitude (-90 to 90)
longitude (required) — Center point longitude (-180 to 180)
radiusKm (optional) — Search radius in kilometers (default: 10, max: 100)
status (optional) — Filter by status (default: OPEN)

get_mission_stats

Get aggregate statistics about missions on the platform including counts, averages, and status breakdown.

No parameters required

Client Example

Here's a simple TypeScript/JavaScript client for calling MCP tools:

TypeScript Client

const MCP_SERVER = "https://mcp.homevisto.com/mcp";

async function callTool(name, args) {
  const response = await fetch(MCP_SERVER, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      jsonrpc: "2.0",
      id: Date.now(),
      method: "tools/call",
      params: { name, arguments: args }
    })
  });
  return response.json();
}

// List open missions
const openMissions = await callTool("list_missions", {
  status: "OPEN",
  limit: 10
});

// Search for apartments in Berlin
const results = await callTool("search_missions", {
  query: "apartment Berlin"
});

// Find missions near a location
const nearby = await callTool("get_nearby_missions", {
  latitude: 52.52,
  longitude: 13.405,
  radiusKm: 25
});

Try It Now

Test the MCP server directly in your browser. Select a tool, enter parameters, and see live results from the HomeVisto platform.

Interactive Test Client

Select Tool

Mission Status Values

Status	Description
`OPEN`	Available for scouts to accept
`ASSIGNED`	Scout has accepted, not yet started
`IN_PROGRESS`	Scout is traveling to property
`LIVE`	Live video tour in progress
`COMPLETED`	Mission finished, report submitted
`PAID`	Payment released to scout
`CANCELLED`	Mission was cancelled

API Documentation Access

This documentation is also available programmatically for AI agents:

Plain Text (Markdown):GET https://homevisto.com/api/docs/mcp-server

JSON Format:GET https://homevisto.com/api/docs/mcp-server?format=json

Ready to Connect?

Start browsing HomeVisto missions with your AI agent today.

Visit MCP Server Integration Docs