get_ai_tokens_pay_link
Get a real, payable Machine Payment Protocol (MPP) URL to top up AI Tokens ($0.10/token) — for use with an MPP-native payment agent (e.g. Stripe's link-cli), NOT with buy_ai_tokens's own payment flow (that tool's challenge cannot be paid by an external MPP agent). Use this ONLY when an MPP-native agent's tools (e.g. link-cli's mpp_pay) are available in this session.
PAYMENT PRIORITY: this is priority 2 for AI Tokens — reach for it only after buy_ai_tokens's own in-band payment flow (priority 1) isn't viable (no payment_token available from your own platform), and only when link-cli is present. Always hand over the exact server-computed pay_url/price returned here — never estimate or recompute the amount yourself. There is no checkout-link fallback for AI Tokens.
Returns a pay_url that a real HTTP 402 challenge is served from — hand it directly to the MPP agent's pay tool (e.g. mpp_pay) rather than fetching or decoding it yourself.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token_count | Yes | Number of AI Tokens to purchase (5-100000; 5 is the $0.50 minimum). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| price | No | ||
| pay_url | Yes | Real MPP-payable URL — hand this to an MPP agent, do not fetch it yourself. | |
| success | Yes | ||
| currency | No | ||
| expires_at | No | ||
| token_count | Yes |