Homies for agentsDeveloper pilot · REST + MCP

Real estate tools.
One API.

Give your agent market statistics, paperwork and property search through one account connection. Build home evaluations, market reports and tailored buyer lists.

Muse connector details

The setup button copies a complete request for your agent. No URLs or placeholders to edit.

Ask your agent: Connect Homies to my agent. Read https://homiesai.com/api, use my host's secure credential flow for my individual account key, and check the connection with a read-only tool. Ask me for any missing setup details one at a time.

HOMIES / CONNECT

One key. Three toolsets.

Homies Stats

Homies Paperwork

Homies Search

16 MCP tools · 71 REST operations
Individual account authentication

Built on the Homies tools you know.

Homies Stats

Canadian housing markets, prices, sales, inventory and economic history. Every result keeps its source, dates and units.

Explore the data

Homies Paperwork

Discover forms, validate transaction details and prepare offers and other real estate documents using your account’s permitted library.

Explore paperwork

Homies Search

Search U.S. sale, rental, pending and sold listings through HomeHarvest. Licensed IDX and DDF access requires your own feed permissions.

See listing access

Connector technical specs

Ready to share with Meta Muse.

Choose the connection type used by your connector, then copy the matching fields. This page is the public documentation URL; requests run against the API endpoint below. Submission and directory approval are separate from having a working endpoint.

Choose MCP in the connector form and use the Streamable HTTP endpoint below. The OpenAPI link is an optional reference for the companion REST API.

Connection type: MCP (Streamable HTTP)
API URL: https://homies-api.vercel.app/mcp
OpenAPI specification (optional): https://homies-api.vercel.app/openapi.json
API or MCP documentation: https://homiesai.com/api
Access requirements: A Homies account and an individual Homies API key are required. Existing Homies Paperwork account keys are supported. Store the key in the connector's secure credential settings and send it in the Authorization Bearer header. Each user connects their own account; access and usage limits apply per account. Paperwork availability depends on the user's jurisdiction, account permissions and applicable form-publisher terms. Generated documents are unsigned drafts that require review. Licensed listing feeds require the user's own authorized IDX connection through chat.homiesai.com or their own DDF credentials supplied through a secure onboarding process. Availability depends on the user's board, region, provider and data permissions. IDX/DDF credentials are separate from the Homies API key and must not be entered in this submission form. Current gateway coverage: Canadian market statistics and U.S. property search through HomeHarvest. Licensed IDX/DDF feeds are not yet connected to the unified API; Canadian listing search is not currently enabled. Canadian home evaluations require authorized sold comparables supplied by the user. Buyer-list tools prepare matches and unsent email drafts. Recurring delivery requires a separately configured persistent host runner, an authorized mailbox, recipient and schedule. No client delivery schedule is activated by connecting the API. OAuth with PKCE is not implemented in this release.
Authentication methods: API keys

Select API keys in the authentication field. Use the Authorization header with the Bearer scheme. Leave OAuth with PKCE unselected for this release. Never put a key in a URL, prompt or submission note.

Access requirements

A Homies account and an individual Homies API key are required. Existing Homies Paperwork account keys are supported. Store the key in the connector's secure credential settings and send it in the Authorization Bearer header. Each user connects their own account; access and usage limits apply per account. Paperwork availability depends on the user's jurisdiction, account permissions and applicable form-publisher terms. Generated documents are unsigned drafts that require review. Licensed listing feeds require the user's own authorized IDX connection through chat.homiesai.com or their own DDF credentials supplied through a secure onboarding process. Availability depends on the user's board, region, provider and data permissions. IDX/DDF credentials are separate from the Homies API key and must not be entered in this submission form. Current gateway coverage: Canadian market statistics and U.S. property search through HomeHarvest. Licensed IDX/DDF feeds are not yet connected to the unified API; Canadian listing search is not currently enabled. Canadian home evaluations require authorized sold comparables supplied by the user. Buyer-list tools prepare matches and unsent email drafts. Recurring delivery requires a separately configured persistent host runner, an authorized mailbox, recipient and schedule. No client delivery schedule is activated by connecting the API. OAuth with PKCE is not implemented in this release.

Start with the job.

Use a natural request. Your agent collects the address, market or buyer criteria as needed, then uses the same workflow through REST or MCP.

Help me evaluate a home.

Combine property facts, qualifying sold comparables and market context into an indicative evaluation for review. Canadian evaluations need supplied, authorized sold comparables.

evaluate_home

POST /v1/workflows/home-evaluation

Create my market report.

Discover a supported Canadian geography and create a sourced report that preserves each metric’s actual period and any data gaps.

create_market_report

GET /v1/workflows/market-report

Find homes my buyer will love.

Match buyer criteria, explain the shortlist and prepare an email draft. The optional host runner adds recurring delivery after the sender, recipient and schedule are authorized.

prepare_buyer_list

POST /v1/workflows/buyer-list

Paperwork starts with list_forms and get_deal_schema, followed by validation and a reviewable draft. Read the buyer automation setup guide for schedules, sender authorization, duplicate prevention and delivery controls.

Your account.
Your data access.

Connecting Homies does not grant access to someone else’s listing feed or licensed forms.

1. Connect your Homies account

Use your existing Homies Paperwork key, or create an account. Store the key in your agent’s secure credential settings. Each protected request is validated against your account.

2. Bring your licensed feed access

