pnpm install --frozen-lockfile
pnpm check

pnpm --filter @unlimitedtts/mcp build
node packages/mcp/dist/cli.js

{
  "mcpServers": {
    "unlimitedtts": {
      "command": "npx",
      "args": ["-y", "@unlimitedtts/mcp@0.1.0"],
      "env": {
        "UNLIMITEDTTS_MAX_USDC_PER_CALL": "0.10",
        "UNLIMITEDTTS_ROLLING_24H_USDC": "1.00",
        "UNLIMITEDTTS_OUTPUT_DIRECTORY": "/absolute/approved/output"
      }
    }
  }
}

pnpm --filter @unlimitedtts/openclaw build
openclaw plugins install -l ./packages/openclaw
openclaw plugins enable unlimitedtts
openclaw gateway restart
openclaw plugins inspect unlimitedtts --runtime --json
openclaw plugins doctor

# UnlimitedTTS para agentes

Texto a voz no custodial y basado en cotización previa para agentes de IA:

* `@unlimitedtts/core` valida los desafíos x402 en tiempo real, aplica la política de gasto, persiste los recibos sanitizados y escribe artefactos MP3 privados.
* `@unlimitedtts/mcp` expone las herramientas `tts_list_voices`, `tts_quote` y `tts_synthesize` (irreversible) a través de stdio.
* `@unlimitedtts/openclaw` agrupa el servidor MCP y la habilidad de agente `unlimitedtts`.
* `skills/unlimitedtts` admite flujos de trabajo HTTP guiados por MCP y flujos de trabajo HTTP directos orientados a la cartera.

La vía implementada del v1 es el modo de firma externa. Una herramienta de cartera independiente crea `PAYMENT-SIGNATURE` de la especificación x402 v2; este código nunca acepta una frase semilla ni una clave privada.

## Instalación y compilación

Se requieren Node.js 20 o superior y pnpm.

GXP1

Ejecuta el servidor local desde este checkout:

GXP2

Configuración MCP genérica después de publicar en npm:

GXP3

Desarrollo local de OpenClaw:

GXP4

## Flujo de pago

1. `tts_list_voices` obtiene `/docs` y `/tts/voices` y guarda el resultado en caché durante cinco minutos.
2. `tts_quote` envía el cuerpo exacto de síntesis a `/x402/tts` sin realizar el pago, valida el `PAYMENT-REQUIRED` recibido, aplica la política local, reserva un presupuesto "rolling" y devuelve un token HMAC de corta vigencia.
3. Una cartera firma únicamente el `selectedRequirement` de vuelto.
4. `tts_synthesize` verifica el token, el mismo hash del cuerpo, la entrada `accepted` completa de la especificación x402 v2, el beneficiario y el valor exactos en EVM, y a continuación envía un reintento pagado.
5. Una llamada de éxito requiere `audio/mpeg` y `PAYMENT-RESPONSE` a la vez. Hace efectivo el presupuesto, escribe un recibo sanitizado, guarda de forma atómica el MP3 con modo `0600` y devuelve metadatos estructurados, además del contenido de audio/recurso de MCP.

`PAYMENT_OUTCOME_UNKNOWN` deja en cuarentena permanente esa previsión en el registro local. El servidor nunca realiza ni autoriza automáticamente un segundo pago.

## Configuración

| Variable de entorno               | Valor por defecto                                                             |
| --------------------------------- | ----------------------------------------------------------------------------- |
| `UNLIMITEDTTS_ENVIRONMENT`        | `production`; define `staging` explícitamente para la API de staging y Sepolia (Base Sepolia) |
| `UNLIMITEDTTS_API_ORIGIN`         | `https://api.unlimitedtts.com`                                               |
| `UNLIMITEDTTS_ALLOWED_NETWORKS`   | `eip155:8453`                                                                 |
| `UNLIMITEDTTS_ALLOWED_ASSETS`     | Contrato de la USDC en Base                                                  |
| `UNLIMITEDTTS_ALLOWED_PAYEES`     | Beneficiario fijado en el contrato de la versión verificada del 30 de julio de 2026 |
| `UNLIMITEDTTS_MAX_USDC_PER_CALL`  | `0.10`                                                                         |
| `UNLIMITEDTTS_ROLLING_24H_USDC`   | `1.00`                                                                         |
| `UNLIMITEDTTS_APPROVAL_THRESHOLD_USDC` | `0.05`                                                                      |
| `UNLIMITEDTTS_REQUIRE_APPROVAL`   | `first-payment-and-over-threshold`                                           |
| `UNLIMITEDTTS_OUTPUT_DIRECTORY`   | `.unlimitedtts-artifacts` dentro del directorio de trabajo del servidor      |
| `UNLIMITEDTTS_QUOTE_TOKEN_SECRET` | Aleatorio por proceso; configura un secreto para despliegues de varias instancias |

La rotación del beneficiario debe publicarse mediante una configuración de confianza. El servidor nunca obtiene un beneficiario permitido de un desafío en el que no se puede confiar.

Producción sigue siendo el valor por defecto y está anclado a la red mainnet de Base. Para validar staging, asigna `UNLIMITEDTTS_ENVIRONMENT=staging`; esto selecciona `https://staging.staging.unlimitedtts.com`, Base Sepolia (`eip155:84532`) y la USDC de staging. El sistema núcle usa el origen, la red o el activo de staging y lo rechaza si el entorno no es explícitamente `staging`.

## Vida titular

Este repositorio incluye el MCP local portátil, el contrato para el adaptador de cartera, la habilidad agente, el paquete OpenClaw, las pruebas y los metadatos de registro. El servicio alojado "Streamable HTTP", el almacenamiento temporal de R2, la síntesis con tarjeta prepago y un auto-firmador gestionado específico no se anuncian deliberadamente como funciones de la v1.

Consulta [cambios previos y requeridos arriba](docs/upstream-api-changes.md) antes de habilitar la firma automática sin supervisión o un servicio alojado.