Ucode SMS

No login. Lists prepaid credit packs priced in USDC on Base for autonomous agents/bots (packageId, credits, usd, payTo). Buy one with ucode_agent_buy_credits. Signed-in humans pay by card at https://ucode.uk/app/credits instead (ucode_render_credits).

Autonomous agents: buy a prepaid credit pack with USDC on Base using the x402 protocol — no account or card needed. Step 1: call with {pack, acceptLawfulUse:true} (no paymentHeader) → returns PAYMENT_REQUIRED with exact x402 requirements. Step 2: sign that payment with your x402 wallet and call again with paymentHeader → credits are added and a uc_live_ API key is returned (shown once, also stored for this MCP session). Pack ids come from ucode_agent_billing (aliases: starter, plus, pro). Only spend what the user approved.

Cancel an agent rental when no SMS arrived; credits return to the agent wallet. Requires the uc_live_ API key.

Poll an agent rental for the SMS/OTP. Pass id and pollToken from ucode_agent_rent (or rely on the session API key).

Exact USDC (Base) price to rent ONE number for a service/country without prepaid credits. Use the 'service' code from ucode_find_numbers and a countryId.

Rent one virtual number for a lawful SMS verification. Pays from the agent wallet when a uc_live_ API key is active (from ucode_agent_buy_credits, ucode_agent_use_api_key, or an Authorization: Bearer uc_live_… header on the MCP connection). Without a key it uses pay-per-SMS: first call returns PAYMENT_REQUIRED (x402, USDC on Base); call again with paymentHeader. Returns phone, id and pollToken → then call ucode_agent_check_sms. Signed-in human accounts should use ucode_sms_rent_with_credits instead.

Activate a previously issued uc_live_ agent API key for this MCP session (for clients that cannot set an Authorization header).

Credit balance of the agent wallet behind the active uc_live_ API key.

Combined snapshot (packages, rentals, credit status, settings). Use platform web for ChatGPT (Stripe/crypto web packages); ios/android for native.

Hidden escape hatch: only if the user explicitly already has a mobile Bearer token and asks to use it. Do NOT suggest this for normal sign-in — use ucode_login_start + ucode_login_poll instead.

Starts browser sign-in for the visual card Connect button. Returns linkUrl + sessionId with uiView sign-in. Poll ucode_login_poll until linked.

Free-credit badges / gift breakdown.

Same packs as ucode_render_credits (data). Prefer ucode_render_credits; credits are added on the Ucode website dashboard, never in chat.

Apply a friend's referral code (once per account, only if the referral program is active). Never guess, generate or loop over codes.

Referral code and earnings summary.

Linked wallet — credits are in-app points for renting numbers, not a bank balance. Always say “you have X credits”. After the user adds credits on the dashboard, call this so the ChatGPT card refreshes. Never imply USD wallet unless discussing listed pack prices.

Server-side verify of RevenueCat / store purchase (same as mobile). Requires packageId, transactionId, productId, platform (iOS/Android), and purchaseToken for Android.

Sign out / unlink this ChatGPT conversation from Ucode. Clears the MCP session only (not account deletion). Use when the user asks to sign out, log out, disconnect, or switch accounts. Shows the welcome card with Connect again.

No sign-in needed. Search which apps/services (Telegram, WhatsApp, Google, OpenAI…) have virtual numbers in stock, by country, with the price in Ucode credits. Use this first whenever someone asks for a number or a price. Then: signed-in humans rent with ucode_sms_rent_packages → ucode_sms_rent_with_credits; autonomous agents use ucode_agent_buy_credits / ucode_agent_rent.

Optional natural-language help about Ucode features and flows. Uses the OpenAI key from Panel (Settings → ChatGPT App) when set, else OPENAI_API_KEY on the MCP host. Respects the “AI help” toggle in Panel.

Full product guide (read-only). Not for the first message — use ucode_welcome first. If the user is not signed in, call ucode_welcome / ucode_login_start instead of answering rental questions. Official site https://ucode.uk.

Poll after ucode_login_start. Links the ChatGPT session when the user has finished in the browser — call repeatedly until complete; do not ask users to paste tokens or to type “done” as the only completion signal.

