# HMS x402 Data Origins (RE Data Refinery + Storefront)

> HMS x402 Data Origins (RE Data Refinery + Storefront) is a paid MCP server for analytics and data. Pay-per-call MCP server for Ohio property records, foreclosures and car-rental rates. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Repository:** https://github.com/areshms/hms-mcp
- **MCP Registry name:** io.github.areshms/hms-mcp
- **Categories:** [analytics and data](https://ai-powered.com/categories/analytics-and-data), [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-14

## About

Two separate data services sit behind this one endpoint: a real-estate data refinery focused on Ohio and a storefront service with car-rental rates by city. Free tools report health, coverage and credits, while data tools return an x402 payment challenge first.

There are no API keys or wallets inside the server. A paid call returns the origin's HTTP 402 payload (USDC on Base); an x402-capable client settles it and repeats the same call with the payment header value in an x402_payment parameter. The README states the wrapper never holds funds.

Per-call prices in the README range from $0.02 for price, tax and school history to $0.05 for searches and foreclosure, tax-sale, auction and pre-foreclosure lists (19 Ohio counties), and $0.50 to $2.50 for cash-buyer data. Runs as a Cloudflare Worker under the MIT licence.

## Features

- **Property search and detail:** Search properties, filter by city and fetch a record by its zpid.
- **Price, tax and school history:** Separate tools return price history, tax history and nearby schools for a property.
- **Distressed property lists:** Foreclosures, tax sales, auctions and pre-foreclosures by county.
- **Cash buyer data:** A premium tool priced from $0.50 to $2.50 per call.
- **Car-rental rates:** A storefront tool returns rental rates for a city.
- **Tokenless x402 payment:** Paid calls surface a USDC-on-Base challenge instead of requiring an API key.

## Good for

- Pull foreclosure and auction lists for an Ohio county
- Look up a property's tax and price history
- Compare car-rental rates in a city
- Check coverage and record counts before paying for data

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hms-mcp https://hms-mcp.ares-hms.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://hms-mcp.ares-hms.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hms-mcp": {
      "url": "https://hms-mcp.ares-hms.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hms-mcp": {
      "type": "http",
      "url": "https://hms-mcp.ares-hms.workers.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hms-mcp": {
      "serverUrl": "https://hms-mcp.ares-hms.workers.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hms-mcp": {
      "type": "http",
      "url": "https://hms-mcp.ares-hms.workers.dev/mcp"
    }
  }
}
```

## Tools

- `refinery_search`: Search the real-estate data (about $0.05 per call).
- `refinery_properties`: List properties filtered by city.
- `refinery_properties_zpid`: Fetch one property by zpid.
- `refinery_properties_zpid_price_history`: Price history for a property.
- `refinery_properties_zpid_tax_history`: Tax history for a property.
- `refinery_properties_zpid_schools`: Schools for a property.
- `refinery_foreclosures`: Foreclosure listings.
- `refinery_tax_sales`: Tax sale listings.
- `refinery_auctions`: Auction listings.
- `refinery_preforeclosures`: Pre-foreclosures by county across 19 Ohio counties.
- `refinery_cash_buyers`: Cash buyer data.
- `refinery_coverage`: Free coverage and record counts.
- `refinery_credits`: Free credits lookup.
- `sf_v1_rental_rates`: Car-rental rates for a city.
- `hms_get_origins`: Lists the origins and the payment flow.

## FAQ

### Do I need an API key?

No. The README calls it tokenless: free tools answer directly and paid tools return an x402 payment challenge.

### What currency is used for payment?

USDC on Base, settled with an x402 client.

### How do I retry after paying?

Call the same tool again with the same parameters and pass the produced header value as x402_payment.

### Are there known client issues?

The README says Cloudflare blocks the bare Python-urllib user agent on workers.dev hosts; any normal User-Agent works.

### Is HMS x402 Data Origins (RE Data Refinery + Storefront) free?

No. HMS x402 Data Origins (RE Data Refinery + Storefront) is a paid product.

### How do I add HMS x402 Data Origins (RE Data Refinery + Storefront) to Claude Code?

Run this command in your terminal: claude mcp add --transport http hms-mcp https://hms-mcp.ares-hms.workers.dev/mcp

### What are the best alternatives to HMS x402 Data Origins (RE Data Refinery + Storefront)?

The closest alternatives to HMS x402 Data Origins (RE Data Refinery + Storefront) are Horizon Pulse, Money Reactor, Money Reactor, cryptofeed402 and Scrapling x402 Data Store.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Horizon Pulse](https://ai-powered.com/mcp/horizon-pulse): Horizon Pulse is a paid MCP server for finance and payments.
- [Money Reactor](https://ai-powered.com/mcp/money-reactor-2): Money Reactor is a paid MCP server for finance and payments.
- [Money Reactor](https://ai-powered.com/mcp/money-reactor-3): Money Reactor is a paid MCP server for finance and payments.
- [cryptofeed402](https://ai-powered.com/mcp/cryptofeed402): cryptofeed402 is a paid MCP server for finance and payments.
- [Scrapling x402 Data Store](https://ai-powered.com/mcp/scrapling-x402-data-store): Scrapling x402 Data Store is a paid MCP server for finance and payments.
- [Mercury402: Treasury/FRED financial data over x402](https://ai-powered.com/mcp/mercury402-treasury-fred-financial-data-over-x402): Mercury402: Treasury/FRED financial data over x402 is a paid MCP server for finance and payments.
- [x402 Ethereum RPC](https://ai-powered.com/mcp/x402-ethereum-rpc): x402 Ethereum RPC is a paid MCP server for finance and payments.
- [Block402](https://ai-powered.com/mcp/block402): Block402 is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/hms-x402-data-origins-re-data-refinery-storefront
