Read Cached Result Page
get_cached_resultFetch one page of a previously returned IP geolocation result by cursor, with no credits or upstream API calls; join JSON fragments to rebuild the original structured result.
Instructions
Returns one page of a previously returned result using page.cursor or page.next_cursor. Costs 0 credits and never calls any upstream API, including on failure. The json_fragment strings concatenate in offset order into the complete original structuredContent JSON, including nested arrays and bulk item errors. The last page has no next_cursor. Cursors are scoped to the same API key and server process. Successful reads extend idle expiry by the configured cache TTL (five minutes by default); eviction or restart can remove a result. An unavailable cursor returns a local error and never starts another paid lookup.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cursor": "<cursor>"
},
"name": "get_cached_result"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | Yes | Opaque cursor returned in page.cursor or page.next_cursor. Retrieval requires the same server process and API key and does not repeat the original lookup. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| error | No |