Creates a one-time browser sign-in URL. Prefer the in-card Connect button (ucode_connect). Poll ucode_login_poll(sessionId) until linked.

Public health check against Ucode Panel (no auth). Official downloads and info: https://ucode.uk — do not use unrelated domains (e.g. ucode.io).

Creates a crypto invoice (NOWPayments) for human web/Telegram top-ups. ChatGPT humans should use https://ucode.uk/app/credits instead. Autonomous agents/bots must pay USDC on Base via x402, not NOWPayments.

Poll invoice / payment status by NOWPayments id.

Do not use in ChatGPT. In-card Stripe is blocked. For humans, call ucode_render_credits and open https://ucode.uk/app/credits. For agents/bots, call ucode_agent_billing and pay USDC on Base via x402.

Rare. Resolve fiat display for Stripe IDs — do not read raw prod_/ price_ strings to end users; use ucode_credit_packages for storefront-style copy.

After Checkout completes, pass checkout session id plus packageId so Panel credits the account.

Opens the Add credits card with the current wallet balance. Payments never happen in chat — the user taps through to https://ucode.uk/app/credits. After they add credits there, call ucode_credits_status. No payment details are collected in chat.

Call on the first user message in every new chat. Renders the interactive Ucode card with a Connect Ucode account button. Until linked, only welcome/connect/login tools — never rent or checkout.

Opens the visual service picker (popular apps + search). Call after sign-in or when the user wants a number — same data as ucode_sms_summary but optimized for the in-chat card.

Paginated Ucode service catalog with per-country availability from the Panel database.

Check whether this ChatGPT session is linked to Ucode. Use at chat start; if connected is false, run ucode_render_home — do not process rental requests. If they already have a live number, the card shows it.

Same as ucode_disconnect — unlinks Ucode from this ChatGPT chat. Call for sign out, log out, or disconnect requests.

Active/received rentals with SMS snippets if already fetched.

Cancel an active rental and refund credits when no SMS has arrived. Requires a cancel reason for analytics. Reasons: service_rejected | number_has_account | code_not_arrived | other. If an SMS arrives during cancel, credits stay charged and the code is returned.

Raw worldwide country id table — pairs with legacy APIs only. For renting, use ucode_sms_summary / ucode_sms_service_detail so users pick by country name + credits.

Poll latest SMS for a rental id (provider rental id string).

Avoid for ChatGPT users. Uses backend USD-ish snapshots; assistants must guide rentals via credits-only summaries (ucode_sms_summary, ucode_sms_service_detail) and ucode_sms_rent_packages. Responses are partially sanitized.

Trigger server-side refund scan for expired rentals (same as app).

After user picks serviceCode + country (numeric id from summary/detail), list credit-priced routes only. Same package picker as the app (rentalFlowVersion 2). Present credits, recommended badge, labels — never quote USD or backend provider names.

Do not use for ChatGPT end users. Legacy rental against upstream balances — skips normal credit UX and exposes provider-era assumptions. Only ucode_sms_rent_with_credits with packages.

Primary rental — charges Ucode credits. Always use rentalFlowVersion: 2 and packageId from ucode_sms_rent_packages (matches mobile). Never mention wholesale/provider IDs or dollar amounts to the user.

Load one service’s countries after you have its short serviceCode (from summary service field). Matches opening that service in the iOS/Android app: availability, credits per country. Prefer over legacy /prices APIs.

Low-level provider service codes — exposes internal naming. Do NOT use for normal rentals; prefer ucode_sms_summary or ucode_sms_service_detail then credits-only packages.

Primary discovery: search by app/service name (e.g. Telegram, WhatsApp). Returns services with countries, credits only (no provider names / no USD in assistant copy). Same idea as the app Services tab. Then ucode_sms_service_detail or go straight to ucode_sms_rent_packages once service + country are chosen.

Provider ledger audit trail — sanitized before ChatGPT. Prefer explaining rentals via ucode_sms_active_rentals for users.

Same as ucode_render_home — product summary + sign-in card. Prefer ucode_render_home on first message.

Current linked Ucode user (requires ucode_login_poll complete or ucode_authenticate).