# Errors & Limits

Canonical URL: https://doc.roote.ai/roote-mcp/errors-and-limits



ROOTE MCP validates every `tools/call` against the schema returned by `tools/list`.

## Validation errors [#validation-errors]

A call can fail when a required argument is missing, a coordinate is invalid, only one coordinate in a pair is supplied, a limit is exceeded, an unknown property is included, or an upstream capability is unavailable.

Tool errors are returned as MCP results marked as errors. Preserve the reported code and message rather than inventing a successful answer.

## Operational limits [#operational-limits]

| Tool              | Key limits                                             |
| ----------------- | ------------------------------------------------------ |
| `geocode`         | `q` 1–200; language 1–35; country two letters          |
| `place_search`    | `q` 1–200; valid `lat` and `lon` together              |
| `reverse_geocode` | Required valid `lat` and `lon`; language 1–35          |
| `nearby`          | Radius maximum 400 m; limit maximum 100; four modes    |
| `services_nearby` | Radius maximum 1,500 m; limit maximum 200; seven types |

REST and MCP schemas are separate contracts. Do not pass REST-only parameters to a tool.

## Authentication transition [#authentication-transition]

The target model uses the ROOTE developer token. The current public deployment may still accept unauthenticated calls. OAuth is not currently required.