Ucode SMS is an MCP server published by uk.ucode, hosted at mcp.ucodesim.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 50 tools, including ucode_render_home, ucode_render_services, ucode_welcome, ucode_session_status, ucode_panel_ping.
Virtual phone numbers for SMS/OTP verification. Browse free; pay with credits or USDC (x402).
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
**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.
No parameters.
{
"name": "ucode_render_home",
"title": "Home (visual card)",
"description": "**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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | number | |
| search | string |
{
"name": "ucode_render_services",
"title": "Browse apps (visual picker)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number"
},
"search": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Same as **ucode_render_home** — product summary + sign-in card. Prefer **ucode_render_home** on first message.
No parameters.
{
"name": "ucode_welcome",
"title": "Welcome (start here)",
"description": "Same as **ucode_render_home** — product summary + sign-in card. Prefer **ucode_render_home** on first message.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "ucode_session_status",
"title": "Session status",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Public health check against Ucode Panel (no auth). Official downloads and info: https://ucode.uk — do not use unrelated domains (e.g. ucode.io).
No parameters.
{
"name": "ucode_panel_ping",
"title": "Panel API ping",
"description": "Public health check against Ucode Panel (no auth). Official downloads and info: https://ucode.uk — do not use unrelated domains (e.g. ucode.io).",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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**).
No parameters.
{
"name": "ucode_agent_billing",
"title": "Agent credits (USDC on Base)",
"description": "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**).",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "ucode_instructions",
"title": "Ucode user guide",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| question * | string | User question about Ucode apps, credits, rentals, SMS codes, etc. |
{
"name": "ucode_help",
"title": "Ucode help (AI)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"question"
],
"properties": {
"question": {
"type": "string",
"maxLength": 2000,
"minLength": 4,
"description": "User question about Ucode apps, credits, rentals, SMS codes, etc."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Starts browser sign-in for the visual card **Connect** button. Returns linkUrl + sessionId with uiView sign-in. Poll **ucode_login_poll** until linked.
No parameters.
{
"name": "ucode_connect",
"title": "Connect account (in-card button)",
"description": "Starts browser sign-in for the visual card **Connect** button. Returns linkUrl + sessionId with uiView sign-in. Poll **ucode_login_poll** until linked.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Creates a one-time browser sign-in URL. Prefer the in-card **Connect** button (**ucode_connect**). Poll **ucode_login_poll(sessionId)** until linked.
No parameters.
{
"name": "ucode_login_start",
"title": "Sign in with browser (recommended)",
"description": "Creates a one-time browser sign-in URL. Prefer the in-card **Connect** button (**ucode_connect**). Poll **ucode_login_poll(sessionId)** until linked.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| sessionId * | string | sessionId returned by ucode_login_start |
{
"name": "ucode_login_poll",
"title": "Finish browser sign-in",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sessionId"
],
"properties": {
"sessionId": {
"type": "string",
"minLength": 16,
"description": "sessionId returned by ucode_login_start"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| accessToken * | string | Developer only: mobile app Bearer token — never ask end users to paste this for normal login |
{
"name": "ucode_authenticate",
"title": "Link Ucode account (developer / mobile token only)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"accessToken"
],
"properties": {
"accessToken": {
"type": "string",
"minLength": 20,
"description": "Developer only: mobile app Bearer token — never ask end users to paste this for normal login"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Current linked Ucode user (requires ucode_login_poll complete or ucode_authenticate).
No parameters.
{
"name": "ucode_whoami",
"title": "Who am I",
"description": "Current linked Ucode user (requires ucode_login_poll complete or ucode_authenticate).",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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 parameters.
{
"name": "ucode_disconnect",
"title": "Disconnect from ChatGPT",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Same as **ucode_disconnect** — unlinks Ucode from this ChatGPT chat. Call for sign out, log out, or disconnect requests.
No parameters.
{
"name": "ucode_sign_out",
"title": "Sign out",
"description": "Same as **ucode_disconnect** — unlinks Ucode from this ChatGPT chat. Call for sign out, log out, or disconnect requests.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "ucode_credits_status",
"title": "Credit balance",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Opens the **Add credits** card with the current wallet balance. Payments never happen in chat — show the balance and link to **https://ucode.uk/pricing** (informational). After they add credits on the website, call **ucode_credits_status**. No payment details are collected in chat.
No parameters.
{
"name": "ucode_render_credits",
"title": "Buy credits (visual picker)",
"description": "Opens the **Add credits** card with the current wallet balance. Payments never happen in chat — show the balance and link to **https://ucode.uk/pricing** (informational). After they add credits on the website, call **ucode_credits_status**. No payment details are collected in chat.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Same packs as **ucode_render_credits** (data). Prefer **ucode_render_credits**; credits are added on the Ucode website dashboard, never in chat.
No parameters.
{
"name": "ucode_credit_packages",
"title": "List credit packages",
"description": "Same packs as **ucode_render_credits** (data). Prefer **ucode_render_credits**; credits are added on the Ucode website dashboard, never in chat.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Free-credit badges / gift breakdown.
No parameters.
{
"name": "ucode_credit_gift_breakdown",
"title": "Gift credits breakdown",
"description": "Free-credit badges / gift breakdown.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Referral code and earnings summary.
No parameters.
{
"name": "ucode_credit_referral_stats",
"title": "Referral stats",
"description": "Referral code and earnings summary.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Apply a friend's referral code (once per account, only if the referral program is active). Never guess, generate or loop over codes.
| Parameter | Type | Description |
|---|---|---|
| code * | string |
{
"name": "ucode_credit_referral_redeem",
"title": "Redeem referral code",
"description": "Apply a friend's referral code (once per account, only if the referral program is active). Never guess, generate or loop over codes.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 20,
"minLength": 4
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}**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.
| Parameter | Type | Description |
|---|---|---|
| priceIds * | string | Comma-separated Stripe price_… or prod_… IDs |
{
"name": "ucode_payments_stripe_prices",
"title": "Stripe price lookup",
"description": "**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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"priceIds"
],
"properties": {
"priceIds": {
"type": "string",
"description": "Comma-separated Stripe price_… or prod_… IDs"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}**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.
| Parameter | Type | Description |
|---|---|---|
| cancelUrl | string | |
| packageId * | string | Exact packageId from ucode_credit_packages for the pack the user chose |
| returnUrl | string | Success URL; default deep link if omitted |
| stripeProductId | string | Legacy override — omit; Panel maps Stripe from packageId. |
{
"name": "ucode_payments_stripe_create_checkout",
"title": "Create Stripe checkout",
"description": "**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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packageId"
],
"properties": {
"cancelUrl": {
"type": "string"
},
"packageId": {
"type": "string",
"description": "Exact packageId from ucode_credit_packages for the pack the user chose"
},
"returnUrl": {
"type": "string",
"description": "Success URL; default deep link if omitted"
},
"stripeProductId": {
"type": "string",
"description": "Legacy override — omit; Panel maps Stripe from packageId."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}After Checkout completes, pass checkout **session id** plus **packageId** so Panel credits the account.
| Parameter | Type | Description |
|---|---|---|
| packageId * | string | |
| sessionId * | string |
{
"name": "ucode_payments_stripe_verify",
"title": "Verify Stripe checkout",
"description": "After Checkout completes, pass checkout **session id** plus **packageId** so Panel credits the account.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sessionId",
"packageId"
],
"properties": {
"packageId": {
"type": "string"
},
"sessionId": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| platform | string | one of ["web","ios","android","telegram"] |
| cancelUrl | string | |
| packageId * | string | |
| returnUrl | string |
{
"name": "ucode_payments_nowpayments_create",
"title": "Create crypto (NOWPayments) invoice",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packageId"
],
"properties": {
"platform": {
"enum": [
"web",
"ios",
"android",
"telegram"
],
"type": "string"
},
"cancelUrl": {
"type": "string"
},
"packageId": {
"type": "string"
},
"returnUrl": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Poll invoice / payment status by NOWPayments id.
| Parameter | Type | Description |
|---|---|---|
| paymentId * | string |
{
"name": "ucode_payments_nowpayments_status",
"title": "NOWPayments payment status",
"description": "Poll invoice / payment status by NOWPayments id.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"paymentId"
],
"properties": {
"paymentId": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Server-side verify of RevenueCat / store purchase (same as mobile). Requires packageId, transactionId, productId, platform (iOS/Android), and purchaseToken for Android.
| Parameter | Type | Description |
|---|---|---|
| platform * | string | one of ["iOS","Android"] |
| packageId * | string | |
| productId * | string | |
| purchaseToken | string | |
| transactionId * | string |
{
"name": "ucode_credits_verify_app_store_purchase",
"title": "Verify App Store / Play purchase",
"description": "Server-side verify of RevenueCat / store purchase (same as mobile). Requires packageId, transactionId, productId, platform (iOS/Android), and purchaseToken for Android.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packageId",
"transactionId",
"productId",
"platform"
],
"properties": {
"platform": {
"enum": [
"iOS",
"Android"
],
"type": "string"
},
"packageId": {
"type": "string"
},
"productId": {
"type": "string"
},
"purchaseToken": {
"type": "string"
},
"transactionId": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Paginated Ucode service catalog with per-country availability from the Panel database.
| Parameter | Type | Description |
|---|---|---|
| page | number | |
| limit | number | |
| search | string | |
| sortBy | string | |
| sortOrder | string | one of ["asc","desc"] |
{
"name": "ucode_services_catalog",
"title": "Services catalog (DB)",
"description": "Paginated Ucode service catalog with per-country availability from the Panel database.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"search": {
"type": "string"
},
"sortBy": {
"type": "string"
},
"sortOrder": {
"enum": [
"asc",
"desc"
],
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "ucode_sms_services",
"title": "SMS provider services",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "ucode_sms_countries",
"title": "SMS countries",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}**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.
| Parameter | Type | Description |
|---|---|---|
| country | number | |
| minutes | number | |
| service | string |
{
"name": "ucode_sms_prices",
"title": "SMS prices & stock (legacy)",
"description": "**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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"country": {
"type": "number"
},
"minutes": {
"type": "number"
},
"service": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| v | any | |
| page | number | |
| limit | number | |
| search | string | |
| sortBy | string | |
| sortOrder | string | one of ["asc","desc"] |
{
"name": "ucode_sms_summary",
"title": "SMS services summary",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"v": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
}
]
},
"page": {
"type": "number"
},
"limit": {
"type": "number"
},
"search": {
"type": "string"
},
"sortBy": {
"type": "string"
},
"sortOrder": {
"enum": [
"asc",
"desc"
],
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| serviceCode * | string | Short code, e.g. tg, wa, fb — same as mobile app service id |
{
"name": "ucode_sms_service_detail",
"title": "Service detail (countries, credits)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"serviceCode"
],
"properties": {
"serviceCode": {
"type": "string",
"minLength": 1,
"description": "Short code, e.g. tg, wa, fb — same as mobile app service id"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| country * | number | |
| service * | string |
{
"name": "ucode_sms_rent_packages",
"title": "Rent packages (flow v2)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"service",
"country"
],
"properties": {
"country": {
"type": "number"
},
"service": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}**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.
| Parameter | Type | Description |
|---|---|---|
| country * | number | |
| service * | string | |
| packageId | string | |
| clientCredits | number | |
| rentalFlowVersion | any | Use **2** (default flow); matches mobile package picker. |
{
"name": "ucode_sms_rent_with_credits",
"title": "Rent number (credits)",
"description": "**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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"service",
"country"
],
"properties": {
"country": {
"type": "number"
},
"service": {
"type": "string"
},
"packageId": {
"type": "string"
},
"clientCredits": {
"type": "number"
},
"rentalFlowVersion": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
}
],
"description": "Use **2** (default flow); matches mobile package picker."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}**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.
| Parameter | Type | Description |
|---|---|---|
| country | number | |
| service * | string |
{
"name": "ucode_sms_rent_provider_direct",
"title": "Rent number (provider balance)",
"description": "**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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"service"
],
"properties": {
"country": {
"type": "number"
},
"service": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Active/received rentals with SMS snippets if already fetched.
No parameters.
{
"name": "ucode_sms_active_rentals",
"title": "Active rentals",
"description": "Active/received rentals with SMS snippets if already fetched.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Poll latest SMS for a rental id (provider rental id string).
| Parameter | Type | Description |
|---|---|---|
| rentalId * | string |
{
"name": "ucode_sms_get_code",
"title": "Get SMS / OTP",
"description": "Poll latest SMS for a rental id (provider rental id string).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"rentalId"
],
"properties": {
"rentalId": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| reason * | string | one of ["service_rejected","number_has_account","code_not_arrived","other"] |
| rentalId * | string | |
| reasonNote | string |
{
"name": "ucode_sms_cancel_rental",
"title": "Cancel rental",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"rentalId",
"reason"
],
"properties": {
"reason": {
"enum": [
"service_rejected",
"number_has_account",
"code_not_arrived",
"other"
],
"type": "string"
},
"rentalId": {
"type": "string"
},
"reasonNote": {
"type": "string",
"maxLength": 280
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Trigger server-side refund scan for expired rentals (same as app).
No parameters.
{
"name": "ucode_sms_refund_expired",
"title": "Refund expired rentals",
"description": "Trigger server-side refund scan for expired rentals (same as app).",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Provider ledger audit trail — sanitized before ChatGPT. Prefer explaining rentals via **ucode_sms_active_rentals** for users.
No parameters.
{
"name": "ucode_sms_transactions",
"title": "SMS transaction history",
"description": "Provider ledger audit trail — sanitized before ChatGPT. Prefer explaining rentals via **ucode_sms_active_rentals** for users.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Combined snapshot (packages, rentals, credit status, settings). Use platform web for ChatGPT (Stripe/crypto web packages); ios/android for native.
| Parameter | Type | Description |
|---|---|---|
| platform | string | one of ["android","ios","web"] |
{
"name": "ucode_app_init_snapshot",
"title": "App init snapshot",
"description": "Combined snapshot (packages, rentals, credit status, settings). Use platform web for ChatGPT (Stripe/crypto web packages); ios/android for native.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"platform": {
"enum": [
"android",
"ios",
"web"
],
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok",
"summary"
],
"properties": {
"ok": {
"type": "boolean"
},
"code": {
"type": "string"
},
"data": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"phone": {
"type": "string"
},
"uiView": {
"type": "string"
},
"credits": {
"type": "number"
},
"endDate": {
"type": "string"
},
"smsCode": {
"type": "string"
},
"summary": {
"type": "string"
},
"rentalId": {
"type": "string"
},
"billingUrl": {
"type": "string"
},
"httpStatus": {
"type": "number"
},
"countryName": {
"type": "string"
},
"phoneNumber": {
"type": "string"
},
"serviceName": {
"type": "string"
},
"neededCredits": {
"type": "number"
},
"providerRentalId": {
"type": "string"
},
"remainingSeconds": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max countries per service (default 15) |
| search * | string | App or service name, e.g. telegram, whatsapp, openai |
| country | string | Optional country name or ISO code filter, e.g. 'United Kingdom' or 'gb' |
{
"name": "ucode_find_numbers",
"title": "Find numbers & prices (no login)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"search"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max countries per service (default 15)"
},
"search": {
"type": "string",
"minLength": 1,
"description": "App or service name, e.g. telegram, whatsapp, openai"
},
"country": {
"type": "string",
"description": "Optional country name or ISO code filter, e.g. 'United Kingdom' or 'gb'"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| country | any | countryId, ISO code or country name |
| service * | string | Service code from ucode_find_numbers, e.g. tg, wa |
{
"name": "ucode_agent_quote",
"title": "Pay-per-SMS USDC quote (no login)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"service"
],
"properties": {
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
],
"description": "countryId, ISO code or country name"
},
"service": {
"type": "string",
"description": "Service code from ucode_find_numbers, e.g. tg, wa"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| pack * | string | packageId from ucode_agent_billing, or starter / plus / pro |
| paymentHeader | string | Base64 x402 payment payload (the X-PAYMENT header value) for step 2 |
| acceptLawfulUse * | boolean | Must be true — lawful verification, QA, travel or privacy use only |
{
"name": "ucode_agent_buy_credits",
"title": "Buy credits with USDC on Base (x402)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pack",
"acceptLawfulUse"
],
"properties": {
"pack": {
"type": "string",
"description": "packageId from ucode_agent_billing, or starter / plus / pro"
},
"paymentHeader": {
"type": "string",
"description": "Base64 x402 payment payload (the X-PAYMENT header value) for step 2"
},
"acceptLawfulUse": {
"type": "boolean",
"description": "Must be true — lawful verification, QA, travel or privacy use only"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| apiKey | string | uc_live_… key if not already active in this session |
| country | any | countryId (preferred), ISO code or name |
| purpose * | string | Why the number is needed |
| service * | string | Service code from ucode_find_numbers, e.g. tg |
| paymentHeader | string | x402 X-PAYMENT value for pay-per-SMS |
| acceptLawfulUse * | boolean | Must be true |
{
"name": "ucode_agent_rent",
"title": "Rent a number (agent: API key or pay-per-SMS)",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"service",
"purpose",
"acceptLawfulUse"
],
"properties": {
"apiKey": {
"type": "string",
"description": "uc_live_… key if not already active in this session"
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
],
"description": "countryId (preferred), ISO code or name"
},
"purpose": {
"enum": [
"qa",
"privacy",
"travel",
"business"
],
"type": "string",
"description": "Why the number is needed"
},
"service": {
"type": "string",
"description": "Service code from ucode_find_numbers, e.g. tg"
},
"paymentHeader": {
"type": "string",
"description": "x402 X-PAYMENT value for pay-per-SMS"
},
"acceptLawfulUse": {
"type": "boolean",
"description": "Must be true"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Poll an agent rental for the SMS/OTP. Pass id and pollToken from ucode_agent_rent (or rely on the session API key).
| Parameter | Type | Description |
|---|---|---|
| id * | string | activation id |
| pollToken | string |
{
"name": "ucode_agent_check_sms",
"title": "Check SMS for an agent rental",
"description": "Poll an agent rental for the SMS/OTP. Pass id and pollToken from ucode_agent_rent (or rely on the session API key).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "activation id"
},
"pollToken": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Credit balance of the agent wallet behind the active uc_live_ API key.
| Parameter | Type | Description |
|---|---|---|
| apiKey | string |
{
"name": "ucode_agent_wallet",
"title": "Agent wallet balance",
"description": "Credit balance of the agent wallet behind the active uc_live_ API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"apiKey": {
"type": "string"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Activate a previously issued uc_live_ agent API key for this MCP session (for clients that cannot set an Authorization header).
| Parameter | Type | Description |
|---|---|---|
| apiKey * | string |
{
"name": "ucode_agent_use_api_key",
"title": "Use an existing agent API key",
"description": "Activate a previously issued uc_live_ agent API key for this MCP session (for clients that cannot set an Authorization header).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"apiKey"
],
"properties": {
"apiKey": {
"type": "string",
"pattern": "^uc_live_.*"
}
}
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Cancel an agent rental when no SMS arrived; credits return to the agent wallet. Requires the uc_live_ API key.
| Parameter | Type | Description |
|---|---|---|
| id * | string | |
| reason * | string | one of ["service_rejected","number_has_account","code_not_arrived","other"] |
| reasonNote | string |
{
"name": "ucode_agent_cancel",
"title": "Cancel an agent rental (refund credits)",
"description": "Cancel an agent rental when no SMS arrived; credits return to the agent wallet. Requires the uc_live_ API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"reason"
],
"properties": {
"id": {
"type": "string"
},
"reason": {
"enum": [
"service_rejected",
"number_has_account",
"code_not_arrived",
"other"
],
"type": "string"
},
"reasonNote": {
"type": "string",
"maxLength": 300
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Ucode (https://ucode.uk) provides temporary phone numbers that receive SMS verification codes for apps such as Telegram, WhatsApp, and Google. Use it only for the signed-in user's own account, and only for lawful verification. Link the account with the host Connect flow when it is offered. Otherwise call ucode_login_start, share the returned linkUrl, and call ucode_login_poll with that sessionId until linking finishes. Do not ask for passwords, access tokens, or API keys. In ChatGPT, call ucode_render_home on the first message so the account card can appear. After the account is linked, rent the same way as the mobile apps: ucode_sms_summary or ucode_render_services, then ucode_sms_service_detail if a country list is needed, then ucode_sms_rent_packages, then ucode_sms_rent_with_credits with rentalFlowVersion 2 and packageId, then ucode_sms_get_code. State prices as Ucode credits. Do not name upstream providers. If the balance is too low to rent, say so and stop. Do not start a card, store, or crypto payment in the chat. If no SMS arrives, ucode_sms_cancel_rental returns the credits. ucode_disconnect unlinks this chat only. For product questions, call ucode_instructions and summarize the matching section.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.