MCP MeasureMCP Measure

índice observado

Ucode SMS

Virtual SMS OTP numbers. USDC (Base/x402) or pay-per-OTP; refund if no SMS.

¿Debería usar esto?

Calidad y seguridad

C
Calidad de la descripción
94%
Integridad del esquema
56%
Calidad de los nombres
78%
Riesgo de envenenamiento
0%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (16)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool description contains URL to non-standard domainen ucode_panel_ping
  • MEDIUMTool description contains URL to non-standard domainen ucode_agent_billing
  • MEDIUMTool description contains URL to non-standard domainen ucode_instructions
  • MEDIUMTool description contains URL to non-standard domainen ucode_render_credits
  • MEDIUMTool description contains URL to non-standard domainen ucode_payments_stripe_create_checkout
  • MEDIUMTool description contains URL to non-standard domainen ucode_payments_nowpayments_create
  • LOWTool 'ucode_credit_gift_breakdown' description lacks action verben ucode_credit_gift_breakdown
  • LOWTool 'ucode_credit_referral_redeem' description lacks action verben ucode_credit_referral_redeem
  • LOWTool 'ucode_payments_nowpayments_status' description lacks action verben ucode_payments_nowpayments_status

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~11,925Tokens (definiciones de herramientas)
~2.6 KBTamaño de respuesta típico
Impacto significativo en la atención (9.32% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "sms": {
      "url": "https://mcp.ucodesim.com/mcp"
    }
  }
}

Puntos de conexión remotos

https://mcp.ucodesim.com/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (42)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢ucode_render_home

**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.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_render_services(search, limit)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "search": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_welcome

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

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_session_status

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.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_panel_ping

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

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_agent_billing

