Token costs
Every billable request consumes tokens. The cost is fixed per endpoint and
identical whether you call it over the REST API or as an
MCP tool. Each response reports its exact cost in the
X-Tokens-Used header.
Per-endpoint cost
Section titled “Per-endpoint cost”| Endpoint | MCP tool | Token cost |
|---|---|---|
| Market stats | get_market_stats | 10 |
| Property details | get_property | 10 |
| AI comp value | get_property_ai_comp_value | 10 |
| Property search | search_properties | 10 |
| Parcel filter | filter_properties | 30 |
| Comps | list_comps | 1 per returned comp |
| Saved markets — list | list_saved_markets | 0 |
| Saved markets — save | save_market | 0 |
| Saved markets — remove | unsave_market | 0 |
| Usage | get_usage | 0 |
| Usage breakdown | get_usage_breakdown | 0 |
The zero-cost rule
Section titled “The zero-cost rule”Empty results and errors cost 0 tokens. A search that matches nothing, a
404, a validation error, or a rate-limit 429 all report X-Tokens-Used: 0.
For list_comps, cost scales with the
number of comps actually returned — a page of 50 comps costs 50 tokens, an empty
page costs 0.
Dollar pricing and tiers
Section titled “Dollar pricing and tiers”This page covers token costs, not dollars. How many tokens your plan includes, overage rates, and subscription-tier pricing live in the Land Insights app:
- Plans & billing — your tier, included tokens, and pricing.
To see tokens you’ve already spent this period, use the free usage endpoints.