RE Data Refinery MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| X402_SPEND_CAP | No | Optional x402 spend cap (default $1 per payment) | $1 |
| EVM_PRIVATE_KEY | No | Required for paid x402 endpoints | |
| REFINERY_BASE_URL | No | Optional: override the worker or local API URLs | https://re-data-refinery.ares-hms.workers.dev |
| REFINERY_LOCAL_URL | No | Optional: override the local API URL | http://localhost:5004 |
| REFINERY_ENABLE_X402 | No | Set to false to disable payments and use the free local API | true |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| refinery_healthA | Check the RE Data Refinery API health and cache status. Returns status, cached property count, and rate limit information. This is a free endpoint and does not require x402 payment. |
| refinery_cache_statsB | Get cache statistics for the Refinery data store. Returns total cached properties, last update time, and agent-funded count. Free endpoint. |
| refinery_creditsA | Check remaining ZillAPI credit balance. Free endpoint that returns the upstream ZillAPI credit balance. |
| refinery_search_propertiesA | Search for scored Columbus, OH properties using natural language terms. This is a paid lookup ($0.50 via x402) unless REFINERY_ENABLE_X402=false. Results are written through to the Refinery cache. |
| refinery_list_propertiesA | List scored properties by city with optional price filtering. Set live=true (default) to query ZillAPI live data ($0.35 via x402). Set live=false to read cached data only (free, no payment required). |
| refinery_get_propertyA | Get full scored details for a single property by ZPID. This is a paid lookup ($0.35 via x402) unless REFINERY_ENABLE_X402=false. Includes price/tax/school enrichment and Refinery scores. |
| refinery_get_price_historyA | Get the price-history timeline for a property by ZPID. Paid lookup ($0.25 via x402) unless REFINERY_ENABLE_X402=false. |
| refinery_get_tax_historyA | Get the tax/assessment history for a property by ZPID. Paid lookup ($0.25 via x402) unless REFINERY_ENABLE_X402=false. |
| refinery_get_schoolsA | Get the school ratings near a property by ZPID. Paid lookup ($0.25 via x402) unless REFINERY_ENABLE_X402=false. |
| refinery_payment_statusA | Show whether x402 automatic payments are configured and the active API base URL. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Most tools target distinct concerns: status/health, payment, property search/list, and specific property data lookups. The only mild overlap is between refinery_search_properties and refinery_list_properties, but their different input modes and purposes make them reasonably distinguishable.
All tools share the refinery_ prefix and use snake_case, which creates a clear family identity. However, the status-style tools use bare nouns (health, cache_stats, credits, payment_status) while data tools use verb_noun forms, so the pattern is not perfectly uniform.
Ten tools is well-scoped for a property data refinery server: a few operational/status endpoints, general search/list capabilities, and individual data detail lookups. Each tool has a clear role without the surface feeling bloated or thin.
The tool set covers the full read-side property workflow: discover properties by search or listing, retrieve full details, and access price history, tax history, and schools. It also includes operational endpoints for health, cache stats, credits, and payment configuration, so there are no obvious dead ends.