> Fetch https://askmiles.ai/llms.txt first: it indexes every public Miles capability. This file is the markdown twin of https://askmiles.ai/docs/mcp/tools/transfer-partners.

# Transfer partners

Transfer partner routes and ratios, point valuations, and running a transfer plan against a member's balances.

### compare_transfer_options

What a balance of `points` is worth across transfer paths, with the arithmetic shown -- the points-quantity question, distinct from `get_transfer_partners` (which lists WHICH paths exist, not what YOUR points are worth). Call `program` only (from), `target` only (to), or both (one specific path, e.g. 60k UR → Hyatt).

| Scope | Quota |
| --- | --- |
| `miles:read` | standard |

| Name | Type | Required |
| --- | --- | --- |
| `points` | `integer` | required |
| `program` | `string` |  |
| `target` | `string` |  |

### get_transfer_partners

Transfer partner lookup. mode='from_program' lists where a currency (e.g. 'Chase Ultimate Rewards') transfers; 'to_program' lists which currencies reach a destination (e.g. 'World of Hyatt'); 'auto' infers.

| Scope | Quota |
| --- | --- |
| `miles:read` | standard |

| Name | Type | Required |
| --- | --- | --- |
| `query` | `string` | required |
| `mode` | `string` |  |

### get_valuations

Point valuations (cents per point) — the user's custom values when set, defaults otherwise.

| Scope | Quota |
| --- | --- |
| `miles:read` | standard |

| Name | Type | Required |
| --- | --- | --- |
| `programs` | `string[]` |  |

### plan_transfer

"I need N points at program X -- which of my HELD currencies gets me there cheapest?" The advisor flagship: ranks the loyalty currencies you've told Miles you hold (`get_balances`) by cheapest path to `target_program` -- transfer graph x ratios x active bonuses x transfer minimums/increments x your own valuations -- including two-currency split suggestions and "you hold it but not enough" rows. Deterministic, receipt-style, built on the same functions `compare_transfer_options` uses, so the two tools cannot disagree about a shared leg.

| Scope | Quota |
| --- | --- |
| `miles:read` | standard |

| Name | Type | Required |
| --- | --- | --- |
| `target_program` | `string` | required |
| `points_needed` | `integer` | required |

### portfolio_review

"Here are my balances -- where should I focus?" Ranks every loyalty currency the member has told Miles they hold against a redemption goal, and says which one to focus on, which to stop growing, and why.

| Scope | Quota |
| --- | --- |
| `miles:read` | standard |

| Name | Type | Required |
| --- | --- | --- |
| `goal` | `string` |  |
| `cardholder` | `string` |  |

### reset_valuation

Reset a custom valuation back to the Ask Miles default. Requires wallet-change access.

| Scope | Quota |
| --- | --- |
| `miles:write` | standard |

| Name | Type | Required |
| --- | --- | --- |
| `point_type` | `string` | required |

### set_valuation

Set the user's custom point/mile valuations (cents per point). Pass `valuations` to set several at once. Requires wallet-change access.

| Scope | Quota |
| --- | --- |
| `miles:write` | standard |

| Name | Type | Required |
| --- | --- | --- |
| `point_type` | `string` |  |
| `valuation` | `number` |  |
| `valuations` | `object` |  |