No login. Lists prepaid USDC (Base) credit packs for autonomous agents/bots and how to pay with x402. ChatGPT humans should use **ucode_render_credits** and https://ucode.uk/app/credits instead.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_instructions

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.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_help(question)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "minLength": 4,
      "maxLength": 2000,
      "description": "User question about Ucode apps, credits, rentals, SMS codes, etc."
    }
  },
  "required": [
    "question"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_connect

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

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_login_start

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

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_login_poll(sessionId)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "minLength": 16,
      "description": "sessionId returned by ucode_login_start"
    }
  },
  "required": [
    "sessionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
⚪ucode_authenticate(accessToken)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "accessToken": {
      "type": "string",
      "minLength": 20,
      "description": "Developer only: mobile app Bearer token — never ask end users to paste this for normal login"
    }
  },
  "required": [
    "accessToken"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_whoami

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

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
⚪ucode_disconnect

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.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
⚪ucode_sign_out

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

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_credits_status

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

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_render_credits

Opens the **Add credits** card with the current wallet balance. ChatGPT cannot run Stripe in the iframe — the user taps through to **https://ucode.uk/app/credits**. After they pay, call **ucode_credits_status**. Agents/bots should call **ucode_agent_billing** and pay USDC on Base instead of this tool.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_credit_packages

Same packs as **ucode_render_credits** (data). For ChatGPT humans prefer **ucode_render_credits** and the website dashboard. Agents: x402 USDC on Base.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_credit_gift_breakdown

Free-credit badges / gift breakdown.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_credit_referral_stats

Referral code and earnings summary.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
⚪ucode_credit_referral_redeem(code)

Redeem a 6-character referral code for bonus credits.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "minLength": 6,
      "maxLength": 6
    }
  },
  "required": [
    "code"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_payments_stripe_prices(priceIds)

**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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "priceIds": {
      "type": "string",
      "description": "Comma-separated Stripe price_… or prod_… IDs"
    }
  },
  "required": [
    "priceIds"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟡ucode_payments_stripe_create_checkout(packageId, stripeProductId, returnUrl, cancelUrl)

**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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "packageId": {
      "type": "string",
      "description": "Exact packageId from ucode_credit_packages for the pack the user chose"
    },
    "stripeProductId": {
      "description": "Legacy override — omit; Panel maps Stripe from packageId.",
      "type": "string"
    },
    "returnUrl": {
      "description": "Success URL; default deep link if omitted",
      "type": "string"
    },
    "cancelUrl": {
      "type": "string"
    }
  },
  "required": [
    "packageId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
⚪ucode_payments_stripe_verify(sessionId, packageId)

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string"
    },
    "packageId": {
      "type": "string"
    }
  },
  "required": [
    "sessionId",
    "packageId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟡ucode_payments_nowpayments_create(packageId, returnUrl, cancelUrl, platform)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "packageId": {
      "type": "string"
    },
    "returnUrl": {
      "type": "string"
    },
    "cancelUrl": {
      "type": "string"
    },
    "platform": {
      "type": "string",
      "enum": [
        "web",
        "ios",
        "android",
        "telegram"
      ]
    }
  },
  "required": [
    "packageId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_payments_nowpayments_status(paymentId)

Poll invoice / payment status by NOWPayments id.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "paymentId": {
      "type": "string"
    }
  },
  "required": [
    "paymentId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
⚪ucode_credits_verify_app_store_purchase(packageId, transactionId, productId, platform, purchaseToken)

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "packageId": {
      "type": "string"
    },
    "transactionId": {
      "type": "string"
    },
    "productId": {
      "type": "string"
    },
    "platform": {
      "type": "string",
      "enum": [
        "iOS",
        "Android"
      ]
    },
    "purchaseToken": {
      "type": "string"
    }
  },
  "required": [
    "packageId",
    "transactionId",
    "productId",
    "platform"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_services_catalog(page, limit, search, sortBy, sortOrder)

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "page": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "search": {
      "type": "string"
    },
    "sortBy": {
      "type": "string"
    },
    "sortOrder": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_sms_services

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.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_sms_countries

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.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_sms_prices(service, country, minutes)

**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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string"
    },
    "country": {
      "type": "number"
    },
    "minutes": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_sms_summary(page, limit, search, v, sortBy, ...)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "page": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "search": {
      "type": "string"
    },
    "v": {
      "anyOf": [
        {
          "type": "number",
          "const": 1
        },
        {
          "type": "number",
          "const": 2
        }
      ]
    },
    "sortBy": {
      "type": "string"
    },
    "sortOrder": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_sms_service_detail(serviceCode)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "serviceCode": {
      "type": "string",
      "minLength": 1,
      "description": "Short code, e.g. tg, wa, fb — same as mobile app service id"
    }
  },
  "required": [
    "serviceCode"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_sms_rent_packages(service, country)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string"
    },
    "country": {
      "type": "number"
    }
  },
  "required": [
    "service",
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
⚪ucode_sms_rent_with_credits(service, country, clientCredits, rentalFlowVersion, packageId)

**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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string"
    },
    "country": {
      "type": "number"
    },
    "clientCredits": {
      "type": "number"
    },
    "rentalFlowVersion": {
      "description": "Use **2** (default flow); matches mobile package picker.",
      "anyOf": [
        {
          "type": "number",
          "const": 1
        },
        {
          "type": "number",
          "const": 2
        }
      ]
    },
    "packageId": {
      "type": "string"
    }
  },
  "required": [
    "service",
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
⚪ucode_sms_rent_provider_direct(service, country)

**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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "service": {
      "type": "string"
    },
    "country": {
      "type": "number"
    }
  },
  "required": [
    "service"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_sms_active_rentals

Active/received rentals with SMS snippets if already fetched.

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_sms_get_code(rentalId)

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "rentalId": {
      "type": "string"
    }
  },
  "required": [
    "rentalId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🔴ucode_sms_cancel_rental(rentalId, reason, reasonNote)

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "rentalId": {
      "type": "string"
    },
    "reason": {
      "type": "string",
      "enum": [
        "service_rejected",
        "number_has_account",
        "code_not_arrived",
        "other"
      ]
    },
    "reasonNote": {
      "type": "string",
      "maxLength": 280
    }
  },
  "required": [
    "rentalId",
    "reason"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
⚪ucode_sms_refund_expired

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

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_sms_transactions

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

Esquema de entrada

{
  "type": "object",
  "properties": {}
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢ucode_app_init_snapshot(platform)

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

Esquema de entrada

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "enum": [
        "android",
        "ios",
        "web"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Esquema de salida

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "summary": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "type": "string"
    },
    "httpStatus": {
      "type": "number"
    },
    "uiView": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "phoneNumber": {
      "type": "string"
    },
    "rentalId": {
      "type": "string"
    },
    "providerRentalId": {
      "type": "string"
    },
    "remainingSeconds": {
      "type": "number"
    },
    "endDate": {
      "type": "string"
    },
    "countryName": {
      "type": "string"
    },
    "serviceName": {
      "type": "string"
    },
    "code": {
      "type": "string"
    },
    "smsCode": {
      "type": "string"
    },
    "credits": {
      "type": "number"
    },
    "billingUrl": {
      "type": "string"
    },
    "neededCredits": {
      "type": "number"
    }
  },
  "required": [
    "ok",
    "summary"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada42 herramientas