For licensed listings, sign in to your IDX through chat.homiesai.com, or supply your own authorized DDF keys through secure onboarding arranged with Homies. Feed credentials are separate from your Homies key. Do not send either in a prompt or the Muse review form.

Current API coverage

The unified API currently serves Canadian statistics and U.S. HomeHarvest listings. IDX/DDF feeds are not yet connected to this gateway. Canadian listing search remains unavailable until that integration is enabled; Canadian evaluations can use supplied, authorized sold comparables.

3. Review actions before they go out

Forms depend on publisher permissions and remain unsigned drafts. Buyer tools prepare unsent email drafts. Sending, signing and other external actions require the relevant authorization and connected service.

Connection reference.

Use the live specification for request and response schemas. Discover geography and form IDs before calling a workflow. Keep sources, observation dates, coverage warnings and review requirements in the result.

Missing or invalid keys return 401. Respect rate limits and any Retry-After response. A healthy process does not guarantee every upstream source is available.

Documentation reviewed September 19, 2026 · Gateway v0.2.0. Check live capabilities for current coverage.

REST API base: https://homies-api.vercel.app
MCP · Streamable HTTP: https://homies-api.vercel.app/mcp
OpenAPI specification: https://homies-api.vercel.app/openapi.json
Interactive API reference: https://homies-api.vercel.app/docs
Live capability declaration: https://homies-api.vercel.app/capabilities

Agent setup guide · API privacy & access

Need the full product? Open Homies.

MCP tool catalog

After authenticating and initializing the MCP connection, use tools/list to discover each tool’s current argument schema and annotations. The names below are exact; ? marks an optional argument. Structured search and request objects use the discovered schema. REST request and response schemas are in the linked OpenAPI reference.

search_geographiesRead Arguments: query?: Discover supported Canadian housing markets and their exact geography IDs.
get_housing_seriesRead Arguments: geography, series?, start?, end?: Read housing history with source attribution, dates and units.
get_market_overviewRead Arguments: geography: Read prices, sales, listings and inventory for a supported Canadian market.
get_stats_catalogRead Arguments: dataset?: Discover the available series and coverage in a statistics dataset.
get_stats_seriesRead Arguments: dataset, series, geography?: Read an exact series selected from the statistics catalog.
search_propertiesRead Arguments: search: Search U.S. listings with a structured SearchRequest. Canadian listing search is not enabled.
list_formsRead Arguments: jurisdiction?, board?: Discover the live form catalog and account-specific availability.
get_form_fieldsRead Arguments: form_id, page?: Read a selected form’s fields, source and completion requirements.
get_deal_schemaRead Arguments: section?: Read the transaction input schema before preparing paperwork.
validate_paperworkRead / validate Arguments: request: Validate transaction details and selected forms without creating a PDF.
draft_paperworkWrite Arguments: request: Create private, unsigned draft PDFs after validation and publisher requirements are satisfied.
create_market_reportRead / prepare Arguments: geography: Prepare a sourced market report with each metric’s actual period and freshness warnings.
evaluate_homeRead / prepare Arguments: request: Prepare an indicative evaluation from qualifying sold comparables and explain its limitations.
prepare_buyer_listRead / prepare Arguments: request: Prepare matching homes and an unsent email draft, excluding previously delivered listing IDs supplied by the host.
list_paperwork_operationsRead Arguments: none: Discover the allowlisted paperwork, signback and workflow operations plus their OpenAPI contract.
paperwork_operationRead or write Arguments: method, path, body?, query?, idempotency_key?: Call a discovered operation. GET reads; POST and DELETE can change records, delete files, publish or trigger delivery. Follow the authorization and retry rules below.

Responses, writes and retries

Check both transport and operation results. REST errors include an error object. MCP tool failures set isError: true; inspect the error content and structured result. HTTP 200 or a completed tool call does not prove a transaction or workflow succeeded: inspect valid, draftable and job.status where returned.
Paperwork workflow writes require a stable Idempotency-Key header for POST requests to /v1/paperwork/tools/*, /v1/paperwork/jobs and /v1/paperwork/schedules. For MCP, supply the same value as paperwork_operation.idempotency_key. Keys must be 8–120 printable non-space ASCII characters. Reuse a key only for retries of the same logical operation.
Do not automatically repeat sends or other mutations after an ambiguous response. Reconcile the existing job or provider outcome before retrying, and respect Retry-After when returned. The gateway does not automatically retry mutating paperwork requests.
paperwork_operation may send, publish, delete or accept publisher terms. Obtain the user’s explicit authorization for the applicable action and preserve account and publisher restrictions. A terms-required error remains blocking until the user has reviewed and accepted the returned terms; never accept them automatically to retry a draft.
Use the method and path returned by list_paperwork_operations for the MCP operation. Its paths start with /v1/; the corresponding public REST paths start with /v1/paperwork/. Keep account and feed credentials in secure host settings, outside tool arguments.

Built on the Homies tools you know.

Homies Stats

Homies Paperwork

Homies Search

Ready to share with Meta Muse.

Start with the job.

Help me evaluate a home.

Create my market report.

Find homes my buyer will love.

Your account.Your data access.

1. Connect your Homies account

2. Bring your licensed feed access

Current API coverage

3. Review actions before they go out

Connection reference.

MCP tool catalog

Responses, writes and retries

Your account.
Your data access.